Mailbox.bot

mailbox.bot MCP サーバー

mailbox.bot の公式ホスト型 Model Context Protocol サーバーです。本番環境では、https://mailbox.bot/api/mcp でリモートの Streamable HTTP を利用できます。

エージェントは手紙、書留、ポストカード、書類一式を送付できます。mailbox.bot が印刷、切手貼付、郵送、撮影、追跡を行い、証明を返送します。エージェント用メールボックスは現在利用可能です。USPS に準拠したマンハッタンビーチ（CA）の有人施設に、実在する住所と PMB を設置できます。月額 $15 です。PMB 番号は USPS Form 1583 の確認後に割り当てられます。オンライン公証の手数料は免除されます。郵送には前払いクレジットを使用し、月額基本料金はありません。

• ウェブサイト： https://mailbox.bot
• インストール： https://mailbox.bot/mcp-install
• 料金： https://mailbox.bot/pricing
• 公開ツールカタログ： https://mailbox.bot/api/mcp/tools-public
• OpenAPI： https://mailbox.bot/openapi.json および https://mailbox.bot/openapi.yaml
• レジストリ： bot.mailbox/mailbox（mailbox.bot で DNS 検証済み）

接続

サインインするだけで、キーは不要です。 MCP サインインに対応したクライアント（claude.ai、ChatGPT、Cursor、Claude Code）では、ヘッダーなしで https://mailbox.bot/api/mcp を追加できます。最初のツール呼び出しで mailbox.bot のサインインページが開き、エージェントと Sandbox または Live を選択できます。Live 接続では、各手紙の送信前にダッシュボードで承認を求められます。API Keys ページからいつでも接続を解除できます。

プラグイン。 このリポジトリは Cursor および Claude Code のプラグインでもあります。Cursor 用の .cursor-plugin/plugin.json と mcp.json、Claude Code 用の .claude-plugin/ と .mcp.json が含まれます（/plugin marketplace add arbengine/mailbox-mcp を実行し、続けて /plugin install mailbox-bot@mailbox-bot を実行します）。どちらもサインインで接続し、skills/mailbox-bot スキルを利用できます。

キーを使う場合。 ホスト型 URL を MCP クライアントに追加し、ベアラーキーを渡します。顧客がローカルプロセスを実行する必要はありません。

{
  "mcpServers": {
    "mailbox-bot": {
      "url": "https://mailbox.bot/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_agent_YOUR_KEY_HERE"
      }
    }
  }
}

mailbox.bot/signup でアカウントを作成してください。Live エージェントキー（sk_agent_）を使うと、実際の郵便物を送付でき、前払いクレジットが消費されます。Sandbox キー（sk_agent_test_）を使うと、同じエンドポイントで料金も郵便物も発生させずにリハーサルできます。メンバーアカウントキー（sk_live_）では郵便物を送付できません。

料金

プラン	料金	内容
郵便物の送付と転送された受信物のコンテキスト	$0/月	前払いクレジットで印刷・郵送できます。すでに管理している住所から、スキャン、写真、PDF を転送できます。
郵送先住所	$15/月	マンハッタンビーチ（CA）の施設にある実在する住所と PMB。現在利用可能です。PMB 番号は USPS Form 1583 の確認後に割り当てられます。

公開されている郵送料金の例では、USPS First-Class の1ページの手紙は $2.00 からです。ドライランを実行すると、その書類、ページ数、サービス、ZIP に対する正確な料金が返されます。適用される料金は、その cost_breakdown です。

ツール

ホスト型ツールは55個あります。現在のツールが先に記載されています。非推奨のツールも引き続き提供され、置き換え先が示されます。最新のスキーマは公開カタログをご覧ください。

