EmptyInbox

emptyinbox-mcp

EmptyInbox 用の MCP サーバーです。AI エージェントが使い捨てメールボックスを作成し、メッセージを読み取れます。

io.github.cnohall/emptyinbox として 公式 MCP Registry に掲載されています。

セットアップ

Claude Code：

claude mcp add emptyinbox -- npx -y emptyinbox-mcp@latest

その他の MCP クライアントの場合 — 設定に追加します：

{
  "mcpServers": {
    "emptyinbox": {
      "command": "npx",
      "args": ["-y", "emptyinbox-mcp@latest"]
    }
  }
}

セットアップは不要です。アカウントが必要な最初のツール呼び出し時にアカウントが自動登録され、今後のセッションに備えてキーが ~/.emptyinbox.json に保存されます。サーバーを単独で起動しても（MCP ホストがツールを一覧表示するために行うように）、何も作成されません。

既存のアカウントを使用する（任意 — 既存のキーを再利用する場合）：

{
  "mcpServers": {
    "emptyinbox": {
      "command": "npx",
      "args": ["-y", "emptyinbox-mcp@latest"],
      "env": {
        "EMPTYINBOX_API_KEY": "your_api_key_here"
      }
    }
  }
}

API キーは https://emptyinbox.me/settings.html で取得できます。

ツール

ツール	説明
create_inbox	新しいメールアドレスを作成します。保持しない場合、30 日後に期限切れになります
list_inboxes	アカウント上のすべてのメールボックスを一覧表示します
list_messages	受信メッセージを一覧表示します。各メッセージには抽出されたコード、アクションリンク、テキストのプレビューが含まれます
get_message	解析済みのメッセージ（コード、リンク、プレーンテキスト）を取得します。または format="text" を指定すると、フラットな形式で表示します
wait_for_message	メールが届くまで待機します — サインアップや OTP のフローに最適です。抽出されたコードも返します
get_quota	アカウントに残っているクレジットを確認します
list_bundles	クォータのバンドルと料金を一覧表示します
buy_quota	Bitcoin での支払いを見積もります。ユーザー向けの pay_url に加え、アドレス、金額、BIP21 URI を返します
check_payment	支払いが着金し、クォータが付与されたか確認します
keep_inbox	メールボックスを恒久化します（30 クレジット）。パスワードリセットなどのメールを引き続き受信できるようになります
report_issue	バグ、支払いの問題、ドキュメントの不足、機能リクエストをチームに送信します。アカウントは作成されません

エージェントのワークフロー例

1. create_inbox → "[email protected]"
2. [agent signs up to some service using that address]
3. wait_for_message(inbox="[email protected]", timeout_seconds=60)
4. → returns the verification email with code/link

支払い

すべてのアカウントには、無料で使えるメールボックスが付与されます。使い切ると、create_inbox が料金を返し、エージェントはセッションを離れることなく購入を完了できます。

1. エージェントがユーザーにバンドルを提示し、ユーザーが 1 つ選びます
2. buy_quota が pay_url を返します。これは QR コード、正確な金額、リアルタイムのステータスを表示するページで、あわせてアドレス、金額、BIP21 URI も返します
3. ユーザーが任意の Bitcoin ウォレットから支払います（または、独自のウォレットを持つエージェントが BIP21 URI で支払います）
4. wait_seconds を指定して check_payment を呼び出すと、通常はトランザクションのブロードキャストから数秒以内にクレジットが付与されたことを確認できます

buy_quota では、list_bundles の bundle ID、またはウォレット残高を使い切るエージェント向けに、1 ドルから 100 ドルまでの整数のカスタム usd 金額を指定できます。 カスタム金額には、条件を満たす最良のバンドル料金が適用されます。支払人が上乗せするネットワーク手数料は支払い金額にかかわらず同じため、1 ドル分のチャージでは、手数料が占める割合がはるかに大きくなります。

ネットワーク上で支払いが確認されるとすぐにクォータが付与されるため、承認を待つ必要はありません。人間のユーザーは https://emptyinbox.me/inboxes.html から購入することもできます