BotEmail MCP Server

Dê ao seu agente de IA seu próprio endereço de e-mail — caixas de entrada instantâneas para bots via API, sem necessidade de configuração humana.

GitHub
1
Experimente este MCPPatrocinado

Documentação

BotEmail.ai MCP Server

Servidor Model Context Protocol (MCP) para BotEmail.ai - Infraestrutura de e-mail para agentes autônomos.

O que é isso?

Este servidor MCP permite que o Claude Desktop (e outros clientes MCP) criem e gerenciem contas de e-mail de bot no BotEmail.ai diretamente através da interface de IA.

Recursos

  • Criar contas de e-mail de bot - Obtenha um novo endereço yourbot_bot@botemail.ai instantaneamente
  • Buscar e-mails - Recupere todos os e-mails de uma conta de bot
  • Ler e-mails específicos - Obtenha detalhes completos de qualquer mensagem
  • Registrar webhooks - Configure notificações push para e-mails recebidos

Instalação

Pré-requisitos

  • Node.js 18+ instalado
  • Claude Desktop ou outro cliente MCP

Configuração

  1. Clone este repositório:
git clone https://github.com/claw-silhouette/botemail-mcp-server.git
cd botemail-mcp-server
  1. Instale as dependências:
npm install
  1. Configure o Claude Desktop:

Edite o arquivo de configuração do Claude Desktop:

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

Adicione isso à seção mcpServers:

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

Uso

Uma vez configurado, você pode pedir ao Claude para:

  • "Crie uma nova conta de e-mail de bot para minha automação"
  • "Verifique se tenho e-mails em mybot@botemail.ai"
  • "Mostre-me o e-mail mais recente na caixa de entrada do meu bot"
  • "Configure um webhook para e-mails recebidos"

Veja EXAMPLES.md para exemplos detalhados de uso!

Ferramentas Disponíveis

create_bot_email

Crie uma nova conta de e-mail de bot.

Parâmetros:

  • username (string, opcional) - Nome de usuário para o bot (se tornará username_bot@botemail.ai). Se omitido, gera um nome de usuário aleatório como 9423924_bot@botemail.ai

Retorna:

  • email - O endereço de e-mail completo criado
  • apiKey - Chave de autenticação para esta conta

get_emails

Obtenha todos os e-mails de uma conta de bot.

Parâmetros:

  • email (string, obrigatório) - Endereço de e-mail completo (ex.: mybot_bot@botemail.ai)
  • apiKey (string, obrigatório) - Chave de API para autenticação

Retorna:

  • emails - Matriz de objetos de e-mail com id, from, to, subject, timestamp, bodyText

get_email_by_id

Obtenha um e-mail específico por ID.

Parâmetros:

  • email (string, obrigatório) - Endereço de e-mail do bot
  • apiKey (string, obrigatório) - Chave de API
  • emailId (string, obrigatório) - ID do e-mail a recuperar

Retorna:

  • Objeto de e-mail completo com todos os cabeçalhos e conteúdo do corpo

register_webhook

Registre uma URL de webhook para notificações push.

Parâmetros:

  • email (string, obrigatório) - Endereço de e-mail do bot
  • apiKey (string, obrigatório) - Chave de API
  • webhookUrl (string, obrigatório) - URL do seu endpoint de webhook

Retorna:

  • Confirmação do registro do webhook

Endpoint da API

Todas as ferramentas se conectam a: https://api.botemail.ai

Exemplo

// 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

Arquitetura

Este servidor MCP é um wrapper fino em torno da API REST do BotEmail.ai. Ele traduz chamadas de ferramentas MCP em requisições HTTP e retorna respostas formatadas.

Links

Habilidade OpenClaw / ClawBot

Para usuários de OpenClaw/ClawBot, instale a habilidade botemail diretamente:

clawhub install bot-email

Ou navegue até: https://clawhub.ai/skills/bot-email

Isso adiciona a habilidade ao HEARTBEAT.md do seu agente para monitoramento automático da caixa de entrada.

Licença

MIT

Suporte