ツール	説明
get_mailbox	アカウントの郵送先住所を読み取ります。カリフォルニア州マンハッタンビーチの施設の番地とPMBが含まれます。レンタル料金は月額15ドルで、メールボックスは現在利用できます。PMB番号は、USPS Form 1583の確認後に割り当てられます。
get_usage	使用イベントと前払いクレジット残高を読み取ります。エージェントは残高を確認できますが、クレジットを購入することはできません。
list_inbound_forwarding_addresses	メンバーがすでに管理している住所からスキャン、写真、PDFを受け取るための、forward.mailbox.bot 上の受信用エイリアスを一覧表示します。
list_inbound_mail	返信用の簡潔な下書きコンテキストとともに、転送された受信郵便を一覧表示します。
get_inbound_mail	転送された受信郵便の項目を1件読み取り、OCRに基づく情報、返信のヒント、スレッドとの関連付けを取得します。
list_postal_threads	受信コンテキストと送信をまとめた物理郵便のスレッドを一覧表示します。
get_postal_thread	物理郵便のスレッドを1件読み取り、タイムラインを取得します。
get_mailbox_md	送信前に、このエージェントのバージョン管理されたMAILBOX.mdの指示を読み取ります。
propose_mailbox_md_edit	継続的な指示の編集を提案します。所有者が承認または拒否します。
send_facility_message	このメールボックスを取り扱う施設にメッセージを送信します。
list_facility_conversations	施設との会話を一覧表示します。
get_facility_messages	施設との会話内のメッセージを読み取ります。
update_webhook	従来のエージェントWebhookコールバックURLとイベントのサブスクリプションを更新します。
send_outbound_mail	前払いクレジットを使って書類を印刷し、郵送します。実際に送信する前に dry_run=true で呼び出し、料金を提示してください。
list_outbound_mail	送信郵便のジョブとそのステータスを一覧表示します。
get_outbound_mail	費用、ステータス、発送処理時の写真を含む、送信ジョブを1件読み取ります。
cancel_outbound_mail	印刷前にキュー内の郵便をキャンセルし、対象となる前払いクレジットを一度だけ返金します。
create_test_outbound_mail	課金も実際の郵便物の発送も発生しない、サンドボックスの送信記録を作成します。
advance_test_outbound_mail	サンドボックスの送信記録を、submitted、ready、mailed、deliveredへと進めます。
quote_outbound_mail	書類を用意する前に、郵便種別、ページ数、カラー、およびFedExの場合はZIPコードに基づいて料金を見積もります。アカウントは不要です。
send_text_letter	プレーンテキストで書いた手紙を郵送します。同じ承認、上限、証明の仕組みで send_outbound_mail を通じて処理されます。
estimate_batch_mail	ファイルを用意する前に、はがき、手紙、チラシ、パンフレット（10～10,000部）の一括郵送料金を見積もります。印刷費とUSPSの郵便料金が含まれます。
create_batch_mail	テンプレートのリンク（PDF、またはPNG/JPG形式のはがき画像）と、インラインまたはCSVリンクで指定した宛先を使って、一括郵送の下書きを作成します。料金は発生せず、正確な料金は links.proof とともに返されます。
get_batch_mail_proof	校正確認を行う担当者向けの、1時間有効な校正PDFのリンクです。印刷時のテンプレートと、実寸の宛名ラベル1件が含まれます。
confirm_batch_mail	前払いクレジットで下書きの料金を一度だけ支払い、印刷キューに追加します。キーに設定された承認ポリシーと1日あたりの部数制限が適用されます。max_cost_cents により、引き落とし前に上限超過を拒否できます。
get_batch_mail	ステータス、宛先の概要、料金と返金、リンク、最初の50部を含む一括郵送の情報を読み取ります。
list_batch_mail	呼び出し元の一括郵送を新しい順に一覧表示します。サンドボックスキーではサンドボックスの一括郵送のみ表示されます。
cancel_batch_mail	施設が作業を開始する前に一括郵送をキャンセルします。クレジットは全額返金されます。
advance_test_batch_mail	サンドボックス専用です。一括郵送を submitted → in_progress → completed と進め、施設の場合と同様に batch.completed を発火させます。
search_inbound_items	割り当て済みのPMB宛ての物理郵便を、保存済みのOCRテキストも含めて検索します。サンドボックスキーでは、アカウントのMojaveサンプルレターが表示されます。
get_inbound_item	受信郵便を1件読み取り、ページ、アクション、現在のスキャン料金と転送料金の見積もりを取得します。
get_inbound_pages	受信郵便1件のページテキストを読み取ります。
quote_inbound_forward	受信郵便1件を米国内のZIPコードへ転送する場合の、すべての転送種別の料金を見積もります。
request_inbound_action	スキャン、転送、破棄を提案します。所有者が承認します。この提案によってクレジットが消費されたり、郵便物が移動されたりすることはありません。
get_inbound_activity	このキーから参照できる受信郵便のタイムラインを読み取ります。
list_webhook_endpoints	メンバーのWebhookを一覧表示します。署名シークレットは表示されません。
create_webhook_endpoint	Webhookを作成します。署名シークレットは一度だけ返されます。
update_webhook_endpoint	WebhookのURL、イベント、キーワードルール、またはステータスを更新します。
test_webhook_endpoint	合成イベント webhook.test の配信をキューに追加します。
test_webhook_endpoint_with_sample	メンバーのサンプルレターを使ってWebhookをテストします。
rotate_webhook_endpoint_secret	オペレーターから依頼された後、Webhookの署名シークレットをローテーションします。
list_webhook_deliveries	最近のWebhook配信を読み取ります。ペイロードにページテキストは含まれません。
replay_webhook_delivery	失敗したWebhook配信を再試行します。
list_agent_inbox	非推奨です。search_inbound_items を使用してください。
get_agent_inbox_context	非推奨です。get_inbound_item を使用してください。
get_agent_inbox_sources	非推奨です。get_inbound_item を使用してください。
list_agent_inbox_scans	非推奨です。get_inbound_pages を使用してください。
get_agent_inbox_scan	非推奨です。get_inbound_pages を使用してください。
get_agent_inbox_activity	非推奨です。get_inbound_activity を使用してください。
report_agent_inbox_outcome	非推奨です。後継はありません。エイリアスの提供期間が終了するまで引き続き利用できます。
get_agent_inbox_handling	非推奨です。get_inbound_item を使用してください。
propose_agent_inbox_handling	非推奨です。request_inbound_action を使用してください。
seed_agent_inbox_sandbox	非推奨です。後継はありません。エイリアスの提供期間が終了するまで引き続き利用できます。
list_inbound_items	非推奨です。search_inbound_items を使用してください。
get_inbound_item_sources	非推奨です。get_inbound_item を使用してください。

