Mailbox.bot

mailbox.bot — AI エージェント向け郵便 API および MCP サーバー

このリポジトリは、mailbox.bot の公開用ディスカバリーおよび統合パッケージです。本番サービスは mailbox.bot で稼働しています。

MCP サーバーを使うと、AI エージェントが物理的な郵便物を送れます。

現在利用可能：API と MCP による物理的な郵便物の発送、転送された書類のコンテキスト、エージェント用メールボックス。スタッフ常駐の USPS 準拠施設であるカリフォルニア州マンハッタンビーチの施設に、私書箱番号（PMB）付きの所在地を月額 15 ドルで利用できます。登録時、または POST /v1/mailing-address-requests で申し込めます。PMB 番号は USPS Form 1583 の確認後に割り当てられます。

mailbox.bot は、AI エージェントとソフトウェアワークフロー向けの郵便 API です。POST /v1/mail を使って、PDF、DOCX ファイル、手紙、通知、書留郵便、はがき、書類を送付できます。受信については、運用担当者が、すでに利用している住所からスキャン画像、写真、PDF、バーチャルメールボックスの通知、人間からのメモを転送できます。エージェントはそのコンテキストを読み取り、リンクされた返信を作成し、同じ郵便スレッドで郵便物を発送できます。

forward scans/docs -> OCR-backed context + draft reply -> POST /v1/mail

エージェントができること

1. 物理郵便の発送 API — POST /v1/mail で書類と宛先住所を送信します。
2. エージェント用メールボックス — GET /v1/inbound-items?q= で割り当てられた住所の郵便物を検索し、OCR ページを読み取り、POST /v1/inbound-items/{id}/actions で scan、forward、discard を提案できます。所有者は見積価格で各提案を承認します。
3. 受信郵便コンテキスト API — GET /v1/inbound-forwarding-addresses、/v1/inbound*、/v1/postal-threads* を使って、転送された郵便物と書類のコンテキストを、関連付けられた返信に反映できます。

デフォルトの受信転送はデジタル受付チャネルであり、物理的な住所ではありません。エージェント用メールボックスは物理的に郵便物を受け取るサービスです。スタッフが手紙や小包を記録し、スキャンしたページを OCR 処理したうえで、人間の所有者が承認したエージェントの提案内容を実行します。

インストール

MCP サーバー

MCP 設定に追加します。

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

MCP のインストールガイド全文：mailbox.bot/mcp-install

OpenClaw

clawhub install mailbox-bot
# or in OpenClaw:
openclaw skills install arbengine/mailbox-bot

Claude Code、Cursor、Codex、その他のエージェント

npx skills add arbengine/mailbox-bot-skill

REST API

curl -X POST https://mailbox.bot/api/v1/mail \
  -H "Authorization: Bearer sk_agent_..." \
  -H "X-Mailbox-MD-Version: 3" \
  -H "X-Max-Cost-Cents: 1500" \
  -F '[email protected]' \
  -F 'recipient_name=Acme Corp' \
  -F 'recipient_line1=123 Main St' \
  -F 'recipient_city=Los Angeles' \
  -F 'recipient_state=CA' \
  -F 'recipient_zip=90001' \
  -F 'mail_class=certified' \
  -F 'dry_run=true'

現在利用できる機能

• メールの発送 — PDFを送信すると、施設で印刷、封入、切手貼付、郵送を行い、写真で証明します
• 受信書類のコンテキスト — forward.mailbox.bot の専用転送エイリアスで、オペレーターがすでに使用しているアドレスから、スキャン、写真、PDF、プロバイダーからの通知、人によるメモを取り込みます
• OCR対応の返信ループ — エージェントは /v1/inbound* を読み取り、draft_context を取得して、inbound_capture_id と postal_mail_thread_id を含む関連返信を送信します
• 郵便スレッド — /v1/postal-threads* で受信コンテキストと発送イベントを紐付けます
• 書類のレビュー — requires_approval=true にすると、document_preview_url 付きのレビュー項目がダッシュボードに作成されます
• 書留郵便 — USPS Certified、Certified + Return Receipt、Priority、First Class
• FedEx と UPS — 翌日、2日、陸送のゾーン別料金
• 一括郵便 — /v1/batch-mail（見積もり、下書き、確認）で、1つのPDFと1つのCSVを使用できます。サンドボックスも利用できます
• サンドボックス — テストキー（sk_agent_test_）、ドライラン、ライフサイクルのシミュレーション、請求なし
• Webhook 通知 — HMAC署名付きJSONペイロードを、ステータスが変わるたびに送信します
• MAILBOX.md の常設指示 — 発送ルールとエージェントのメールボックスワークフローを設定します
• 人間参加型 — requires_approval=true にすると、人間の承認を待つ状態になります
• 請求の保護機能 — X-Max-Cost-Cents ヘッダー、dry_run=true、1日あたりの利用上限

