SendHQ MCPサーバー

このサーバーについて

SendHQ MCPサーバーを使うと、AIエージェントがModel Context Protocolを通じて1つのSendHQワークスペースを操作できます。メールの送信（単一送信、一括送信、テンプレート送信、返信、添付ファイル、冪等な再試行）、送信済みメールと受信メール（件名、本文、添付ファイル名）とその配信イベントの読み取りと検索、自動振り分けルール付きのラベルによるメールの整理、下書きと非公開の添付ファイルの管理、ホスト型テンプレートの作成と公開、ドメインとそのDNSの追加と検証、メール受信と受信用アドレスの設定、到達率・バウンス・苦情・サプレッションの確認、アカウントの使用量・請求状態・分析・APIキーのメタデータの読み取りが可能です。

これはsendhq CLIバイナリに組み込まれたローカルのstdioサーバーです。MCPクライアントがsendhq mcpを子プロセスとして起動し、stdin/stdout上でJSON-RPCを使って通信します。各ツール呼び出しは、ワークスペースのAPIキーで認証されたhttps://sendhq.cc/api/v1のSendHQ REST APIへのドキュメント化されたリクエスト1件になります。そのため、MCPサーバーの権限はそのキーの権限とまったく同じで、それを超えることはありません。

• 8つのグループに分かれた59個のツールは、1つのカタログから生成されています。このカタログはtools.jsonとしても公開されています。
• 厳密なJSONスキーマ：不明な引数、誤った型、必須フィールドの欠落は、SendHQに届く前にローカルで拒否されます。
• 構造化されたエラー：安定したcode、HTTPのstatus、explanation（説明）、具体的なremedy（対処法）、再試行が有効かどうかを含みます。
• 実際にメールを送信するツールやデータを破棄するツールは、説明文の冒頭でその旨を示し、MCPの安全性アノテーションを持っています。
• --read-onlyモードでは、送信や変更を行うツールがすべて非表示になります。
• 何もログに記録されません。stdoutにはプロトコルメッセージのみが流れ、APIキーやメッセージの内容がログに残ることはありません。

ClaudeとChatGPTでSendHQを使う

インストールは不要です。SendHQはこのサーバーを、同じツールを備えたホスト型コネクタとしてhttps://mcp.sendhq.cc/mcpでも提供しています。キーを貼り付ける代わりに、SendHQアカウントでログインします。

Claude

1. Settings → Connectorsを開いてディレクトリからSendHQを探すか、Add custom connectorを選んでhttps://mcp.sendhq.cc/mcpを貼り付けます。
2. ConnectをクリックしてSendHQにログインし、アクセス内容を確認してAllowをクリックします。
3. 受信トレイの確認、検証済みドメインからのメール送信、バウンスの説明などをClaudeに依頼できます。

ChatGPT

1. Open Settings → Security and login and turn on Developer mode.
2. Go to chatgpt.com/plugins, click Create MCP app, name it SendHQ and enter https://mcp.sendhq.cc/mcp.
3. Sign in to SendHQ and click Allow, then pick SendHQ from the tools menu in a new chat.

Muse by Meta

In Muse, open Connectors and search for SendHQ. Click Connect, sign in to SendHQ and click Allow.

承認と接続解除

• The request_feature tool sends a feature request to the SendHQ team with your account details, so we can follow up by email.
• 実際にメールを送信するツールやデータを削除するツールには、その旨のラベルが付いています。アシスタントが事前に確認を求めるかどうかは、アシスタント側でツールごとに設定します。Claudeでは、Settings → Connectors → SendHQでそれらのツールにNeeds approvalを選択してください。
• コネクタには、アシスタントの名前が付いた専用のAPIキー（例：「Claude (AI connector)」）が発行されます。APIキーでこれを削除すると、即座に接続が解除されます。
• APIキーの作成や失効、請求の変更はできません。添付ファイルはbase64で送受信され、ローカルファイルへのアクセスはありません。
• 未払いのワークスペース（連携トライアル）は、アカウントのメールアドレスまたはAWS SESシミュレーターのアドレスにのみ配信できます。

