PacketExchange

AI エージェントと MCP クライアントを PacketExchange の音声・SMS マーケットプレイスに接続します。

PacketExchange は、ホスト型の Model Context Protocol サーバーを提供します。クライアントを接続すると、エージェントはツール名を指定して呼び出すことで、マーケットプレイスを検索し、ルートを比較し、電話番号認証を実行し、SMS を送信し、通話を発信して追跡し、アカウント残高を確認できます。

このリポジトリには、ドキュメントとすぐに使えるクライアント設定が含まれています。ビルドもホストも必要ありません。サーバーは PacketExchange で稼働しています。

サーバー

エンドポイント	https://packetexchange.io/mcp/http
トランスポート	Streamable HTTP、ステートレス（各リクエストは独立しており、維持するセッションはありません）
レガシーエンドポイント	https://packetexchange.io/mcp/sse。旧式の HTTP+SSE トランスポートにのみ対応するクライアント向けです
ツール	33：マーケットプレイスおよびアカウント用 15 個、Switch 用 18 個
認証	Authorization: Bearer <API key> ヘッダーをクライアント設定に追加します。3 つの公開ツールは認証なしで使用できます。

インストール

クライアントを選び、設定をコピーしてください。

クライアント	ガイド	設定
Claude Code	docs/setup/claude-code.md	configs/claude-code.json
Claude Desktop	docs/setup/claude-desktop.md	configs/claude-desktop.json
Cursor	docs/setup/cursor.md	configs/cursor.json
VS Code	docs/setup/vscode.md	configs/vscode.json
Codex	docs/setup/codex.md	configs/codex.toml
その他の MCP クライアント	docs/setup/other-clients.md	configs/generic-stdio.json

リモートサーバーに直接接続するクライアントで必要なのは、URL とヘッダーだけです。たとえば、環境変数の展開に対応した mcpServers ファイルを読み込むクライアントの場合：

{
  "mcpServers": {
    "packetexchange": {
      "type": "http",
      "url": "https://packetexchange.io/mcp/http",
      "headers": {
        "Authorization": "Bearer ${PACKETEXCHANGE_API_KEY}"
      }
    }
  }
}

ローカルコマンドしか起動できないクライアントは、mcp-remote ブリッジを介してサーバーに接続します。このブリッジには、現行の Node.js LTS リリースが必要です。

クイックスタート

サーバーを接続したら、公開ツールを試してください。API キーは不要で、費用もかかりません。

• 「PacketExchange でケニア向けの最安の音声ルートを 5 つ教えてください。販売者が提示している ASR も含めてください。」
• 「現在の PacketExchange マーケットプレイスの概要を教えてください。」

ほかの例は docs/example-prompts.md をご覧ください。

ツール

グループ	ツール
検索（公開、無料）	wmmn_list_routes, wmmn_route_details, wmmn_market_summary
ルート	wmmn_resolve_route, wmmn_purchase_route, wmmn_list_purchases
送信（有料）	wmmn_send_sms, wmmn_make_call, wmmn_get_call（無料）
認証	wmmn_send_voice_otp, wmmn_verify_start, wmmn_verify_check
アカウント	wmmn_get_balance, wmmn_list_transactions, wmmn_topup_x402
Switch（Switch プラン）	ルーティング、顧客、サプライヤー、料金、請求、詐欺設定を扱う 18 個の switch_* ツール

wmmn_make_call は非同期で通話を開始し、応答後にテキストを読み上げたり、音声を再生したり、プッシュボタンの番号を収集したりできます。結果を取得するために短時間待機し、通話がまだ進行中の場合は、後から wmmn_get_call でステータス、料金、収集した番号を確認できます。

パラメーター、必須スコープ、料金に関する注記を含む完全なリファレンスは、docs/tools.md にあります。

認証

アカウントツールを使用するには、プリペイド残高のある PacketExchange アカウントが必要です。packetexchange.io で登録して残高を追加し、ダッシュボードの API keys から API キーを作成してください。

• キーは Authorization: Bearer <key> ヘッダーとして送信され、MCP クライアントで一度設定します。サーバーがキーを受け付ける方法はこれだけです。キーを引数に取るツールはないため、キーがモデルを経由したり、会話に含まれたりすることはありません。
• 公開ツール（wmmn_list_routes、wmmn_route_details、wmmn_market_summary）はキーなしで動作します。キーのない接続でほかのツールを呼び出すと、ヘッダーを追加するよう求めるエラーが返されます。
• エージェントが必要とするスコープだけを付与した専用キーを使用してください。アカウントツールを使用する前に、docs/security.md をお読みください。

料金

費用が発生するツールは、その旨が説明に記載されているため、エージェントは呼び出す前に把握できます。通話とメッセージの料金は、プリペイド残高からルート料金にプラットフォーム手数料（ルート料金の 2％、通話またはメッセージ 1 件あたり最大 $0.001）を加えて差し引かれます。詳細は料金をご覧ください。

知っておくと便利な情報

• リストに記載されている ASR と ACD の数値は販売者の申告であり、PacketExchange が測定したものではありません。
• wmmn_send_sms は送信時点の結果（受け付け済み、送信済み、または失敗）を返します。ルートからキャリアの受領通知が返される場合、配信結果は REST API（GET /comms/sms/{messageId}）と sms.delivered および sms.failed の Webhook から確認できます。
• 音声パスコードと通話中の音声操作では、英語、スペイン語、フランス語、ドイツ語、ポルトガル語、ヒンディー語を使用できます。
• テストキー（wmmn_test_sk_...）を使うと、テスト用クレジットで通話とメッセージをシミュレートできます。Switch のデータは読み取れますが、変更できません。また、x402 によるチャージもできません。これらのリクエストは TEST_KEY_NOT_ALLOWED で拒否されます。
• PacketExchange は、認証コード、アラート、予約リマインダーなど、受信を想定している相手へのトランザクションメッセージや通話に使用してください。

リンク

• MCP サーバーの概要：packetexchange.io/mcp
• 開発者向け：packetexchange.io/developers
• API リファレンス：packetexchange.io/api-docs
• OpenAPI 仕様：packetexchange-openapi
• サポート：[email protected]

ライセンス

このリポジトリ内のドキュメントと設定は、MIT License の下で公開されています。