mcp-server

MCP (Model Context Protocol) сервер, предоставляющий публичный API MinuteMail в виде инструментов. Он позволяет AI-агентам и MCP-клиентам управлять почтовыми ящиками MinuteMail, письмами, вложениями, доменами, командами и имитированными OAuth-идентичностями через mm-api-gateway.

• Endpoint: https://mcp.minutemail.co/mcp (Streamable HTTP, ревизия протокола 2025-06-18)

• Аутентификация: заголовок Authorization: Bearer mmak_... от MCP-клиента передаётся на api-gateway без изменений — этот сервер не хранит учётные данные. Области действия и квоты применяются шлюзом точно так же, как и для любого API-клиента.

• Без состояния: нет сессий и server-push SSE (GET /mcp и DELETE /mcp возвращают 405). Проверка состояния: GET /health.

набор инструментов (39 инструментов)

Каждый инструмент сопоставляется 1:1 с маршрутом /v1 api-gateway. Все вызовы требуют Bearer API-ключ; операции записи требуют соответствующей области действия (mailboxes, domains, team, identities).

Почтовые ящики (область mailboxes)

Архивные почтовые ящики (область mailboxes)

mm_list_archived_mailboxes, mm_get_archived_mailbox, mm_delete_archived_mailbox, mm_reactivate_archived_mailbox.

Домены (область domains)

mm_list_domains, mm_register_domain, mm_verify_domain, mm_delete_domain.

Команда (область team)

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

Имитированные идентичности (область 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.

Не предоставляется

• /v1/api-keys CRUD — управление API-ключная не предоставляется через MCP; управляйте ключами через веб-приложение.

• /internal/* — только для внутреннего использования. /metrics отдаёт метрики Prometheus (runtime-счётчики go_*/process_*) для сбора; см. METRICS.md.

Related MCP server: SandMail — Disposable Email API for AI Agents

Пример

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}}}'

Результаты инструментов возвращаются как текстовое содержимое MCP, содержащее JSON-ответ шлюза. Ответы шлюза с кодом не-2xx становятся результатами isError: true с HTTP-статусом и телом ответа (401 неверный ключ, 403 scope/domain, 429 квота с оставшимся количеством, 502 недоступен upstream).

Конфигурация

Разработка

Go 1.23. Стандартная библиотека плюс prometheus/client_golang для /metrics. Следует стандартам сервисов MinuteMail (см. mm-mailbox-service).

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