お問い合わせ：postmaster@sendhq.cc。プライバシー：sendhq.cc/privacy。

インストール

sendhqバイナリをインストールします（Linux、macOS、Windows、x86-64およびarm64に対応）。インストーラーはリリースのチェックサムを検証し、デフォルトではバイナリを~/.local/binに配置します。

curl -fsSL https://downloads.sendhq.cc/install.sh | sh

irm https://downloads.sendhq.cc/install.ps1 | iex

sendhq version
SENDHQ_API_KEY=re_your_key sendhq doctor

ダッシュボードのhttps://sendhq.cc/app#/keysでAPIキーを作成します。MCPサーバーはキーを作成できません。サーバーを起動するコマンドは次の1つだけです。

SENDHQ_API_KEY=re_your_key sendhq mcp

通常、これを手動で実行することはありません。MCPクライアントが起動します。ターミナルで実行すると、stdinでJSON-RPCを待ち受けます。

クライアントを設定する

Claude Code

claude mcp add sendhq --env SENDHQ_API_KEY=re_your_key -- sendhq mcp

# read-only variant
claude mcp add sendhq-readonly --env SENDHQ_API_KEY=re_your_key -- sendhq mcp --read-only

--scope userを追加するとすべてのプロジェクトで使えるようになり、--scope projectを追加するとプロジェクトの.mcp.jsonに書き込まれます。共有する.mcp.jsonでは、キーをコミットせずに環境変数から参照してください。Claude Codeは.mcp.json内の${VAR}を展開します。

{
  "mcpServers": {
    "sendhq": {
      "command": "sendhq",
      "args": [
        "mcp"
      ],
      "env": {
        "SENDHQ_API_KEY": "${SENDHQ_API_KEY}"
      }
    }
  }
}

OpenAI Codex

[mcp_servers.sendhq]
command = "sendhq"
args = ["mcp"]
env = { SENDHQ_API_KEY = "re_your_key" }

コマンドラインからも設定できます：codex mcp add sendhq --env SENDHQ_API_KEY=re_your_key -- sendhq mcp。

Claude Desktop

claude_desktop_config.json（macOS：~/Library/Application Support/Claude/、Windows：%APPDATA%\Claude\）を編集し、アプリを再起動します。デスクトップアプリはシェルのPATHを引き継がないため、バイナリの絶対パス（which sendhq）を使ってください。

{
  "mcpServers": {
    "sendhq": {
      "command": "/Users/you/.local/bin/sendhq",
      "args": [
        "mcp"
      ],
      "env": {
        "SENDHQ_API_KEY": "re_your_key"
      }
    }
  }
}

その他のMCPクライアント

コマンドsendhq、引数["mcp"]（必要に応じて"--read-only"）、および以下の環境変数を指定してstdioサーバーを設定します。サーバーはMCPプロトコルバージョン2024-11-05、2025-03-26、2025-06-18、2025-11-25に対応し、initialize、ping、tools/list、tools/callを実装しています。ツールの結果には、JSONテキストブロックとstructuredContentの両方が含まれます。

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"1"}}}
{"jsonrpc":"2.0","method":"notifications/initialized"}
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_service_health","arguments":{}}}

アカウント単位のサーバーには、ホスト型のHTTPトランスポートはありません。書き込み可能なリモートMCPエンドポイントにはユーザーごとのOAuthが必要ですが、SendHQはこれを提供していません。ローカルのバイナリなら、キーをすでに保持しているマシン上に留めておけます。

環境変数とフラグ

キーは、設定されたベースURLにAuthorization: Bearerヘッダーとしてのみ送信されます。出力、ログへの記録、エラーでの表示、ツールの結果への含有は一切ありません。

エージェント向けの安全モデル

