Inbin agent email

@inbin/mcp

Inbin の Model Context Protocol インターフェース向けの、最小限の stdio-to-HTTP プロキシです。stdio のみをサポートする MCP クライアント（Claude Desktop、 一部の Cursor ビルド、Zed、Cline）から、Inbin のリモートエンドポイント https://api.inbin.dev/mcp に接続できます。

インストールと実行

グローバルにインストールする必要はありません。MCP クライアントから npx 経由で起動します。

{
  "mcpServers": {
    "inbin": {
      "command": "npx",
      "args": ["-y", "@inbin/mcp"],
      "env": {
        "INBIN_API_KEY": "ink_live_..."
      }
    }
  }
}

API キーは https://inbin.dev/dashboard で取得できます。

まだアカウントをお持ちでない場合

下記のリモートエンドポイントでは、5 つのツールにキーなしでアクセスできます。エージェントは受信トレイを作成し、そのアドレスを使って認証コードを待つことができます。

1. create_trial_inbox は、すぐに inbox_address を返します（14 日後に有効期限が切れます）。
2. 確認メールの送信先が必要な場所で、そのアドレスを使います。
3. 正確な inbox_address を指定して await_trial_inbox を呼び出すと、認証コードまたはリンクを最大 60 秒間待ちます。expired が返された場合は、もう一度呼び出してください。
4. claim_trial_inbox は、アドレスを継続して利用するためのリンクを返します。await_trial_inbox_claim と claim_connection_status で、その申し込みの状況を確認できます。

この stdio ラッパーは常にキーを送信するため、キーが必要なツール向けです。アカウント不要のツールを使う場合は、ヘッダーなしで https://api.inbin.dev/mcp に直接接続してください。実際に動かせる手順はこちらをご覧ください。 https://inbin.dev/guides/ai-agent-email-address-verification-codes

機能

• stdin の各 JSON-RPC メッセージを、Bearer キーを付けた HTTPS POST として https://api.inbin.dev/mcp に転送します。
• 応答を stdout にストリーミングします。
• JSON-RPC に従い、通知（id のないメッセージ）には応答しません。
• 複数のリクエストを同時に処理できます。

公開されるツール

すべての Inbin アプリケーションは MCP サーバーです。キーを使うと、次のツールを利用できます（全一覧は tools/list を問い合わせてください）。

• list_inboxes：アプリ内の受信トレイを列挙します
• list_events：受信トレイ／ステータス／期間で絞り込みます。ページネーションに対応しています
• search_events：ID／件名／送信元／宛先を部分一致で検索します
• get_event：イベントの解析済み JSON と配信履歴を取得します
• query_events：抽出されたレコードを絞り込み、並べ替え、グループ化、集計します （受信トレイをテーブルとして扱います）
• describe_schema：現在の抽出スキーマを確認します

環境変数

変数	必須	説明
INBIN_API_KEY	はい	Inbin API キー
INBIN_MCP_URL	いいえ	エンドポイントを上書きします（デフォルトは本番環境）
INBIN_MCP_DEBUG	いいえ	1 を設定すると、stderr にログを出力します

リモート接続（推奨）

MCP クライアントが Streamable HTTP トランスポートに対応している場合は、このラッパーを使わずに直接接続してください。ヘッダーなしではアカウント不要の 5 つのツールを利用でき、キーを付けるとすべてのツールを利用できます。

{
  "mcpServers": {
    "inbin": {
      "url": "https://api.inbin.dev/mcp",
      "headers": {
        "Authorization": "Bearer ink_live_..."
      }
    }
  }
}

ライセンス

MIT。