get_mailbox

アカウントの郵送先住所を読み取ります。マンハッタンビーチ（カリフォルニア州）の施設の番地と PMB が含まれます。レンタル料金は月額 $15 で、メールボックスは現在利用可能です。PMB 番号は、USPS Form 1583 の確認後に割り当てられます。

get_usage

利用イベントとプリペイド残高を読み取ります。エージェントは残高を確認できますが、クレジットを購入することはできません。

list_inbound_forwarding_addresses

forward.mailbox.bot にあるメンバーの受け取り用エイリアスを一覧表示します。運営者がすでに管理している住所から、スキャン画像、写真、PDF を受け取るためのものです。

list_inbound_mail

返信用の簡潔な下書きコンテキストとともに、転送された受信メールを一覧表示します。

get_inbound_mail

転送された受信メールを 1 件読み取り、OCR に基づく情報、返信のヒント、スレッドとの関連付けを確認します。

list_postal_threads

受信コンテキストと送信をまとめた、物理郵便のスレッドを一覧表示します。

get_postal_thread

物理郵便のスレッドを 1 件読み取り、そのタイムラインを確認します。

get_mailbox_md

送信前に、このエージェントのバージョン管理された MAILBOX.md の指示を読み取ります。

propose_mailbox_md_edit

常設の指示の編集を提案します。オーナーが承認または却下します。

send_facility_message

このメールボックスを取り扱う施設にメッセージを送信します。

list_facility_conversations

施設との会話を一覧表示します。

get_facility_messages

施設との会話内のメッセージを読み取ります。

update_webhook

従来のエージェント Webhook コールバック URL とイベントのサブスクリプションを更新します。

send_outbound_mail

プリペイドクレジットを使って書類を印刷し、郵送します。実際に送信する前に dry_run=true を指定して呼び出し、料金を提示してください。

list_outbound_mail

送信メールのジョブとそのステータスを一覧表示します。

get_outbound_mail

料金、ステータス、発送時の写真など、送信ジョブを 1 件読み取ります。

cancel_outbound_mail

印刷前のキューにある郵便物をキャンセルし、対象となるプリペイドクレジットを 1 回返金します。

create_test_outbound_mail

料金が発生せず、実際の郵便物も送られない、サンドボックスの送信記録を作成します。

advance_test_outbound_mail

サンドボックスの送信記録を submitted、ready、mailed、delivered の順に進めます。

quote_outbound_mail

書類を用意する前に、郵便種別、ページ数、カラー、FedEx の場合は ZIP コードに基づいて料金を見積もります。アカウントは不要です。

send_text_letter

プレーンテキストで書いた手紙を郵送します。同じ承認、上限、証明の仕組みを適用して send_outbound_mail 経由で処理します。

estimate_batch_mail

ファイルがなくても、はがき、手紙、チラシ、パンフレットを 10～10,000 通まとめて送る場合の料金を見積もります。印刷料金と USPS の郵送料が含まれます。

create_batch_mail

テンプレートのリンク（PDF、または PNG/JPG のはがき画像）と、インラインまたは CSV リンクによる宛先リストから、一括送信の下書きを作成します。料金は請求されず、正確な料金は links.proof とともに返されます。

get_batch_mail_proof