• 実際にメールを送信します。send_email、send_batch、send_template_testは実在する人にメールを配信し、配信クレジットを消費します。これらの説明文はSENDS REAL EMAILで始まります。ユーザーがその特定のメッセージの送信を明示的に依頼し、受信者、送信者、内容が確認済みの場合にのみ呼び出してください。
• 破壊的操作。delete_email、delete_draft、delete_attachment、delete_domain、delete_inbox、remove_suppressionにはdestructiveHint: trueが付いており、説明文はDESTRUCTIVEで始まります。事前にユーザーに確認してください。remove_suppressionは安全のためのブロックを弱めるもので、アドレスが再び使えることを人間が確認した場合にのみ適切です。
• 状態を変更します。下書き、テンプレート、ドメイン、インボックスの作成や更新、テンプレートの公開、検証の開始はワークスペースを変更しますが、メールは送信しません。
• 読み取り専用。それ以外はすべてreadOnlyHint: trueで、自由に呼び出しても安全です。
• このサーバーがDNSを変更することはありません。add_domainは人間が公開するためのレコードを返します。get_domain_connect_linkは、ユーザー本人が開いてDNSプロバイダー上で承認する必要がある同意URLを返します。
• このサーバーが請求を変更することはありません。get_accountはプラン、使用量、サブスクリプションの状態を読み取るだけです。
• 未払いのワークスペース（連携トライアル）は、アカウント所有者のメールアドレス（get_account → user.email）またはsuccess@simulator.amazonses.comなどのAWS SESシミュレーターのアドレスにのみ配信でき、添付ファイルは送信できません。
• 受け付けは配信ではありません。送信が成功するとIDが返されます。配信、バウンス、苦情の証拠は後からlist_email_eventsに届きます。受信トレイへの到達や、相手がメッセージを読んだことを主張してはいけません。
• 423の一時停止を回避するために別のFromアドレスに切り替えないでください。また、配信停止した受信者や苦情を報告した受信者を再び追加してはいけません。

APIキーは対象外

設計上、APIキーを作成、変更、ローテーション、失効、削除するツールはありません。エージェントが認証情報を発行したり破棄したりしてはいけません。list_api_keysが返すのは、名前、秘密でないプレフィックス、最終使用日時のみです。キーの管理は、ログインした人間がダッシュボードで行います。

ワークフロー

1. 最初の送信

1. get_service_healthでAPIに到達できることを確認します（キーなしで動作します）。
2. get_accountで、プラン（access.tier）、残りのクォータ、user.emailを確認します。トライアル中は、このメールアドレスが唯一許可された実在の受信者です。
3. list_sending_identitiesで使用できるFromアドレスを一覧表示します。空の場合は、先にドメインのワークフローを実行してください。
4. 送信者、受信者、件名、本文をユーザーに確認してから、idempotency_keyを付けてsend_emailを呼び出します。
5. 返されたidを指定してlist_email_eventsを呼び出すと、プロバイダーが報告した時点で（通常は数秒から数分）delivery、bounce、complaint、rejectが表示されます。

{
  "name": "send_email",
  "arguments": {
    "from": "Acme <hello@example.com>",
    "to": [
      "owner@example.com"
    ],
    "subject": "SendHQ is connected",
    "text": "It works.",
    "idempotency_key": "first-send-2026-09-26"
  }
}

2. ドメイン検証の一連の流れ

1. name: "example.com"を指定してadd_domainを呼び出します。結果にはDNSレコード（DKIMのCNAME、SES検証、SPF、推奨されるDMARC）が含まれます。
2. domain_idを指定してget_dns_providerを呼び出すと、権威DNSプロバイダーが検出され、そのプロバイダーで各レコードに入力すべき正確な相対ホストが返されます。
3. providers.domainConnect.availableがtrueの場合、get_domain_connect_linkが同意URLを返します。これを人間に渡してください。プロバイダー上で承認されるまで何も変更されません。それ以外の場合は、公開すべきレコードを人間に伝えてください。SPFレコードを2つ公開してはいけません。既存のv=spf1の値にinclude:amazonses.comを統合してください。
4. verify_domainはDNSとSESを再チェックします。ステータスはpending、checking、propagatingを経てverifiedになります。verify_domainまたはget_domainを30〜60秒ごとにポーリングしてください。DNSの反映には数分から数時間かかることがあります。
5. statusがverifiedになると、そのドメインのアドレスがlist_sending_identitiesに表示されます。

