VirtualSMS MCP — SMS Verification for AI Agents

VirtualSMS MCP サーバー

クイックリンク： クイックスタート · VirtualSMS を選ぶ理由 · 構築できるもの · ツール · 質問 · 例 · 変更履歴 · セキュリティポリシー · ステータス

VirtualSMS は、開発者と AI エージェント向けのアカウント認証プラットフォームです。ワンタイム SMS 認証、専用番号のレンタル、国が一致するプロキシ、プライベートなクラウドブラウザーセッションを、1 つの API、1 つの MCP サーバー、1 つのプリペイド残高にまとめています。

実際の電話番号認証が必要な AI エージェントのためのインフラストラクチャです。

番号は通信事業者が発行した携帯電話番号で、通信事業者のネットワーク上にある実物の SIM カードを利用しています。VoIP ではないため、登録時に VoIP 番号を拒否する回線種別チェックを通過できます。

1 つのプリペイド残高から、次のことができます。

• 0.05 ドルからワンタイム SMS コードを受信する
• 専用番号を 1〜30 日間レンタルする
• 国が一致する住宅用、モバイル、データセンタープロキシを購入する
• 番号とプロキシを連携させて使えるプライベートなクラウドブラウザーセッションを開始する（ベータ版）

これら 4 つはすべて、1 つのプリペイド残高、1 つの API、1 つのダッシュボードで連携します。必要な機能だけを使うことも、組み合わせて 1 つの認証ワークフローにすることもできます。

多くのプロバイダーは、認証ワークフローの一部分だけを解決します。VirtualSMS は、番号、レンタル、プロキシ、クラウドブラウザーセッションを 1 つの API、SDK、MCP サーバーにまとめているため、必要な機能だけを使うことも、組み合わせて 1 つのワークフローにすることもできます。

VirtualSMS は、個人で手動利用したり、SDK や API を使ってアプリケーションに統合したり、MCP 経由で AI エージェントから操作したりできます。REST API、Node、Python、PHP、Ruby、.NET 向けの公式 SDK、ホスト型 MCP サーバー、n8n などの自動化ツールからプラットフォームを利用できます。

このサーバーは、あらゆる MCP クライアントからこのプラットフォームを利用できるようにします。AI エージェント向けに構築され、AI エージェントのワークフローを念頭に設計されています。Claude Code、Claude Desktop、Cursor、Windsurf、および MCP 互換クライアントで動作し、ラッパーコードを書く必要はありません。

クイックスタート

これを MCP クライアントの設定に貼り付けてください。インストールは不要で、クライアントに Node.js も必要ありません。

{
  "mcpServers": {
    "virtualsms": {
      "type": "streamableHttp",
      "url": "https://mcp.virtualsms.io/mcp",
      "headers": {
        "x-api-key": "vsms_your_api_key_here"
      }
    }
  }
}

virtualsms.io で API キーを取得してください。次に、エージェントにこう依頼します。

「最も安い国の Telegram 番号を購入して、認証コードを待って。」

ローカルで stdio 経由で実行したい場合は、こちらを使ってください。

npx virtualsms-mcp

VirtualSMS を選ぶ理由

アカウント認証のために、あるプロバイダーから番号を、別のプロバイダーからプロキシを、さらに別のプロバイダーからブラウザーセッションを寄せ集める必要はありません。複数のアカウント、残高、API を管理し、サポートも複数のベンダーに分散してしまいます。VirtualSMS は、これらを 1 つの残高、1 つの API、1 つの MCP サーバーにまとめています。

VirtualSMS は 3 つすべてを 1 つのアカウントに統合し、操作方法も 1 つにまとめています。

• 通信事業者が発行した携帯電話番号。 実物の SIM カードを利用しており、VoIP ではないため、登録時に携帯電話番号として判定されます。
• 国が一致するプロキシ。 住宅用、モバイル、データセンターの各プールがあり、番号と IP の国が一致します。
• プライベートなクラウドブラウザーセッション。 ベータ版です。
• REST API。 virtualsms.io/docs にドキュメントがあります。
• ホスト型 MCP サーバー。 このリポジトリのサーバーは https://mcp.virtualsms.io/mcp で稼働しています。
• 1 つのプリペイド残高。 認証、レンタル、プロキシのすべてに利用できます。

以下では、この 6 項目について詳しく説明します。

構築できるもの

このサーバーが現在実行できる具体的なタスクです。どれも、エージェントがツール呼び出しに変換する平易な英語のリクエストです。

最初の 2 つを実行できるサンプルは、examples/ にあります。

クライアントのセットアップ

