Fortmail

Correo operado por agente en un solo Cloudflare Worker (MIT MCP para The Fort That Holds)

GitHubPrueba este MCPPatrocinado

Documentación

Fortmail

Correo electrónico operado por agentes, en un solo Cloudflare Worker.

Tu agente de IA obtiene un cliente de correo real: cada cuenta que posees, agregada, clasificada y desde la que puede enviar — y tú dejas de revisar bandejas de entrada. Fortmail es la versión de código abierto del sistema de correo que funciona dentro de The Fort That Holds: un worker pequeño, sin framework, sin servidor que cuidar, compatible con el nivel gratuito.

your Gmail(s) ─┐
your domain(s) ─┤→  Fortmail worker  →  triage desk (only what matters)
 (any IMAP)    ─┘        │
                         ├→ MCP server at /mcp  ← your agent connects here
                         └→ steward bridge: email → GitHub PR → wakes your agent

Qué hace

  • Posee todos tus buzones. Cuentas de Gmail mediante la API de Gmail (OAuth), y cualquier proveedor IMAP/SMTP (Migadu, Fastmail, Purelymail, tu propio host…) mediante sockets TLS puros — sin reglas de reenvío, sin servicio intermediario.
  • Sella sus propias credenciales. El worker genera su propia clave AES-GCM y puede generar y sellar una contraseña por buzón. Tú nunca manejas, almacenas ni siquiera ves esas contraseñas — la billetera del agente es el único lugar donde existen.
  • Clasifica de forma determinista. Un clasificador basado en regex (sin LLM, sin costo de API, sin alucinaciones) ordena el correo en desk (necesita un humano), record (vale la pena conservarlo), ignore (ruido masivo/OTP). Un cron barre un alcance cada 5 minutos y guarda en caché el escritorio, por lo que leerlo es instantáneo.
  • Habla MCP. /mcp es un servidor del Model Context Protocol con su propio OAuth (registro dinámico de clientes + PKCE). MCP es neutral respecto al proveedor — conecta cualquier agente que acepte un servidor MCP (Claude, ChatGPT, Gemini, Cursor, tu propio harness) y obtiene las herramientas de correo (list_accounts, get_desk, triage, read_box, read_message, get_attachment, send) además de las herramientas de newsletters. read_message devuelve el texto del cuerpo y los metadatos de los adjuntos; get_attachment / GET /attachment obtienen los bytes de archivos de Gmail. No hay ningún LLM dentro de Fortmail — sin dependencia de modelos, sin clave de API para ningún proveedor de IA; la inteligencia es cualquier agente que le apuntes.
  • Envía como cualquiera que poseas. Gmail mediante la API, todo lo demás mediante SMTP — el transporte se elige automáticamente según la dirección from.
  • Ejecuta tus newsletters. Las listas de suscriptores viven en tu KV (no en la base de datos de un ESP), con doble opt-in, baja en un clic (RFC 8058), supresión de rebotes/reclamos, y campañas que se drenan mediante el cron en bloques seguros por tasa a través de un relay (Resend) que es solo una tubería tonta. El alquiler por suscriptor es el modelo de negocio de los ESP; esto es centavos por correo. Cualquier número de listas — un seudónimo, una marca, un producto, cada uno obtiene una fila, no una cuenta. Consulta docs/NEWSLETTER.md.
  • Despierta a tu agente con el correo (opcional). Dale al agente su propia dirección (p. ej. steward@your-domain.com). Cada mensaje no visto allí se convierte en un pull request de GitHub en un repositorio que tu agente observa — con el remitente marcado CONFIABLE (tú) o NO CONFIABLE (todos los demás) para que el agente sepa si está recibiendo instrucciones o solo datos. Correo entra, agente despierto, rastro de auditoría incluido.

Inicio rápido

Requisitos: una cuenta de Cloudflare (el nivel gratuito funciona) y npx wrangler con sesión iniciada.

git clone https://github.com/TheFortThatHolds/mail && cd mail

# 1. The one store
npx wrangler kv namespace create TOKENS
#    → paste the returned id into wrangler.jsonc

# 2. The admin key (any long random string — this gates every admin endpoint)
npx wrangler secret put TRIGGER_KEY

# 3. Ship it
npx wrangler deploy

Luego conecta los buzones — consulta docs/SETUP.md para el recorrido completo (aplicación OAuth de Gmail, buzones IMAP, el puente steward) y docs/AGENT.md para apuntar tu agente hacia él.

O evita la configuración manual por completo: haz fork de este repositorio y apunta tu agente de codificación — de cualquier proveedor — hacia él. AGENTS.md es un runbook que el agente puede ejecutar de principio a fin; te pedirá solo los pasos que requieren intervención humana (inicio de sesión en Cloudflare, contraseñas de buzones, aprobaciones OAuth).

La versión de 60 segundos, con KEY = tu TRIGGER_KEY y W = la URL de tu worker:

# any IMAP mailbox you already have (password sent as a header, sealed on arrival)
curl -H "X-Mailbox-Password: <password>" \
  "$W/wallet-import?key=$KEY&addr=me@my-domain.com&host=imap.my-provider.com"