3. バウンス、苦情、サプレッション

1. list_blocked_recipientsは、ブロックされたすべてのアドレスをその理由（bounce、complaint、unsubscribe）と件数のサマリーとともに返します。
2. list_suppressionsはハードバウンスと苦情によるサプレッションを返します。deliverability_statsは過去30日間の配信率、バウンス率、苦情率を返します。list_sender_reputationは、どのFromアドレスがスロットリングまたは一時停止されているかを示します。
3. サプレッション対象の受信者を含む送信は422 recipient_suppressedで失敗します。その受信者を除外して再送してください。
4. バウンスしたメールボックスが現在は使えることを人間が確認した場合にのみ、remove_suppressionを呼び出してください。苦情によるサプレッションは恒久的です（409 complaint_suppression_locked）。

4. メールを受信する

1. ドメイン（多くの場合inbound.example.comのようなサブドメイン）が検証済みである必要があります。
2. setup_inboundは受信を準備し、MXレコードを1つ返します。これを人間が公開します。
3. statusがreadyになるまでverify_inboundを呼び出します。
4. domain_idとlocal_part（例：support）を指定してcreate_inboxを呼び出すと、support@inbound.example.comが作成されます。
5. direction: "in"とunread: true（必要に応じてinbox_idも）を指定してlist_emailsをポーリングします。メッセージはget_emailで、その会話はget_threadで、添付ファイルはdownload_attachmentで読み取り、mark_email（read: true）で処理済みにします。
6. send_emailとreply_to_email_idでスレッド内に返信します。SendHQがIn-Reply-To、References、スレッドを設定します。

5. Webhookとイベント通知

SendHQは現在、顧客が設定できるWebhookを提供していないため、Webhook用のツールはありません。プロバイダーからの通知はSendHQ内部で処理され、読み取り操作を通じて公開されます。代わりにポーリングしてください。1通のメッセージの結果にはlist_email_events、最近の変化にはstatus（例：bounced）またはafterを指定したlist_emails、新着の受信メールにはdirection: "in"とunread: trueを指定したlist_emails、新しいサプレッションにはlist_blocked_recipientsを使います。ポーリングは、1つの問い合わせにつき1分に1回程度までにしてください。

6. 配信失敗を診断する

1. メッセージを探します。direction: "out"とtoまたはqueryを指定してlist_emailsを呼び出すか、IDがわかっている場合はget_emailを使います。status: failedは、SendHQまたはプロバイダーが送信時に拒否したことを意味します。メールのエラーにその理由が記載されています。
2. list_email_events：bounce（恒久的または一時的、プロバイダーの診断情報付き）、complaint、reject、delivery。イベントがまだない場合は、プロバイダーがまだ報告していないということです。しばらく待ってから再確認してください。
3. 送信呼び出し自体が失敗した場合は、エラーのcodeを確認します。sender_domain_unverified → ドメイン検証を完了する。recipient_suppressed → そのアドレスは以前にハードバウンスしたか苦情を報告している。sender_paused → list_sender_reputationを確認し、リストの入手元を修正する。trial_recipient_restricted → トライアルの制限。quota_exhausted → get_accountで使用量を確認する。
4. get_domainでDKIM、SPF、DMARCが引き続き公開されていることを確認します。deliverability_statsで、問題が1通のメッセージだけか、傾向なのかがわかります。
5. 証拠が示す内容を報告してください。deliveryイベントは受信者側のサーバーがメッセージを受け付けたことを意味し、受信トレイに届いたことや読まれたことを意味するわけではありません。

7. タスク用バケットを管理する（ラベル）

