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)

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: SandMail — Disposable Email API for AI Agents

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

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