証明用 PDF への 1 時間有効なリンクを取得します。PDF には、印刷時のテンプレートと、実寸で印字された 1 人分の宛名ラベルが含まれます。一括送信を確認する担当者向けです。

confirm_batch_mail

プリペイドクレジットで下書きの料金を 1 回支払い、印刷キューに入れます。キーに設定された承認ポリシーと 1 日あたりの通数制限が適用されます。max_cost_cents を指定すると、引き落とし前に上限を超える処理を拒否します。

get_batch_mail

一括送信のステータス、宛先の概要、料金と返金、リンク、最初の 50 件を読み取ります。

list_batch_mail

呼び出し元の一括送信を新しい順に一覧表示します。サンドボックスキーでは、サンドボックスの一括送信のみが表示されます。

cancel_batch_mail

施設での作業が始まる前に一括送信をキャンセルします。クレジットは全額返金されます。

advance_test_batch_mail

サンドボックス専用です。施設での処理と同様に、一括送信を submitted → in_progress → completed と進め、batch.completed を発火させます。

search_inbound_items

割り当てられた PMB 宛ての物理郵便を、保存済みの OCR テキストを含めて検索します。サンドボックスキーでは、アカウントの Mojave サンプルレターが表示されます。

get_inbound_item

受信物を 1 件読み取り、ページ、アクション、現在のスキャン料金と転送料金を確認します。

get_inbound_pages

受信物 1 件のページテキストを読み取ります。

quote_inbound_forward

1 件の受信物を米国内の ZIP コードへ転送する場合の、すべての転送クラスの料金を見積もります。

request_inbound_action

スキャン、転送、または破棄を提案します。オーナーが承認します。この提案によってクレジットが消費されたり、メールが移動したりすることはありません。

get_inbound_activity

このキーが参照できるアイテムの受信タイムラインを読み取ります。

list_webhook_endpoints

メンバーの Webhook を一覧表示します。署名シークレットは含まれません。

create_webhook_endpoint

Webhook を作成します。署名シークレットは一度だけ返されます。

update_webhook_endpoint

Webhook の URL、イベント、キーワードルール、またはステータスを更新します。

test_webhook_endpoint

合成の webhook.test 配信をキューに追加します。

test_webhook_endpoint_with_sample

メンバーのサンプルレターを使って Webhook をテストします。

rotate_webhook_endpoint_secret

オペレーターの依頼を受けて、Webhook の署名シークレットをローテーションします。

list_webhook_deliveries

最近の Webhook 配信を読み取ります。ペイロードにはページテキストが含まれません。

replay_webhook_delivery

失敗した Webhook 配信を再試行します。

list_agent_inbox

非推奨です。search_inbound_items を使用してください。

get_agent_inbox_context

非推奨です。get_inbound_item を使用してください。

get_agent_inbox_sources

非推奨です。get_inbound_item を使用してください。

list_agent_inbox_scans

非推奨です。get_inbound_pages を使用してください。

get_agent_inbox_scan

非推奨です。get_inbound_pages を使用してください。

get_agent_inbox_activity

非推奨です。get_inbound_activity を使用してください。

report_agent_inbox_outcome

非推奨です。後継はありません。エイリアス期間が終了するまで引き続き提供されます。

get_agent_inbox_handling

非推奨です。get_inbound_item を使用してください。

propose_agent_inbox_handling

非推奨です。request_inbound_action を使用してください。

seed_agent_inbox_sandbox

非推奨です。後継はありません。エイリアス期間が終了するまで引き続き提供されます。

list_inbound_items

非推奨です。search_inbound_items を使用してください。

get_inbound_item_sources

非推奨です。get_inbound_item を使用してください。

このリポジトリについて

このリポジトリには、公式 MCP Registry に公開されているパブリックな server.json マニフェストが含まれています。本番サーバーは https://mailbox.bot/api/mcp でホストされています。

server.js を使用すると、レジストリから https://mailbox.bot/api/mcp/tools-public のライブツールカタログを読み取れます。認証が必要なツール呼び出しでは、ホストされているエンドポイントを使用します。Claude、Cursor、その他のクライアント向けのインストール手順は mailbox.bot/mcp-install をご覧ください。

真正性の確認

bot.mailbox/* 名前空間は、apex ドメイン mailbox.bot の DNS 証明によって予約されています。この名前空間のサーバーを MCP Registry に公開できるのは、ドメイン所有者だけです。このリポジトリの正規マニフェストとレジストリエントリは一致している必要があります。

ライセンス

MIT は、このマニフェストとレジストリアダプターに適用されます。mailbox.bot サービスは、mailbox.bot の利用規約に基づいて運営されています。