1. name（例：Agent/Orders）とskip_inbox: trueを指定してcreate_labelを呼び出します。これでラベルがバケットになります。このラベルが付いた受信メールはアーカイブされ、人間の受信トレイには表示されずラベル内にのみ表示されます。
2. send_email（またはsend_batch）とlabels: ["Agent/Orders"]でタスク用のメールを送信します。その会話への返信は自動的にラベルを引き継ぎ、受信トレイをスキップします。
3. 自分の会話以外から始まるメールには、振り分けルールを追加します。inbox_id（orders@…のような専用アドレス）、from、to、subjectのいずれかを指定してcreate_label_ruleを呼び出します。受信済みのメールも振り分けるにはapply_to_existing: trueを渡します。
4. バケットを処理します。label: "Agent/Orders"、direction: "in"、unread: trueを指定してlist_emailsを呼び出し、get_emailまたはget_threadで読み、send_emailとreply_to_email_idで返信し、処理したらmark_emailでread: trueにします。
5. 紛れ込んだメッセージの出し入れにはlabel_email（add / remove）を使います。受信メッセージにバケットのラベルを追加すると、そのメッセージはアーカイブもされます。
6. 必要に応じてset_inbox_forwardingを使うと、受信アドレスに届いたすべてのメールのコピーを別のメールボックスに送信できます（転送先は先にメールで確認を行います）。

{
  "name": "send_email",
  "arguments": {
    "from": "Orders <orders@example.com>",
    "to": [
      "customer@example.net"
    ],
    "subject": "Order 1042: confirm delivery window",
    "text": "Reply with a time that works.",
    "labels": [
      "Agent/Orders"
    ],
    "idempotency_key": "order-1042-window"
  }
}

8. 添付ファイルとテンプレート

有料プランでは、send_emailのattachmentsで最大10個のファイルを添付できます（それぞれcontent_base64またはローカルのfile_pathが必要です。filenameのデフォルトはファイルのベース名です）。ホスト型テンプレートの場合：create_template → update_template_draft → render_templateでサンプルデータを使ってプレビュー → send_template_test（実際のテストを1通送信） → publish_templateの順に進め、その後template: {key, data}とちょうど1人のto受信者を指定してsend_emailまたはsend_batchで送信します。

結果、ページネーション、エラー

呼び出しが成功すると、APIのJSONオブジェクトがstructuredContentとJSONテキストブロックとして返されます。すべてのlist_*ツールはlimit（1〜200、デフォルト50）とoffsetを受け付け、paginationオブジェクトを付加します。has_moreがtrueの間は、offset: pagination.next_offsetを指定して呼び出しを続けてください。

{
  "data": [
    "…"
  ],
  "count": 50,
  "pagination": {
    "offset": 0,
    "limit": 50,
    "returned": 50,
    "total": 180,
    "has_more": true,
    "next_offset": 50
  }
}

呼び出しが失敗すると、構造化されたエラーとともにisError: trueが返されます。むやみに再試行せず、remedyに従ってください。再試行するのはretryableがtrueの場合だけにしてください。

{
  "error": {
    "code": "trial_recipient_restricted",
    "status": 402,
    "message": "The integration trial can deliver only to your account email or an AWS SES simulator address",
    "retryable": false,
    "explanation": "This workspace is on the unpaid integration trial. Trial sends can be delivered only to the account owner's email address or an AWS SES simulator address.",
    "remedy": "Send to the account email (get_account -> user.email) or a simulator address such as success@simulator.amazonses.com to test. To email anyone else, the account owner must activate a paid plan in the dashboard (Profile & Billing). Do not retry the same recipients."
  }
}

任意のエラーフィールド：request_id（サポートへの問い合わせ時に伝えてください）、retry_after_seconds、problems（invalid_argumentsの場合のスキーマ違反のリスト）、idempotent_replayed（「冪等性」を参照）。

冪等性

send_emailとsend_batchはidempotency_key（最大200文字）を受け付け、Idempotency-Keyヘッダーとして送信します。論理的なメッセージごとに一定のキーを1つ生成してください（例：invoice-4812-receipt）。

