MailMask

Official registry Search and web

Email for agents: domains, aliases, IMAP mailboxes, DNS, sending and webhooks via one API key.

What can you do with MailMask?

  • Máscaras con forwarding — direcciones como hola@tudominio.com que reenvían a uno o varios destinatarios
  • Envío autenticado — salida desde tu dominio con DKIM y SPF configurados automáticamente en SES
  • Bandeja compartida — asigna conversaciones a miembros del equipo y responde desde el dashboard, con actualización en tiempo real vía SSE
  • API REST + SDK — cliente JS/TS publicado como @easybits.cloud/mailmask
  • SMTP relay — credenciales SMTP para enviar desde tu código o SaaS (plan Developer)
  • Reglas de enrutamiento — reenvío condicional por alias
  • RBAC por dominio — roles owner, admin y agent con permisos granulares
  • Respaldos verificados — snapshot completo del SQLite con VACUUM INTO, verificado con integrity_check antes de subir a S3

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code
claude mcp add --transport http mailmask 'https://www.mailmask.studio/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "mailmask": {
            "type": "http",
            "url": "https://www.mailmask.studio/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. MailMask
  2. Qué es
  3. Features
  4. Planes
  5. Stack
  6. Setup
  7. Deploy
  8. Endpoints de salud
  9. Documentación y agente
  10. Estructura

MailMask

Email profesional con tu dominio. Máscaras, forwarding y bandeja compartida — sin Google Workspace.

mailmask.studio

Qué es

MailMask te permite recibir y gestionar emails con tu dominio propio. Configura máscaras (aliases) que reenvían a tu Gmail, Outlook o cualquier buzón existente, sin montar un servidor de correo y sin pagar licencia por buzón. Ideal para freelancers, startups y equipos pequeños.

Features

  • Máscaras con forwarding — direcciones como hola@tudominio.com que reenvían a uno o varios destinatarios
  • Envío autenticado — salida desde tu dominio con DKIM y SPF configurados automáticamente en SES
  • Bandeja compartida — asigna conversaciones a miembros del equipo y responde desde el dashboard, con actualización en tiempo real vía SSE
  • API REST + SDK — cliente JS/TS publicado como @easybits.cloud/mailmask
  • SMTP relay — credenciales SMTP para enviar desde tu código o SaaS (plan Developer)
  • Reglas de enrutamiento — reenvío condicional por alias
  • RBAC por dominio — roles owner, admin y agent con permisos granulares
  • Respaldos verificados — snapshot completo del SQLite con VACUUM INTO, verificado con integrity_check antes de subir a S3
  • Blog integrado — 24 guías SEO sobre email profesional y forwarding
  • Docs con agente — chat de soporte en /docs que responde por RAG sobre la documentación

Planes

Precios en MXN. Máscaras, reglas, envíos y reenvío se cuentan por dominio, no por cuenta.

BásicoFreelancerDeveloper
Mensual$49$449$999
Anual$490$4,490$9,990
Dominios11520
Máscaras550100
Reglas—1050
Historial15 días30 días90 días
Envíos/día— (add-on)2001,000
Reenvío de entrada100/hora500/hora2,000/hora
API + SDK✓✓✓
SMTP relay——✓
Webhooks——✓

Son dos límites distintos. Envíos es el correo saliente que originas tú (panel, API, SMTP relay). Reenvío de entrada es el correo que llega a una máscara y sale al buzón destino — el caso de uso principal, medido por hora y un orden de magnitud mayor: ~2,400, ~12,000 y ~48,000 al día. Quien solo reenvía nunca toca el límite de envíos.

Add-ons

Se compran encima de cualquier plan activo y se cobran aparte, mes a mes.

Add-onPrecioQué hace
Envíos 25/día+$49Desbloquea el envío desde tu dominio, tope 25/día por dominio
Envíos 100/día+$99Igual, tope 100/día por dominio
Dominio extra+$99 c/uUn dominio más de cupo. Acumulable. No incluye envío

Los dos de envíos son mutuamente excluyentes; se compran una vez y aplican a todos los dominios de la cuenta, con el tope contando por dominio y por día.

Fuente de verdad: PLANS y ADDONS en db.ts.

Stack

Node + tsx · Elysia · SQLite (Drizzle) · AWS SES/S3 · MercadoPago · Fly.io

Setup

cp .env.example .env
npm install
npm run dev    # localhost:8000
npm test

Requiere los buckets de S3 mailmask-inbound y mailmask-backups en us-east-1. Todo AWS está fijado a esa región: SES inbound solo existe en us-east-1, us-west-2 y eu-west-1, y ahí viven las receipt rules y los dominios verificados.

Deploy

fly deploy     # ~22s, ~11s de downtime

El downtime es estructural: con SQLite en un volumen único solo una máquina puede montarlo, así que Fly debe detener la vieja antes de arrancar la nueva.

Endpoints de salud

RutaUso
/healthzLiveness para fly-proxy. Sin I/O.
/healthDiagnóstico: profundidad de cola, dead letters y estado de SES. Devuelve 503 si algo está degradado — no usar como readiness del proxy.

Documentación y agente

La página pública /docs tiene doble propósito: es la documentación para usuarios y la fuente de la base de conocimiento del Asistente MailMask, el chat que responde dudas ahí mismo.

El agente vive en Formmy y responde por RAG sobre 18 documentos que se le suben; no lee el sitio en vivo. Las fuentes son dos:

  1. 13 secciones extraídas de public/docs.html — instalación, autenticación, dominios, aliases, reglas, envío, logs, SMTP, API keys, errores, MCP y referencia de la API.
  2. EXTRA_DOCS en scripts/upload-docs.ts — lo que no está en la página: planes y precios, configuración de dominio, bandeja, envío masivo y RBAC.

No se actualiza solo. Después de editar docs.html o EXTRA_DOCS:

FORMMY_SECRET_KEY=sk_live_xxx npx tsx scripts/upload-docs.ts   # borra y re-sube, idempotente
npm run build:chat                                             # solo si tocaste docs-chat.tsx

El baseUrl del SDK debe ser https://www.formmy.app. El apex formmy.app no sirve certificado TLS, así que apuntar ahí hace que todo fetch muera en el handshake con un Failed to fetch que parece CSP y no lo es. El host va en tres archivos (docs-chat.tsx, upload-docs.ts, setup-agent.ts) y en el connect-src del CSP en main.ts; el bundle lleva el valor incrustado, por eso hay que reconstruirlo.

Estructura

ArchivoPropósito
main.tsTodos los endpoints, estáticos y middleware
db.tsCapa de datos, definición de planes, CRUD
schema.tsSchema de Drizzle (22 tablas)
auth.tsJWT, hashing PBKDF2, tokens CSRF
ses.tsSES, S3, IAM, helpers de respaldo
forwarding.tsProcesamiento y reenvío de correo entrante
backup.tsRespaldo completo de la base con verificación
cron.tsTareas programadas
public/docs.htmlDocs públicas y fuente del agente
public/js/docs-chat.tsxWidget del Asistente MailMask
scripts/upload-docs.tsSube la base de conocimiento del agente
scripts/setup-agent.tsPersona e instrucciones del agente

Hecho con 🚬🫁 por @blissito · fixter.org

Frequently asked questions

What is MailMask?

Email for agents: domains, aliases, IMAP mailboxes, DNS, sending and webhooks via one API key.

How do I install MailMask?

It runs as a remote server. In Claude Code: claude mcp add --transport http mailmask 'https://www.mailmask.studio/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does MailMask need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is MailMask open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains MailMask?

It is published by blissito. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.