すべてのクライアントで、同じ npx virtualsms-mcp の stdio コマンドを実行します。異なるのはファイルの場所と形式だけです。上記のホスト型設定は streamableHttp がサポートされている場所ならどこでも動作し、推奨される方法です。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "virtualsms": {
      "command": "npx",
      "args": ["virtualsms-mcp"],
      "env": {
        "VIRTUALSMS_API_KEY": "vsms_your_api_key_here"
      }
    }
  }
}

Claude Desktop を終了して、再度開きます。すぐに使える設定と実際のやり取りの記録は、examples/03-claude-desktop-config/ にあります。

claude mcp add --scope user virtualsms npx virtualsms-mcp -e VIRTUALSMS_API_KEY=vsms_your_api_key_here

{
  "mcpServers": {
    "virtualsms": {
      "command": "npx",
      "args": ["virtualsms-mcp"],
      "env": {
        "VIRTUALSMS_API_KEY": "vsms_your_api_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "virtualsms": {
      "command": "npx",
      "args": ["virtualsms-mcp"],
      "env": {
        "VIRTUALSMS_API_KEY": "vsms_your_api_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "virtualsms": {
      "command": "npx",
      "args": ["virtualsms-mcp"],
      "env": {
        "VIRTUALSMS_API_KEY": "vsms_your_api_key_here"
      }
    }
  }
}

[mcp_servers.virtualsms]
command = "npx"
args = ["virtualsms-mcp"]
env = { VIRTUALSMS_API_KEY = "vsms_your_api_key_here" }

{
  "mcpServers": {
    "virtualsms": {
      "command": "npx",
      "args": ["virtualsms-mcp"],
      "env": {
        "VIRTUALSMS_API_KEY": "vsms_your_api_key_here"
      }
    }
  }
}

{
  "virtualsms": {
    "command": "npx",
    "args": ["virtualsms-mcp"],
    "env": {
      "VIRTUALSMS_API_KEY": "vsms_your_api_key_here"
    }
  }
}

{
  "context_servers": {
    "virtualsms": {
      "command": {
        "path": "npx",
        "args": ["virtualsms-mcp"],
        "env": {
          "VIRTUALSMS_API_KEY": "vsms_your_api_key_here"
        }
      }
    }
  }
}

mcpServers:
  - name: virtualsms
    command: npx
    args:
      - virtualsms-mcp
    env:
      VIRTUALSMS_API_KEY: vsms_your_api_key_here

ChatGPT で使えますか？

はい。ChatGPT の Developer Mode を使います。設定を開いて Developer mode をオンにし、カスタムコネクターとして https://mcp.virtualsms.io/mcp を追加します（Plus、Pro、Business、Enterprise、Edu プランが対象で、無料プランでは利用できません）。設定は設定ファイルではなく URL を貼り付ける方式のため、上記のクライアント設定とは異なります。ChatGPT がリモート MCP サーバーに接続できるのは SSE またはストリーミング HTTP 経由のみなので、ローカルの stdio コマンドではなく、ホスト型エンドポイントを使用してください。カスタム GPT や Action を作成する場合は、REST API も引き続き利用できます。

設定

ツール

デフォルトで 40 個のツールを利用できます。VIRTUALSMS_ENABLE_SESSIONS=1 を設定すると、さらに 3 個のツールが利用可能になります。 ツール名は読みやすさを考慮して、virtualsms_ プレフィックスを省略して表示しています。実際のワイヤー名には、virtualsms_create_order、virtualsms_get_sms などのプレフィックスが付きます。

一般的なワークフロー

認証コードを取得する

create_order(service: "telegram", country: "US")
→ {order_id: "abc123", phone_number: "+14155552671", status: "pending"}

wait_for_sms(order_id: "abc123", timeout_seconds: 180)
→ {success: true, code: "12345", delivery_method: "websocket", elapsed_seconds: 8}

最も安い国を先に探す

find_cheapest(service: "telegram", limit: 3)
→ {cheapest_options: [{country: "PK", price_usd: 0.05, ...}]}

create_order(service: "telegram", country: "PK")
wait_for_sms(order_id: "abc123")

電話番号で SMS を受信できない場合は交換する

swap_number(order_id: "abc123")
→ {order_id: "def456", phone_number: "+628...", status: "waiting"}

電話番号を 1 か月レンタルする

rentals_available(tier: "full_access")
→ countries holding local SIM stock, each with its own duration and price list

create_rental(tier: "full_access", country: "FR", duration_hours: 720)
→ {rental_id: "rnt_1", phone_number: "+33...", expires_in_days: 30}

在庫は国とプランごとに異なるため、まず在庫を確認してからレンタルしてください。rentals_available(tier: "platform") では、別のサービスロック付きカタログを確認できます。

電話番号と同じ国のプロキシを組み合わせる

list_proxy_catalog()
buy_proxy(pool_type: "residential", gb: 1, country_code: "GB")
generate_proxy_endpoint(proxy_id: "px_1", country_code: "GB", protocol: "socks5")

質問

アカウント認証インフラとは？

アカウント認証インフラとは、電話番号を要求する登録フローを、実在するアカウントで完了させるための仕組みです。以下の5つのレイヤーで構成され、どれか1つでも欠けると、すべてが失敗します。

1. 電話番号。 携帯電話会社が発行したモバイル回線です。回線の種類が確認されるためです。
2. SMS。 その番号に届く認証コードです。端末を持つ人ではなく、ソフトウェアが読み取れる必要があります。
3. プロキシ。 番号と同じ国のIPアドレスです。両者の情報が一致するようにします。
4. ブラウザー。 登録フローを実行するためのクリーンな環境です。
5. 自動化。 一連の処理を無人で最初から最後まで実行するAPIまたはエージェントです。

多くのプロバイダーが提供するのは最初の2つのレイヤーだけで、残りは自分で用意する必要があります。まさにそこで、番号、IPアドレス、ブラウザーの情報に食い違いが生じます。VirtualSMSは、5つすべてを支えるインフラを提供します。

VirtualSMSは、個人、開発者、AI エージェント向けのアカウント認証プラットフォームです。1つのAPI、1つのMCP サーバー、1つのプリペイド残高で、ワンタイムSMS認証、専用番号のレンタル、番号と同じ国のプロキシ、プライベートなクラウドブラウザーセッションを利用できます。

SMS認証用MCP サーバーとは？

MCP（Model Context Protocol）は、AI クライアントが外部ツールを呼び出せるようにするオープン標準です。SMS認証用のMCP サーバーは、電話番号や認証コードに関する操作を、エージェントが直接呼び出せるツールとして提供します。そのため、エージェントは番号を購入し、コードを待ち、取得したコードを読み取ることができ、あなたが連携コードを書く必要はありません。このリポジトリはVirtualSMS向けのサーバーで、認証、レンタル、プロキシをカバーする40個のツールを備えています。エージェントを使わない場合も、同じ操作を通常のREST認証APIから利用できます。

どんなときに使うべきですか？

• AI エージェントで、電話番号を要求するアカウントへのサインインやアカウント登録を行う場合。
• OTPや登録フローをテストする際、テスト用SIMを引き出しにためておくのではなく、必要に応じて新しい番号を使いたい場合。
• CIや無人ジョブで、認証コードを自動取得する必要がある場合。
• 番号と、番号と同じ国のIPアドレスが互いに一致する必要がある場合。
• ブラウザーで登録の自動化を行っており、番号、IPアドレス、ブラウザーを別々の場所から用意するのではなく、1か所から揃えたい場合。
• 1つのコードのための一時的な電話番号、または最長30日間維持できる専用番号が必要な場合。
• サブスクリプションや月額の番号レンタルなしで、コード1件あたり$0.05からの料金を希望する場合。

どんなときに使うべきではありませんか？

時間を無駄にしないために、正直にお伝えします。

• SMSを送信する必要がある場合。 このプラットフォームはSMSを受信しますが、送信はできません。Twilioなどのメッセージングプロバイダーをご利用ください。
• ビジネス用の恒久的な番号が必要な場合。 認証用番号は一時利用を前提としており、レンタル期間は年単位ではなく日単位です。電話会社から通常の回線をご購入ください。
• すでに所有している番号でコードを受信したい場合。 番号の持ち込みには対応していません。番号は当社の在庫から提供されます。
• A2Pマーケティングキャンペーンを実施する場合。 まったく用途が異なります。
• プラットフォームの利用規約を回避しようとしている場合。 認証先のサービスの規約に準拠した利用かどうかは、お客様の責任であり、当社の責任ではありません。

ClaudeやCursorでSMS認証コードを受け取れますか？

はい、このサーバーを通じて受け取れます。Claude Code、Claude Desktop、Cursor、Windsurf、Cline、Zed、Continue.dev、Codex、OpenClaw、HermesはいずれもMCPクライアントです。各クライアントは設定を貼り付けるだけで利用できます（クライアントのセットアップを参照）。インストール後は、「Telegramの番号を購入してコードを待って」と依頼すれば、エージェントが最初から最後まで実行できます。ChatGPTからも、Developer Modeのカスタムコネクター（ChatGPTで使えますか？を参照）、またはDeveloper Modeを有効にしたくない場合はREST APIを通じて利用できます。

AI エージェントは OTP コードを自動でどのように受け取りますか？

ツールを 2 つ呼び出します。create_order は指定したサービスと国の電話番号を購入し、order_id を返します。次に wait_for_sms はその order_id を待機し、コードが届いた瞬間に返します。コードは WebSocket 経由でプッシュされ、通常 2～15 秒で届きます。エージェントはポーリングもループ内でのスリープも不要で、人間に電話を確認してもらう必要もありません。独自のループを動かしたい場合は、代わりに get_sms で 1 件の注文をポーリングできます。

Twilio との違いは何ですか？

Twilio は、SMS や音声の送受信、長期利用の電話番号、A2P キャンペーンなどを備えた総合通信プラットフォームです。VirtualSMS は、必要なときに認証コードを受信するという 1 つの用途に特化しています。実用上の違いは次のとおりです。

• 回線の種類。 Twilio の電話番号は VoIP です。多くのサービスでは、登録時に VoIP 番号が拒否されます。VirtualSMS の電話番号は、通信事業者のネットワーク上にある実際の物理 SIM カードなので、モバイル回線として判定されます。
• 料金体系。 Twilio では、使うかどうかにかかわらず、電話番号の月額料金が発生します。VirtualSMS はサブスクリプション不要で、コードごとに $0.05 から課金されます。
• 通信の方向。 Twilio は送受信に対応しています。こちらは受信のみです。

メッセージを送信する必要がある場合は、Twilio をお使いください。認証コードを受信する必要がある場合は、この用途に特化したサービスをご利用ください。

VoIP ではなく実際の物理 SIM カードを使うのはなぜですか？

認証システムは、入力された電話番号の回線種別を確認します。VoIP 番号は安価で大量に使い捨てられるため、不正行為との関連が見られ、多くのサービスでは登録時に完全に拒否されます。実際の物理 SIM カードは通信事業者のネットワーク上にあり、モバイル回線として判定されます。これはまさに、認証システムが確認している条件、つまり実際の携帯電話のように機能する非 VoIP 番号です。

これをそのまま信じる必要はありません。check_number は E.164 番号の通信事業者と回線種別を調べます。API キーは不要で、その番号がモバイル、固定電話、VoIP のどれとして判定されるかを知らせます。

代替サービスと比較

textverified mcp、sms-activate mcp、5sim mcp、daisysms mcp、smspool mcp を検索する開発者が知りたいのは、たいてい 1 つのことです。AI エージェントがネイティブに操作できる SMS 認証プロバイダーはどれか。このセクションでは、順位付けをせずにその疑問に答えます。

VirtualSMS はこの MCP サーバーを公開しているため、どの MCP クライアントからもラッパーコードなしで直接呼び出せます。ツール 40 個、サービス 2500 以上、国 145 以上、実際の物理 SIM カードを利用し、コード 1 件あたり $0.05 から利用できます。同じ残高で電話番号のレンタルや、番号と同じ国のプロキシも利用できます。

SMS-Activate は 2025 年 12 月にサービスを終了しました。連携先が SMS-Activate だった場合、その連携先はもう利用できません。移行に必要なのは API キーとベース URL の変更で、作り直す必要はありません。番号を購入してコードを受け取るという処理の流れは、こちらでも同じです。

TextVerified、5SIM、DaisySMS、SMSPool は、いずれも現在も利用できる SMS 認証プロバイダーで、それぞれ独自の API、料金、対応範囲、利用規約があります。現在の提供内容については、各サービスの最新ドキュメントをご確認ください。

競合サービスの料金、サービス数、対応範囲をまとめた比較表は、意図的に公開していません。こうした数値は毎週変わり、他社の在庫を特別に把握しているわけでもありません。調査結果を装った古い表は、表がないよりも有害です。上記の VirtualSMS に関する数値は当社のものであり、その内容に責任を持ちます。現在お使いのサービスと比較してください。

仕組み

WebSocket とポーリング

wait_for_sms は、2 段階の配信システムを使用します。

1. WebSocket による即時配信。 wss://virtualsms.io/ws/orders?order_id=xxx&api_key=your_key に接続します。SMS が届くと、サーバーからリアルタイムでプッシュされます。通常の配信時間は 2～15 秒です。
2. ポーリングによるフォールバック。 WebSocket に接続できない場合、または接続が切れた場合、ツールは残りのタイムアウト時間、5 秒ごとのポーリングに切り替えます。

レスポンスの delivery_method フィールドで、使用された方法を確認できます。値は websocket、polling、または呼び出す前にコードがすでに届いていた場合の instant です。

このサーバーは接続を維持した WebSocket 経由でプッシュ配信を行います。コールバックを送ることはありません。VirtualSMS から所有する URL にイベントを POST させたい場合は、プラットフォームの別の Webhook サブスクリプションシステムを利用してください。このシステムはダッシュボードで設定し、この MCP サーバーではなく REST API を通じて動作します。

アーキテクチャ

AI Agent (Claude / Cursor / Codex / Windsurf / any MCP client)
    │
    ▼ MCP (stdio or StreamableHTTP)
VirtualSMS MCP Server (this package)
    │
    ├──► REST API: https://virtualsms.io/docs
    │        create_order, get_sms, cancel_order, get_balance ...
    │
    └──► WebSocket: wss://virtualsms.io/ws/orders
             real-time SMS push delivery

クラッシュからの復旧

セッションが認証の途中で中断された場合は、次の手順で復旧できます。

1. MCP サーバーを再起動します。
2. アクティブな注文を一覧表示します： list_orders(status: "pending")
3. コードを確認します： get_sms(order_id: "abc123")
4. 不要な注文をキャンセルします： cancel_order(order_id: "abc123")

wait_for_sms はタイムアウト時も必ず order_id を返すため、復旧できます。

ホステッドエンドポイントとステータス

• ホステッド MCP エンドポイント： https://mcp.virtualsms.io/mcp。TLS 専用の StreamableHTTP で、Cloudflare を経由します。
• プラットフォームのステータスと稼働時間： virtualsms.io/status。ウェブサイトとダッシュボード、SMS ゲートウェイ、REST API、Telegram ボット、データベースの状況をリアルタイムでポーリングします。ホステッド MCP エンドポイントは別のサービスとして稼働しており、現時点ではこのページに項目がありません。
• 目標 SLA： ホステッド MCP の経路で 99.9％。契約上の保証ではなく、当社が自らに課している目標です。上記のステータスページでは、まだ測定されていません。
• 対応範囲： 145 か国以上で利用可能、2500 以上のサービスを掲載しています。
• データ保持： SMS メッセージの本文は 7 日間保持した後、完全に削除されます。注文のメタデータ（電話番号、サービス、国、タイムスタンプ）はアカウントの有効期間中保持されます。詳しくは SECURITY.md をご覧ください。
• 脆弱性の報告： [email protected] にメールを送るか、非公開のセキュリティアドバイザリを作成してください。

👉 VirtualSMS.io に登録する

例

実行可能な例が 3 つ、このリポジトリに含まれています。VIRTUALSMS_API_KEY を設定すれば、いずれも node run.mjs ですぐに実行できます。

• examples/01-quick-balance-check/：5 秒で実行できるホステッド MCP のスモークテスト（get_balance）。
• examples/02-buy-sms-and-wait-for-code/：認証フロー全体の例。find_cheapest → create_order → wait_for_sms → タイムアウト時のキャンセル。AI エージェント向けの標準的なパターンです。
• examples/03-claude-desktop-config/：すぐに使える Claude Desktop の設定と、StreamableHTTP 経由で「残高を教えて」と Claude に尋ねた会話の記録。

SDK とツール

すでにお使いの言語から、同じプラットフォームを利用できます。

ビルドと貢献

git clone https://github.com/virtualsms-io/mcp-server.git
cd mcp-server
npm install
npm run build      # tsc
npm test           # vitest
npx tsc --noEmit   # typecheck only

2 つのトランスポートは同じツールテーブルを共有しています。src/index.ts（stdio）と src/http-server.ts（StreamableHTTP）です。ツールの定義とハンドラーは src/tools.ts にあります。ツールを追加する場合は、両方のトランスポートに組み込んでください。追加し忘れると src/__tests__/transport-parity.test.ts がビルドを失敗させ、ドキュメントに存在しないツール名が記載されていると src/__tests__/docs-tool-names.test.ts が失敗します。

課題とプルリクエスト：github.com/virtualsms-io/mcp-server。

v1.0.0 から v1.3.1 までのリリースノートは CHANGELOG.md にあります。

セキュリティ

API キーは x-api-key ヘッダー（ホスト型）または VIRTUALSMS_API_KEY 環境変数（ローカル stdio）経由で渡され、virtualsms.io のアカウントからローテーションできます。ポリシー、データ保持の詳細、情報開示の手順については、SECURITY.md をご覧ください。

脆弱性は [email protected] までご報告ください。

ライセンス

MIT。LICENSE をご覧ください。

VirtualSMS.io が開発。実際の物理 SIM カードを使った、開発者と AI エージェント向けのアカウント認証：2500+ のサービス、145+ か国、1 コードあたり $0.05 から。