• 再試行では、同じキーと同一のリクエストボディの両方を再利用する必要があります。同じキーで何かを変更すると（受信者、件名、本文、ヘッダー、テンプレートデータ、さらには引数の値でも）、409 idempotency_conflictが返されます。
• 同じキー、同じボディで、元のリクエストが完了している場合：SendHQは再送せずに保存済みの結果を返します。これが、タイムアウトやnetwork_errorの後に安全に再試行する方法です。
• 元のリクエストがまだ実行中に同じキーを使った場合：409 idempotency_in_progressが返されます。少し待ってから再試行できます。
• 新しい論理的なメッセージには新しいキーが必要です。
• 保存された失敗も再生されます。最初の試行が失敗した場合、同じキーで再試行すると、同じ失敗がidempotent_replayed: trueとretryable: false付きで返されます。list_emails（direction: out）で何も送信されていないことを確認し、原因を修正してから、新しいキーで送信してください。
• サーバーがPOSTを自動で再試行することはありません。自動的に再試行されるのは読み取り専用のGET呼び出しだけです（ネットワークエラー、429、5xxの場合に最大3回）。
• インラインのattachmentsを指定したsend_emailは複数のリクエストを実行するため、idempotency_keyを受け付けません。再試行しても安全な添付ファイル付きの送信には、create_draft → upload_attachment → draft_idとidempotency_keyを指定したsend_emailの順に使ってください。

{
  "name": "send_email",
  "arguments": {
    "from": "Acme <billing@example.com>",
    "to": [
      "owner@example.com"
    ],
    "subject": "Receipt #4812",
    "text": "Thanks for your payment.",
    "idempotency_key": "receipt-4812"
  }
}

レート制限とクォータ

SendHQは、APIについて1秒あたりのリクエスト数の固定上限を公表していません。エージェントが実際に直面する制限は使用量の上限で、429として返されます。

• プランごとの月間受信者配信数。To、Cc、Bccの各アドレスがそれぞれ1配信としてカウントされます。get_account → usage.recipientDeliveriesとusage.emailQuotaMonthを比較してください。
• Fromアドレスごとの1日あたりの受信者数。その送信者のレピュテーションの状態によって決まります（list_sender_reputation → dailyLimit、有料プランのデフォルトは2,000）。
• 連携トライアル：合計100受信者まで。アカウントのメールアドレスまたはSESシミュレーターのアドレスにのみ送信できます。
• 添付ファイル：1メッセージあたり最大10ファイル、10 MBまで。有料プランでは、受信者数で重み付けした添付ファイルの転送量が月10 GBまで。
• リクエストごと：To + Cc + Bccで最大100アドレス。send_batchは最大100メッセージ。
• レピュテーションのサーキットブレーカー：直近7日間のローリングウィンドウで、バウンスや苦情がしきい値を超えると、該当するFromアドレスがスロットリングまたは一時停止されます（423 sender_paused）。率が下がれば自動的に回復します。

quota_exhaustedは、期間がリセットされるかプランが変更されるまで再試行できません。rate_limitedはretry_after_secondsの経過後に再試行できます。送信の場合は、同じidempotency_keyと同一のボディで再試行してください。

エラー一覧

codeは安定しています。messageではなく、こちらで分岐してください。

ツールリファレンス

すべてのツールについて、安全性の分類、呼び出すRESTエンドポイント、パラメータ、戻り値の形式、tools/callのparamsオブジェクトの例を記載しています。パラメータは厳密で、記載されていないものはすべてサーバーに拒否されます。

