BotEmail MCP Server

Dale a tu agente de IA su propia dirección de correo electrónico: bandejas de entrada instantáneas para bots a través de API, sin necesidad de configuración humana.

Documentación

Servidor MCP de BotEmail.ai

Servidor del Model Context Protocol (MCP) para BotEmail.ai - Infraestructura de correo electrónico para agentes autónomos.

¿Qué es esto?

Este servidor MCP permite a Claude Desktop (y otros clientes MCP) crear y gestionar cuentas de correo electrónico de bots en BotEmail.ai directamente a través de la interfaz de IA.

Características

  • Crear cuentas de correo de bots - Obtén una nueva dirección yourbot_bot@botemail.ai al instante
  • Obtener correos electrónicos - Recupera todos los correos de una cuenta de bot
  • Leer correos específicos - Obtén detalles completos de cualquier mensaje
  • Registrar webhooks - Configura notificaciones push para correos entrantes

Instalación

Requisitos previos

  • Node.js 18+ instalado
  • Claude Desktop u otro cliente MCP

Configuración

  1. Clona este repositorio:
git clone https://github.com/claw-silhouette/botemail-mcp-server.git
cd botemail-mcp-server
  1. Instala las dependencias:
npm install
  1. Configura Claude Desktop:

Edita tu archivo de configuración de Claude Desktop:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Añade esto a la sección mcpServers:

{
  "mcpServers": {
    "botemail": {
      "command": "node",
      "args": ["/absolute/path/to/botemail-mcp-server/index.js"]
    }
  }
}
  1. Reinicia Claude Desktop

Uso

Una vez configurado, puedes pedirle a Claude que:

  • "Crea una nueva cuenta de correo de bot para mi automatización"
  • "Comprueba si tengo correos en mybot@botemail.ai"
  • "Muéstrame el último correo en la bandeja de entrada de mi bot"
  • "Configura un webhook para correos entrantes"

¡Consulta EXAMPLES.md para ejemplos de uso detallados!

Herramientas disponibles

create_bot_email

Crea una nueva cuenta de correo de bot.

Parámetros:

  • username (cadena, opcional) - Nombre de usuario para el bot (se convertirá en username_bot@botemail.ai). Si se omite, genera un nombre de usuario aleatorio como 9423924_bot@botemail.ai

Devuelve:

  • email - La dirección de correo electrónico completa creada
  • apiKey - Clave de autenticación para esta cuenta

get_emails

Obtén todos los correos de una cuenta de bot.

Parámetros:

  • email (cadena, obligatorio) - Dirección de correo electrónico completa (p. ej., mybot_bot@botemail.ai)
  • apiKey (cadena, obligatorio) - Clave API para autenticación

Devuelve:

  • emails - Matriz de objetos de correo con id, from, to, subject, timestamp, bodyText

get_email_by_id

Obtén un correo específico por ID.

Parámetros:

  • email (cadena, obligatorio) - Dirección de correo del bot
  • apiKey (cadena, obligatorio) - Clave API
  • emailId (cadena, obligatorio) - ID del correo a recuperar

Devuelve:

  • Objeto de correo completo con todos los encabezados y contenido del cuerpo

register_webhook

Registra una URL de webhook para notificaciones push.

Parámetros:

  • email (cadena, obligatorio) - Dirección de correo del bot
  • apiKey (cadena, obligatorio) - Clave API
  • webhookUrl (cadena, obligatorio) - La URL de tu endpoint de webhook

Devuelve:

  • Confirmación del registro del webhook

Endpoint de API

Todas las herramientas se conectan a: https://api.botemail.ai

Ejemplo

// Claude can do this for you:
const result = await use_mcp_tool("botemail", "create_bot_email", {
  username: "myautomation"
});

console.log(result.email);  // myautomation_bot@botemail.ai
console.log(result.apiKey); // Your API key for this account

Arquitectura

Este servidor MCP es una capa delgada sobre la API REST de BotEmail.ai. Traduce las llamadas de herramientas MCP en solicitudes HTTP y devuelve respuestas formateadas.

Enlaces

Habilidad de OpenClaw / ClawBot

Para usuarios de OpenClaw/ClawBot, instala la habilidad botemail directamente:

clawhub install bot-email

O explórala en: https://clawhub.ai/skills/bot-email

Esto añade la habilidad al HEARTBEAT.md de tu agente para el monitoreo automático de la bandeja de entrada.

Licencia

MIT

Soporte