エージェントメールボックス — 現在利用可能

スタッフ常駐のUSPS準拠施設（カリフォルニア州マンハッタンビーチ）に、エージェント用の実在する住所とPMBを月額15ドルで用意します。メールボックスは現在利用可能です。登録時、または POST /v1/mailing-address-requests で申し込めます。PMB番号はUSPS Form 1583の確認後に割り当てられます。USPS Form 1583により、すべてのエージェントメールボックスが確認済みの人間に紐付けられます。オンライン公証を1回受け、身分証明書を2点提出します。手数料は免除されます。

• 到着 — スタッフが各手紙と荷物を封筒の写真とともに記録します。Webhook inbound.received、inbound.keywords_matched、inbound.pages_ready が送信されます
• 読み取り — GET /v1/inbound-items?q= で差出人、参照情報、OCRテキストを検索できます。GET /v1/inbound-items/{id}/pages ではページごとのOCR結果を取得できます
• 操作 — POST /v1/inbound-items/{id}/actions で scan、forward、discard を提案できます。所有者は提示された料金を確認して承認します
• プラン — 月額15ドルには、月30通と荷物5個、Open & scanのリクエスト2回が含まれます。GET /v1/inbound-plan ですべての料金を確認できます
• サンドボックス — sk_agent_test_ キーでは、アカウントのサンプルレターを使って同じエンドポイントを利用でき、請求は発生しません

まだメールボックスをお持ちでない場合は、POST /v1/mailing-address-requests で郵送先住所を申し込んでください。その後、人間がオンラインでUSPS Form 1583を完了します。

プロトコル

プロトコル	エンドポイント	詳細
REST API	https://mailbox.bot/api/v1	郵便の発送、エージェントメールボックスの読み取りと操作、受信転送コンテキスト
MCP	https://mailbox.bot/api/mcp	郵便の発送、エージェントメールボックスの検索と操作、受信コンテキスト、施設とのメッセージ送受信、Webhook、サンドボックスのライフサイクルシミュレーションに対応する45個のツール
A2A	https://mailbox.bot/api/a2a	エージェント間のタスク実行に対応する10個のスキル
OpenClaw	https://mailbox.bot/.well-known/agent.json	マルチプロトコル対応のエージェントカード

プラン

プラン	価格	状況	内容
受信コンテキスト＋送信メール	$0/mo	提供中	非公開の受信転送用エイリアスが含まれます。ダッシュボード、API、または MCP からメールを送信できます。
エージェント用メールボックス	$15/mo	提供中	カリフォルニア州マンハッタンビーチの施設にある住所と PMB、月30通の郵便物と5個の荷物が含まれます。所有者の承認を得て、スキャン、転送、または破棄できます。

送信料金：USPS First-Class の1ページの手紙は $2.00 からです。印刷料金は白黒が1ページあたり $0.40、カラーが1ページあたり合計 $0.70（カラーへのアップグレード料金 $0.30／ページを含む）です。USPS の公表する1ページの最低料金は、Priority Mail が $15.00、Certified Mail が $20.00、Certified + Electronic Return Receipt が $24.00 です。FedEx 2Day は配送業者の基本料金から一律 $8.00 差し引かれ、FedEx Overnight は一律 $18.00 加算されます。送信メールにはプリペイドクレジットを使用します。正確な見積もりには dry_run=true と cost_breakdown を使用してください。

料金の詳細：mailbox.bot/pricing

フレームワークとの連携

SDK は不要です。すべての連携で標準的な HTTP ライブラリを使用して REST API を利用します。

• LangChain（Python）
• CrewAI（Python）
• LlamaIndex（Python）
• Vercel AI SDK（TypeScript）
• OpenAI Agents SDK（Python）

リンク

• ウェブサイト
• API ドキュメント
• API リファレンス全文（LLM 対応）
• MCP インストールガイド
• MCP サーバーカード
• 公開 MCP ツールカタログ
• 公式 MCP レジストリ名 — bot.mailbox/mailbox
• サンドボックスとテストキー
• OpenAPI 仕様
• エージェントの検出
• 料金
• お問い合わせ

ClawHub への公開（メンテナー向け）

npm install -g clawhub
clawhub login
clawhub publish . \
  --slug mailbox-bot \
  --name "mailbox.bot" \
  --version 5.3.1 \
  --changelog 'v5.3.1 — agent mailbox rental is $15/mo (was $10/mo); nothing else changed.'
clawhub inspect mailbox-bot

---

ご質問はこちら：mailbox.bot/contact