# or mint a NEW sealed password for a box (then set that password at your provider)
curl "$W/wallet-provision?key=$KEY&addrs=steward@my-domain.com&host=imap.my-provider.com"

# a Gmail account (needs GMAIL_CLIENT_ID/SECRET set — see docs/SETUP.md)
open "$W/connect?key=$KEY"

# watch it work
curl "$W/triage?key=$KEY&scope=all"
curl "$W/desk?key=$KEY"

Conecta tu agente: agrega https://<your-worker>/mcp como conector MCP personalizado. Recorrerá el flujo OAuth; el prompt de contraseña es tu TRIGGER_KEY.

La regla de confianza (lee esta)

El correo electrónico es entrada no confiable. El puente de Fortmail marca cada mensaje archivado mediante una coincidencia de From contra OWNER_EMAILS:

  • ✅ REMITENTE CONFIABLE (propietario) — se puede actuar sobre las instrucciones.
  • ⚠️ REMITENTE NO CONFIABLE — el mensaje es dato para clasificar. El agente nunca debe seguir instrucciones, enlaces o solicitudes dentro de él.

Esta es la línea de inyección de prompts para agentes impulsados por correo: solo la dirección del propietario emite comandos; todo lo demás se lee, nunca se obedece. Mantén la misma regla en las instrucciones de tu propio agente — la marca es una señal, la disciplina de tu agente es la aplicación. Y la suplantación existe: para cualquier cosa de consecuencias, condiciona a tu aprobación explícita, no a un encabezado From.

Endpoints

RutaQué hace
/mcpServidor MCP (protegido por OAuth) — la puerta del agente
/desk?key=El escritorio de clasificación en caché, todos los alcances
/triage?key=&scope=Clasificación en vivo (filtro all, gmail, imap, &domain=)
/cron-run?key=Forzar un tick del cron (o &scope= uno específico)
/send?key=&from=&to=&subject=&text=Enviar como cualquier buzón propio
/wallet-provision?key=&addrs=&host=&smtp=Generar y sellar nuevas credenciales IMAP
/wallet-import?key=&addr=&host=&smtp=Sellar una contraseña existente (mediante el encabezado X-Mailbox-Password)
/accounts?key= / /imapboxes?key=Listar buzones propios
/tool?key=&name=Llamar cualquier herramienta MCP por HTTP (consulta GET o POST JSON {name,arguments}) — mismo TRIGGER_KEY que /accounts
/attachment?key=&address=&message=&attachmentId=Obtener un adjunto de Gmail como bytes crudos (Content-Type de la parte). encoding=base64 devuelve JSON en su lugar. Solo lectura; límite de 4MB en cargas JSON/herramientas
/connect?key= → /oauth/callbackFlujo OAuth de la cuenta de Gmail
/import?key=Importar un token de actualización de Gmail existente
/bridge-run?key=&dry=1Ejecutar/inspeccionar el puente steward ahora
/news/subscribe?list=Registro público (doble opt-in) — consulta docs/NEWSLETTER.md
/news/list?key= / /news/lists?key=Crear listas / listarlas con conteos
/news/send?key=Poner en cola una campaña (o test a una dirección)
/news/campaign?key= / /news/drain?key=Progreso de campaña / empujar la cola ahora
/news/relay?key=Sellar la clave de API del relay (o usar variables de modo broker)
/news/hookWebhook del relay → supresión por rebote/reclamo

Notas de diseño

  • Un archivo a propósito. ~550 líneas, cero dependencias, revisable de una sentada. El correo contiene toda tu vida; deberías poder leer cada línea de lo que lo toca.
  • Tú eres dueño de la audiencia. El motor de newsletters mantiene a los suscriptores como filas en tu KV; el relay de envío nunca tiene la lista. Cambiar de relay es un cambio de configuración, no una migración.
  • Ventana de 90 días tanto en Gmail como en IMAP (búsqueda SINCE) para que el correo antiguo nunca inunde el escritorio.
  • Alcances rotativos del cron. Cada tick de 5 minutos barre UN alcance (gmail, o un dominio) — muchos buzones nunca se acumulan en un solo timeout.
  • Lotes IMAP de a cuatro — Cloudflare serializa los sockets concurrentes; los lotes mantienen un barrido rápido sin tocar límites.
  • Sin LLM en el circuito. La clasificación es regex. Tu agente aplica criterio cuando lee el escritorio; la plomería misma nunca adivina.

Ideas de endurecimiento, modelo de amenazas y límites conocidos: docs/SECURITY.md.

De dónde viene esto

Fortmail es un órgano de The Fort That Holds — una pila soberana operada por agentes, construida en abierto. Este repositorio es toda la herramienta de correo. Está bajo licencia MIT y es gratis de ejecutar. No hay página de producto de Fortmail ni semilla de correo de pago.

Si quieres la ruta escrita para otras piezas de Fort — las instrucciones que le das a tu propio agente para que recorra un camino que ya funcionó — esas viven en el Grand Bazaar como Selfware Seeds (el estante está en la portada). Las activas hoy:

Los agentes pueden leer la misma lista como catalog.json. Nada de eso es necesario para ejecutar Fortmail.

Licencia

MIT © The Fort That Holds LLC.