sv-number

SV Number MCP サーバー

電話番号をツールとして利用できます。エージェントがサービスの求める国で専用番号を注文し、API から SMS 認証コードを直接読み取り、番号を返却します。stdio 経由で 9 つのツールを利用でき、習得が必要な SDK はありません。

200 か国以上に対応し、このカテゴリで最も広いカバレッジを提供しています。このページにあるほかの主張もすべて検証できますが、これは 1 回の呼び出しで確認できます。list_countries を実行して、行数を数えてください。

order_number(service="tg", country=6)   ->  +62 838 1234 5678
wait_for_code(activationId)             ->  123456
finish_activation(activationId)         ->  done

インストール

Claude Code：

claude mcp add sv-number --env SVN_API_KEY=your_key_here -- npx -y sv-number-mcp

JSON 設定を読み込むもの（Codex、Cursor、Claude Desktop など）：

{
  "mcpServers": {
    "sv-number": {
      "command": "npx",
      "args": ["-y", "sv-number-mcp"],
      "env": { "SVN_API_KEY": "your_key_here" }
    }
  }
}

キーは登録後にプロフィールから取得できます。残高のチャージが必要です。この API に無料プランはありません。キーは環境変数から読み込まれ、プロセスの外に出ることはありません。どのツールもキーを返さず、エラーメッセージにキーが含まれることもありません。

ツール

ツール	機能
get_balance	アカウントの残高を確認します
list_countries	ID と通信事業者を含む、すべての国を一覧表示します
list_services	サイトのコードを検索します。名前またはドメインで検索でき、一致度の高い順に表示されます。料金、オンラインの件数、コードが実際に届いた割合も確認できます
order_number	1 つの国で 1 つのサービス用の専用番号を注文します
wait_for_code	コードが届くまでポーリングし、SMS から解析済みのコードを返します
finish_activation	成功したアクティベーションを終了します
cancel_activation	キャンセルして返金を受けます
request_another_sms	同じ番号で追加のコードをリクエストします
totp_code	RFC 6238 に基づいて、認証コードをローカルで計算します

list_services は、一致度の高い順に並んだ matches と、代替サービスの notInList を返します。サイト名または URL を指定できるため、discord.com で Discord が見つかります。また、部分一致より単語全体の一致を優先するため、x では Maxim より X.com (Twitter) が上位になります。コードは任意に割り当てられており、決して記憶から答えてはいけません。uk は Airbnb、re は Coinbase、tn は LinkedIn です。一致するものがない場合は、その旨を伝え、別の国を案内します。カタログは国によって異なるためです。また、一覧にない送信元からの SMS を受信する ot（「一覧にないサービス」）も案内します。専用コードがあるサイトの SMS はそのコードに送信されるため、ot は代替手段であり、ワイルドカードではありません。

deliveredPercent は、そのサービスと国における配信率です。この組み合わせの統計がまだない場合は null となり、これはよくあるケースです。数値がある場合は料金ではなく配信率で選んでください。数値がない場合は、次善の指標として online で現在利用可能な番号の件数を確認できます。

サーバーが代わりに処理すること

すべての呼び出しに lang が含まれます。API はこれがなくても応答しますが、その場合は別の通貨で料金が計算されるため、サーバーでは常に指定します。API が JSON の代わりに返すテキストマーカーは、解析する前に確認し、エージェントが対処できる文に変換します。たとえば NO_NUMBERS は、単なるトークンではなく「国を変更するか、通信事業者を any に設定してください」となります。ポーリングは getStatus を過剰に呼び出さない適切な間隔で実行され、wait_for_code は番号の有効期間である 20 分で停止します。

対象外の用途

このサービスの用途は認証コードの受信のみです。これらの番号から SMS を送信したり、通話を受けたりすることはできません。また、銀行、決済、政府関連のアカウントでの利用を想定していません。会話を続けるための恒久的な番号が必要なエージェントには、代わりに通信事業者の商品が必要です。

設定

変数	デフォルト
SVN_API_KEY	必須
SVN_API_BASE	https://sms-verification-number.com/stubs/handler_api
SVN_LANG	en。応答の言語と通貨の両方を設定します
SVN_POLL_SECONDS	4

関連リンク

• 同じ製品を Markdown スキルとして提供：https://github.com/sv-number/skills
• API リファレンス：https://sms-verification-number.com/en/api-sms-activate/
• 対応範囲と料金：https://sms-verification-number.com/en/number-for-ai-agents/

MIT ライセンスです。基盤となるサービスは商用です。