メールとスレッド：send_email、send_batch、list_emails、get_email、mark_email、delete_email、list_email_events、get_thread
ラベルと自動振り分けルール：list_labels、get_label、create_label、update_label、delete_label、create_label_rule、delete_label_rule、label_email
下書き、添付ファイル、送信者ID：list_sending_identities、create_draft、list_drafts、get_draft、update_draft、delete_draft、upload_attachment、download_attachment、delete_attachment
ホスト型テンプレート：list_templates、create_template、get_template、update_template_draft、create_template_draft、render_template、send_template_test、publish_template、archive_template、restore_template
ドメインとDNS：list_domains、get_domain、add_domain、verify_domain、delete_domain、get_dns_provider、get_domain_connect_link
メール受信：setup_inbound、verify_inbound、list_inboxes、get_inbox、create_inbox、update_inbox、set_inbox_forwarding、delete_inbox
到達率、バウンス、サプレッション：deliverability_stats、list_sender_reputation、list_suppressions、remove_suppression、list_blocked_recipients
アカウント、使用量、分析、キー：get_account、get_analytics、list_api_keys、get_service_health

この条件に一致するツールはありません。

メールとスレッド

{
  "name": "send_email",
  "arguments": {
    "from": "Acme <hello@example.com>",
    "to": [
      "owner@example.com"
    ],
    "subject": "Your export is ready",
    "text": "Download it from your dashboard.",
    "idempotency_key": "export-ready-42"
  }
}

{
  "name": "send_batch",
  "arguments": {
    "emails": [
      {
        "from": "Acme <hello@example.com>",
        "to": [
          "owner@example.com"
        ],
        "template": {
          "key": "account-welcome",
          "data": {
            "first_name": "Asha"
          }
        }
      }
    ],
    "idempotency_key": "welcome-batch-2026-09-26"
  }
}

{
  "name": "list_emails",
  "arguments": {
    "direction": "in",
    "unread": true,
    "limit": 25
  }
}

{
  "name": "get_email",
  "arguments": {
    "email_id": "em_123"
  }
}

{
  "name": "mark_email",
  "arguments": {
    "email_id": "em_123",
    "read": true
  }
}

{
  "name": "delete_email",
  "arguments": {
    "email_id": "em_123"
  }
}

{
  "name": "list_email_events",
  "arguments": {
    "email_id": "em_123"
  }
}

{
  "name": "get_thread",
  "arguments": {
    "thread_id": "em_123"
  }
}

ラベルと自動振り分けルール

{
  "name": "list_labels",
  "arguments": {}
}

{
  "name": "get_label",
  "arguments": {
    "label_id": "Billing"
  }
}

{
  "name": "create_label",
  "arguments": {
    "name": "Agent/Orders",
    "skip_inbox": true,
    "rules": [
      {
        "from": "@stripe.com"
      }
    ]
  }
}

{
  "name": "update_label",
  "arguments": {
    "label_id": "lbl_123",
    "name": "Finance/Billing"
  }
}

{
  "name": "delete_label",
  "arguments": {
    "label_id": "lbl_123"
  }
}

{
  "name": "create_label_rule",
  "arguments": {
    "label_id": "Billing",
    "inbox_id": "inb_123",
    "skip_inbox": true
  }
}

{
  "name": "delete_label_rule",
  "arguments": {
    "label_id": "lbl_123",
    "rule_id": "lrule_123"
  }
}

{
  "name": "label_email",
  "arguments": {
    "email_id": "em_123",
    "add": [
      "Billing"
    ],
    "remove": [
      "Support"
    ]
  }
}

下書き、添付ファイル、送信者ID

{
  "name": "list_sending_identities",
  "arguments": {}
}

{
  "name": "create_draft",
  "arguments": {
    "from": "hello@example.com",
    "to": [
      "owner@example.com"
    ],
    "subject": "Invoice"
  }
}

{
  "name": "list_drafts",
  "arguments": {}
}

{
  "name": "get_draft",
  "arguments": {
    "draft_id": "dr_123"
  }
}

{
  "name": "update_draft",
  "arguments": {
    "draft_id": "dr_123",
    "from": "hello@example.com",
    "to": [
      "owner@example.com"
    ],
    "subject": "Invoice (updated)",
    "text": "Attached."
  }
}

{
  "name": "delete_draft",
  "arguments": {
    "draft_id": "dr_123"
  }
}

