Virtnumber

Virtnumber MCP サーバー

AI エージェントから直接、電話番号をレンタルし、受信した SMS を読み取れます。

Virtnumber では、14 か国の専用仮想電話番号をレンタルできます。1 つの番号を 1 人の顧客が専有します。すべての番号で SMS を受信できます。米国とスウェーデンの双方向対応番号では、送信も可能です。このサーバーでは、AI エージェントが Model Context Protocol を通じて同じアカウントを利用できます。エージェントは料金の確認、番号のレンタル、次の SMS の待機と読み取りを行えます。

• エンドポイント：https://www.virtnumber.com/mcp（Streamable HTTP、リモート、インストール不要）
• サインイン：OAuth 2.1 と PKCE を使用し、自動的に検出されます。動的クライアント登録とクライアント ID メタデータドキュメントの両方に対応しています。
• ヘッドレスエージェント：代わりに、API ユーザーとトークンを x-api-user と x-api-token ヘッダーとして送信してください。
• 公式 MCP Registry に com.virtnumber/virtnumber として登録されています。

接続

Claude（ウェブおよびデスクトップ）

Settings、Connectors、Add custom connector の順に選択し、サーバー URL を貼り付けます。

https://www.virtnumber.com/mcp

Claude Code

claude mcp add --transport http virtnumber https://www.virtnumber.com/mcp

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "virtnumber": { "url": "https://www.virtnumber.com/mcp" }
  }
}

VS Code

.vscode/mcp.json：

{
  "servers": {
    "virtnumber": { "type": "http", "url": "https://www.virtnumber.com/mcp" }
  }
}

ローカル（stdio）サーバーのみを実行するクライアント

mcp-remote を使ってリモートサーバーに接続します。

{
  "mcpServers": {
    "virtnumber": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.virtnumber.com/mcp"]
    }
  }
}

ヘッドレスエージェント（API キー）

POST https://www.virtnumber.com/mcp
x-api-user: <your user id>
x-api-token: <your API token>

Virtnumber アカウントの API から API ユーザーとトークンを作成してください。トークンはサーバー上で保管してください。残高を使用できるためです。

ツール

ツール	内容
get_balance	残高、このアプリの利用上限、権限
get_pricing	国、プラン、料金
list_my_numbers	レンタル中の番号
list_messages	番号に届いた SMS を、検出されたコードとともに読み取ります
wait_for_sms	次の SMS を最大 55 秒間待機します
buy_number	番号をレンタルします（idempotency_key に対応）
send_sms	SMS を送信します（長文は複数の SMS として課金されます）
delete_number	番号を解約します

一般的な流れ：get_pricing、次に buy_number、続いて wait_for_sms で次の受信 SMS を読み取ります。

権限と利用額

OAuth でアプリを接続すると、同意画面でそのアプリの権限と利用上限を選択できます。AI エージェントも MCP サーバーを通じて同じアカウントを利用できます。接続するエージェントごとに利用上限を設定してください。エージェントはアカウントの既存の残高を使用します。残高の追加はアカウントから行います。

メッセージ本文は第三者から届くものです。エージェントでは信頼できない入力として扱ってください。

リンク

• API と MCP のリファレンス
• OpenAPI 3.1 仕様
• MCP サーバーカード
• JavaScript SDK（npm install virtnumber）
• エージェントスキル
• サポート：[email protected]