MCP

DearAgent: servidor MCP que dá aos agentes de IA caixas de correio auto-hospedadas

Quando você quer que um agente de IA receba automaticamente e-mails de verificação ou gerencie caixas de correio dedicadas, o DearAgent é a escolha certa, mas exige conta Cloudflare, um domínio de nível superior dedicado e disposição para auto-hospedar; receber é gratuito e enviar requer o Workers Paid.

Official source · panda-sandeep/dearagent

Install

git clone https://github.com/panda-sandeep/dearagent && cd dearagent
npm install
npm run setup

DearAgent é uma API de caixas de correio para agentes de IA auto-hospedada no Cloudflare Workers, com e-mails armazenados no D1 e anexos no R2. Posiciona-se como uma alternativa open-source ao AgentMail e expõe um servidor MCP sem estado com Streamable HTTP através do endpoint /mcp no Worker.

Para quem é indicado

  • Indicado para desenvolvedores que querem dar aos seus agentes de IA capacidade real de recebimento de e-mails: o fluxo típico é criar uma caixa de entrada, aguardar o e-mail de verificação e ler o link de verificação.
  • Pré-requisitos claros: é necessária uma conta Cloudflare, um domínio de nível superior dedicado para o Cloudflare Email Routing, Node 20+ e executar npx wrangler login. Receber e-mails é gratuito; só o envio de e-mails exige o Workers Paid.
  • A API e o MCP usam a mesma API_KEY como único token bearer: uma única chave tem todas as permissões (single-tenant), não sendo adequada para cenários multiusuário que exijam isolamento granular de permissões.
  • Situações em que não é indicado: não ter seu próprio domínio, não aceitar a responsabilidade de implantação e manutenção do self-hosting, ou precisar de isolamento de permissões multi-tenant. Aspectos não abordados pela evidência oficial (como retenção de dados e políticas de exclusão) são desconhecidos — verifique por conta própria.

Primeira tentativa em 3 minutos

O único caminho principal recomendado oficialmente é clonar o repositório e executar o script de instalação interativo, que configura automaticamente D1, R2, segredos, Email Routing/Sending, conclui a implantação e cria uma regra catch-all:

git clone https://github.com/panda-sandeep/dearagent && cd dearagent
npm install
npm run setup

Pré-requisitos: já ter feito login no Cloudflare com npx wrangler login e o domínio já estar habilitado para o Email Routing. O script orienta a configuração da API_KEY obrigatória (que também pode ser definida com npx wrangler secret put API_KEY); essa chave é o único token bearer da API e do MCP.

Para a primeira chamada, recomenda-se usar a ferramenta de leitura de baixo risco list_inboxes: no cliente MCP, configure o endpoint /mcp do Worker com a chave bearer e chame list_inboxes. Se ela retornar a lista de caixas de entrada, a implantação e a autenticação estão funcionando. Note que este é um serviço auto-hospedado e não uma gravação em serviço remoto de terceiros; create_inbox grava no seu próprio banco de dados D1.

Se você só quiser receber e-mails, não precisa do Workers Paid; apenas ao preparar a chamada de send_message para enviar e-mails confirme que o Workers Paid está ativado, pois o envio gera e-mails reais para fora (que não podem ser revertidos na camada MCP; avalie de acordo com o comportamento real do Email Sending).

Casos de uso

Caso 1: deixar o agente concluir automaticamente a verificação de registro. Chame create_inbox para criar uma caixa de entrada, insira esse endereço no formulário de registro do site de destino e depois use wait_for_message para aguardar a chegada do e-mail de verificação, lendo o link de verificação no conteúdo do e-mail. Este é o fluxo típico descrito oficialmente; as ferramentas retornam o conteúdo real dos e-mails no seu serviço auto-hospedado.

Caso 2: recuperar e-mails históricos. Chame search_messages para buscar por palavras-chave, ou use list_threads / get_thread para ver as conversas, get_message para ler um e-mail específico e get_attachment para obter anexos. Todas são operações de consulta sobre dados já existentes no seu D1/R2, úteis para auditar e-mails que o agente recebeu anteriormente.

As demais ferramentas (como send_message, reply_to_message, forward_message, list_webhooks, create_webhook) são listadas na evidência como ferramentas disponíveis, mas os detalhes de seus parâmetros não foram fornecidos; antes de usá-las, consulte o README do repositório.

Limites de uso

  • Natureza de leitura/escrita: list_*, get_*, search_messages e wait_for_message são operações de consulta; create_inbox, create_webhook, send_message, reply_to_message e forward_message gravam dados ou geram ações reais de envio — confirme antes de chamá-las.
  • Credenciais e dados: uma única API_KEY concede acesso completo; guarde-a com cuidado. Todos os dados de e-mail ficam no seu próprio Cloudflare D1/R2.
  • Efeitos colaterais: enviar e-mails exige o Workers Paid e ocorre de forma real; oficialmente não há mecanismo declarado de retirada após o envio, então não deve ser tratado como uma operação reversível.
  • Itens desconhecidos: a evidência oficial não menciona o prazo de retenção dos e-mails, ferramentas de exclusão ou detalhes de tratamento de privacidade; essas informações permanecem sem confirmação e não constituem uma conclusão de ausência de riscos.