DearAgent: el servidor MCP que da a los agentes de IA un buzón autoalojado

DearAgent es una API de correo para agentes de IA autoalojada en Cloudflare Workers, que almacena los correos en D1 y los adjuntos en R2. Se presenta como una alternativa de código abierto a AgentMail y expone un servidor MCP sin estado con Streamable HTTP a través del endpoint /mcp del Worker.

Para quién es

• Para desarrolladores que quieren que sus agentes de IA tengan capacidad real de recepción de correo: el flujo típico es crear un buzón, esperar el correo de verificación y leer el enlace de verificación.
• Requisitos claros: se necesita una cuenta de Cloudflare, un dominio de primer nivel dedicado para Cloudflare Email Routing, Node 20+ y ejecutar npx wrangler login. Recibir correos es gratuito; solo enviarlos requiere Workers Paid.
• La API y el MCP usan la misma API_KEY como único token bearer: una sola clave tiene todos los permisos (monoinquilino), por lo que no es adecuada para escenarios multiusuario que requieran aislamiento de permisos de grano fino.
• No es adecuado si no tienes tu propio dominio, si no puedes asumir la responsabilidad de un despliegue y mantenimiento autoalojados, o si necesitas aislamiento de permisos multiinquilino. Lo que la evidencia oficial no especifica (como la retención de datos o las políticas de borrado) es desconocido; verifícalo por tu cuenta.

Primer intento en 3 minutos

La única vía principal recomendada oficialmente es clonar el repositorio y ejecutar el script de instalación interactivo, que configura automáticamente D1, R2, los secretos, Email Routing/Sending, completa el despliegue y crea la regla catch-all:

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

Requisitos previos: haber iniciado sesión en Cloudflare con npx wrangler login y que el dominio ya esté disponible para Email Routing. El script guiará la configuración de la API_KEY obligatoria (también se puede definir con npx wrangler secret put API_KEY); esa clave es el único token bearer de la API y del MCP.

Para la primera llamada se recomienda usar la herramienta de solo lectura de bajo riesgo list_inboxes: configura en tu cliente MCP el endpoint /mcp del Worker con la clave bearer y llama a list_inboxes. Si devuelve la lista de buzones, el despliegue y la autenticación funcionan. Ten en cuenta que este es un servicio autoalojado, no una escritura en un tercero remoto gestionado; create_inbox escribe en tu propia base de datos D1.

Si solo quieres recibir correos, no necesitas Workers Paid; solo cuando vayas a llamar a send_message para enviar correos confirma que tienes Workers Paid, porque el envío genera correos salientes reales (no pueden revertirse desde la capa MCP; evalúalo según el comportamiento real de Email Sending).

Casos de uso

Caso 1: verificación de registro automatizada por el agente. Llama a create_inbox para crear un buzón, introduce esa dirección en el formulario de registro del sitio web de destino y usa wait_for_message para esperar el correo de verificación; después lee el enlace de verificación del contenido del correo. Este es el flujo típico descrito oficialmente; las herramientas devuelven el contenido real de los correos en tu propio servicio.

Caso 2: recuperación de correos históricos. Llama a search_messages para buscar por palabras clave, o usa list_threads / get_thread para ver conversaciones, get_message para leer un correo concreto y get_attachment para obtener adjuntos. Todas son operaciones de consulta sobre los datos ya existentes en tu D1/R2, útiles para revisar correos que el agente recibió anteriormente.

Las demás herramientas (como send_message, reply_to_message, forward_message, list_webhooks, create_webhook) figuran como disponibles en la evidencia, pero sus detalles de parámetros no se especifican; antes de usarlas, consulta el README del repositorio.

Límites de uso

• Naturaleza de lectura/escritura: list_*, get_*, search_messages y wait_for_message son de consulta; create_inbox, create_webhook, send_message, reply_to_message y forward_message escriben datos o generan acciones salientes reales; confírmalo antes de llamarlas.
• Credenciales y datos: una única API_KEY da acceso total, guárdala con cuidado; todos los datos de correo residen en tu propio D1/R2 de Cloudflare.
• Efectos secundarios: enviar correos requiere Workers Paid y el envío es real; la documentación oficial no indica ningún mecanismo de retiro posterior al envío, así que no debe considerarse una operación reversible.
• Puntos desconocidos: la evidencia oficial no especifica el período de retención de los correos, herramientas de borrado ni detalles de privacidad; esta información no está confirmada y no constituye una conclusión sin riesgos.