Skip to main content
Glama
MinuteMail MCP

MinuteMail MCP

Official
by minutemailco

mcp-server

Servidor MCP (Model Context Protocol) que expone la API pública de MinuteMail como herramientas. Permite que los agentes de IA y los clientes MCP operen con los buzones, correos, adjuntos, dominios, equipos e identidades OAuth simuladas de MinuteMail a través de mm-api-gateway.

  • Endpoint: https://mcp.minutemail.co/mcp (Streamable HTTP, revisión de protocolo 2025-06-18)

  • Autenticación: la cabecera Authorization: Bearer mmak_... del cliente MCP se reenvía textualmente a api-gateway — este servidor no guarda credenciales. Los ámbitos y las cuotas se aplican en el gateway exactamente igual que para cualquier cliente de API.

  • Sin estado: no hay sesiones ni SSE emitidas por el servidor (GET /mcp y DELETE /mcp devuelven 405). Health: GET /health.

Superficie de herramientas (39 herramientas)

Cada herramienta se corresponde 1:1 con una ruta /v1 de api-gateway. Todas las llamadas requieren la clave de API Bearer; las operaciones de escritura requieren el ámbito correspondiente (mailboxes, domains, team, identities).

Buzones (ámbito mailboxes)

Herramienta

Ruta de api-gateway

mm_list_mailboxes

GET /v1/mailboxes

mm_create_mailbox

POST /v1/mailboxes (propietario forzado al propietario de la clave, dominio por defecto del tenant)

mm_get_mailbox / mm_delete_mailbox

GET / DELETE /v1/mailboxes/{id}

mm_bulk_delete_mailboxes

DELETE /v1/mailboxes

mm_list_mails / mm_inject_test_mail

GET / POST /v1/mailboxes/{id}/mails (multipart)

mm_get_mail / mm_delete_mail / mm_bulk_delete_mails

…/mails/{mailId}

mm_list_attachments / mm_add_attachment / mm_get_attachment / mm_delete_attachment / mm_bulk_delete_attachments

…/attachments

Buzones archivados (ámbito mailboxes)

mm_list_archived_mailboxes, mm_get_archived_mailbox, mm_delete_archived_mailbox, mm_reactivate_archived_mailbox.

Dominios (ámbito domains)

mm_list_domains, mm_register_domain, mm_verify_domain, mm_delete_domain.

Equipo (ámbito team)

mm_list_members, mm_add_member, mm_get_member, mm_delete_member, mm_create_invitation, mm_list_invitations, mm_delete_invitation.

Identidades simuladas (ámbito identities)

mm_list_identities, mm_create_identity, mm_get_identity, mm_delete_identity, mm_list_oauth_clients, mm_create_oauth_client, mm_get_oauth_client, mm_delete_oauth_client, mm_rotate_client_secret.

No expuesto

  • /v1/api-keys CRUD — la gestión de claves de API no está expuesta a través de MCP; en su lugar, gestiona las claves desde la aplicación web.

  • /internal/* — solo para uso interno. /metrics sirve métricas de Prometheus (contadores de runtime go_*/process_*) para el scraping; consulta METRICS.md.

Related MCP server: AgenticMail

Ejemplo

curl -s https://mcp.minutemail.co/mcp \
  -H 'Authorization: Bearer mmak_XXXXXXXX' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"mm_create_mailbox","arguments":{"expiresIn":30}}}'

Los resultados de las herramientas se devuelven como contenido de texto de MCP con la respuesta JSON del gateway. Las respuestas que no sean 2xx se convierten en resultados isError: true con el código de estado HTTP y el cuerpo (401 clave no válida, 403 ámbito/dominio, 429 cuota agotada con recuento restante, 502 upstream caído).

Configuración

Variable de entorno

Valor por defecto

Propósito

PORT

8080

Puerto de escucha

API_BASE

http://mm-api-gateway:80

URL base de api-gateway (en clúster)

LOG_LEVEL

warn

debug/info/warn/error

LOG_FORMAT

json

json/text

PROFILE

dev

Etiqueta del perfil de despliegue

Desarrollo

Go 1.23. Stdlib más prometheus/client_golang para /metrics. Sigue los estándares de servicio de MinuteMail (consulta mm-mailbox-service).

go test ./...     # unit tests
go vet ./...
go run .          # local server on :8080

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Programmatic email deliverability testing for AI agents. Create inbox placement tests across Gmail, Outlook, Yahoo, Mail.ru, Yandex — get per-provider placement (Inbox/Spam/Promotions), SPF/DKIM/DMARC auth, Rspamd & SpamAssassin verdicts, DNS health (MX, PTR, DNSBL), and live SSE results.
      5
      50 npm
      2
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Real email and SMS for AI agents. Run a local mail server with disposable inboxes — agents send and receive real email, fetch verification codes, and drive a real inbox without going through any third-party email API.
      101
      255
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Deploys a self-hosted Cloudflare email service providing short-lived mailboxes with a JSON API and MCP endpoint for automated testing and AI agent signup, verification, and magic-link flows.
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI coding agents to create disposable test inboxes, wait for and read incoming email, and extract confirmation links and one-time codes for sign-up, password-reset, and magic-link flows.
      6
      12 npm
      MIT