{
  "name": "upload_attachment",
  "arguments": {
    "draft_id": "dr_123",
    "filename": "invoice.pdf",
    "content_type": "application/pdf",
    "file_path": "/tmp/invoice.pdf"
  }
}

{
  "name": "download_attachment",
  "arguments": {
    "attachment_id": "att_123",
    "save_to_path": "/tmp/invoice.pdf"
  }
}

{
  "name": "delete_attachment",
  "arguments": {
    "attachment_id": "att_123"
  }
}

ホスト型テンプレート

{
  "name": "list_templates",
  "arguments": {
    "lifecycle": "active"
  }
}

{
  "name": "create_template",
  "arguments": {
    "name": "Account welcome",
    "key": "account-welcome",
    "starter": "welcome"
  }
}

{
  "name": "get_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "update_template_draft",
  "arguments": {
    "template_id": "account-welcome",
    "revision": 3,
    "name": "Account welcome",
    "subject_template": "Welcome, {{first_name}}",
    "text_template": "Hi {{first_name}}",
    "variables": [
      {
        "key": "first_name",
        "type": "text",
        "required": true
      }
    ],
    "sample_data": {
      "first_name": "Asha"
    }
  }
}

{
  "name": "create_template_draft",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "render_template",
  "arguments": {
    "template_id": "account-welcome",
    "data": {
      "first_name": "Asha"
    }
  }
}

{
  "name": "send_template_test",
  "arguments": {
    "template_id": "account-welcome",
    "to": [
      "owner@example.com"
    ]
  }
}

{
  "name": "publish_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "archive_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "restore_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

ドメインとDNS

{
  "name": "list_domains",
  "arguments": {}
}

{
  "name": "get_domain",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "add_domain",
  "arguments": {
    "name": "example.com"
  }
}

{
  "name": "verify_domain",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "delete_domain",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "get_dns_provider",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "get_domain_connect_link",
  "arguments": {
    "domain_id": "dom_123"
  }
}

メール受信

{
  "name": "setup_inbound",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "verify_inbound",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "list_inboxes",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "get_inbox",
  "arguments": {
    "inbox_id": "inb_123"
  }
}

{
  "name": "create_inbox",
  "arguments": {
    "domain_id": "dom_123",
    "local_part": "support",
    "name": "Support"
  }
}

{
  "name": "update_inbox",
  "arguments": {
    "inbox_id": "inb_123",
    "status": "disabled"
  }
}

{
  "name": "set_inbox_forwarding",
  "arguments": {
    "inbox_id": "inb_123",
    "forward_to": "team@example.net"
  }
}

{
  "name": "delete_inbox",
  "arguments": {
    "inbox_id": "inb_123"
  }
}

到達率、バウンス、サプレッション

{
  "name": "deliverability_stats",
  "arguments": {}
}

{
  "name": "list_sender_reputation",
  "arguments": {}
}

{
  "name": "list_suppressions",
  "arguments": {}
}

{
  "name": "remove_suppression",
  "arguments": {
    "email": "fixed-mailbox@example.net"
  }
}

{
  "name": "list_blocked_recipients",
  "arguments": {}
}

アカウント、使用量、分析、キー

{
  "name": "get_account",
  "arguments": {}
}

{
  "name": "get_analytics",
  "arguments": {
    "days": 30
  }
}

{
  "name": "list_api_keys",
  "arguments": {}
}

{
  "name": "get_service_health",
  "arguments": {}
}

APIカバレッジ一覧

公開APIのすべての操作と、それに対応するツールです。ダッシュボードでできる操作のうちAPIがあるものはすべてカバーしています。以下の除外は意図的なものです。

意図的に提供していない機能

機械可読なカタログ：/docs/mcp/tools.json（スキーマ、アノテーション、エンドポイントの対応、除外項目）。このページのMarkdown版：/docs/mcp.md。CLIをインストールしていれば、sendhq commands --format jsonで同じカタログを出力できます。