botcall-mcp

botcall-mcp

AI エージェントに実際の電話番号を提供する MCP サーバーです。番号を取得し、SMS を受信して、認証コードを抽出します。すべてツール呼び出しで行えます。

Claude Desktop、Claude Code、および MCP 対応のすべてのクライアント向けに構築されています。

セットアップ

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "botcall": {
      "command": "npx",
      "args": ["-y", "botcall-mcp"],
      "env": {
        "BOTCALL_API_KEY": "bs_live_..."
      }
    }
  }
}

Claude Code

claude mcp add botcall -- npx -y botcall-mcp

次に、環境変数に API キーを設定します。

export BOTCALL_API_KEY="bs_live_..."

その他の MCP クライアント

MCP stdio トランスポートに対応するクライアントであれば、どれでも利用できます。BOTCALL_API_KEY を設定して npx botcall-mcp を実行します。

API キーの取得

botcall.io で登録し、プランを選択して、ダッシュボード → API Keys からキーを取得します。

ツール

provision_number

SMS 受信用の新しい電話番号を取得します。

パラメーター	型	説明
areaCode	string	希望する市外局番。例："206"（任意）
country	string	ISO 国コード（デフォルト："US"）

get_code

受信 SMS を待機し、認証コードを抽出します。メッセージが届くかタイムアウトになるまで、ロングポーリングします。

パラメーター	型	説明
timeout	number	待機時間（秒）（デフォルト：30、最大：30）
numberId	string	特定の番号で絞り込みます（任意）

get_inbox

番号宛てに受信した最近の SMS メッセージを取得します。

パラメーター	型	説明
limit	number	返すメッセージの最大数（デフォルト：10）
numberId	string	特定の番号で絞り込みます（任意）

list_numbers

取得済みの電話番号をすべて一覧表示します。パラメーターはありません。

release_number

不要になった電話番号を解放します。

パラメーター	型	説明
numberId	string	必須。 解放する番号の ID

get_usage

現在のプラン、上限、使用状況の統計情報を取得します。パラメーターはありません。

例

You: Sign up for ExampleService using a phone number

Agent: I'll provision a number and handle the verification.

→ provision_number({ areaCode: "415" })
  { number: "+14155550123", id: "pn_abc123" }

→ [agent enters the number on ExampleService's signup page]

→ get_code({ numberId: "pn_abc123" })
  Verification code: 847291

→ [agent enters 847291 to complete verification]

環境変数

変数	説明
BOTCALL_API_KEY	必須。 botcall.io の API キー
BOTCALL_API_URL	API のベース URL（デフォルト：https://api.botcall.io）

ライセンス

MIT