mcp-server

MCP（Model Context Protocol）サーバーは、MinuteMail公開APIをツールとして公開します。AIエージェントとMCPクライアントは、mm-api-gatewayを通じてMinuteMailのメールボックス、メール、添付ファイル、ドメイン、チーム、モックOAuthアイデンティティを操作できます。

• エンドポイント: https://mcp.minutemail.co/mcp（Streamable HTTP、プロトコルリビジョン 2025-06-18）

• 認証: MCPクライアントのAuthorization: Bearer mmak_...ヘッダーは、api-gatewayにそのまま転送されます。このサーバーは認証情報を一切保持しません。スコープとクォータは、通常のAPIクライアントと同様にすべてゲートウェイが適用します。

• ステートレス: セッションもサーバープッシュSSEもありません（GET /mcpとDELETE /mcpは405を返します）。ヘルスチェック: GET /health。

##Tool surface (39 tools)

すべてのツールは、api-gatewayの/v1ルートと1:1で対応しています。すべての呼び出しにはBearer APIキーが必要です。書き込み操作には、対応するスコープ（mailboxes、domains、team、identities）が必要です。

Mailboxes（mailboxes スコープ）

Archived mailboxes（mailboxes スコープ）

mm_list_archived_mailboxes, mm_get_archived_mailbox, mm_delete_archived_mailbox, mm_reactivate_archived_mailbox.

Domains（domains スコープ）

mm_list_domains, mm_register_domain, mm_verify_domain, mm_delete_domain.

Team（team スコープ）

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

Mock identities（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.

Not exposed

• /v1/api-keys CRUD — APIキー管理はMCPを介して公開されません。キーはWebアプリから管理してください。

• /internal/* — 内部専用。/metricsはスクレイピング用にPrometheusメトリクス（runtime go_*/process_*カウンター）を提供します。METRICS.mdを参照してください。

Example

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

ツールの結果は、ゲートウェイのJSONレスポンスを保持するMCPテキストコンテンツとして返されます。2xx以外のゲートウェイレスポンスは、isError: trueの結果となり、HTTPステータスとボディが含まれます（401無効なキー、403スコープ/ドメイン、429残数表示付きクォータ、502上流停止）。

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

Configuration

Development

Go 1.23。標準ライブラリに加えて、/metrics用にprometheus/client_golangを使用します。MinuteMailサービス標準に従います（mm-mailbox-serviceを参照）。

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