VoidMob MCP

VoidMob MCP

モバイルプロキシ、非 VoIP SMS 認証、専用番号、グローバル eSIM - これらを AI エージェントが直接呼び出せる 30 個のツールとして公開します。さらに短いガイド（リソース）とガイド付きプロンプトも用意しています。

npx -y @voidmob/mcp

セットアップ

1. https://dashboard.voidmob.com/developers/api-keys で API キーを生成し（キーは vmk_live_ で始まる 32 文字のシークレットです）、https://dashboard.voidmob.com/wallet で暗号通貨を使って残高をチャージします。
2. お使いのクライアントに MCP を追加します（スニペットは以下を参照）。キーは VOIDMOB_API_KEY として指定します。
3. 任意: オーナーコントロールで注文ごとの上限とセッション予算を設定できます。

クライアントおよびエージェントランタイムごとのステップバイステップガイド: voidmob.com/mcp と voidmob.com/integrations。

Claude Code

プラグインとして（MCP サーバー + スキルを一度にインストール。ダイアログがキーをシークレットとして保存し、サンドボックス、読み取り専用、支出上限を提供します）:

/plugin marketplace add voidmobcom/voidmob-plugin
/plugin install voidmob@voidmob

または MCP サーバーのみ:

claude mcp add voidmob -s user -e VOIDMOB_API_KEY=vmk_live_... -- npx -y @voidmob/mcp

-s user を指定すると、サーバーがすべてのプロジェクトで利用可能になります。キーは -e の後、-- の前に置きます。同じプラグインは Codex と Gemini CLI にもインストールできます。voidmob-plugin を参照してください。

Cursor

~/.cursor/mcp.json に追加します:

{
  "mcpServers": {
    "voidmob": {
      "command": "npx",
      "args": ["-y", "@voidmob/mcp"],
      "env": { "VOIDMOB_API_KEY": "vmk_live_..." }
    }
  }
}

Claude Desktop

ワンクリックバンドル。最新の GitHub リリースから voidmob-mcp.mcpb をダウンロードして開きます（または Claude Desktop にドラッグするか、Settings > Extensions > Advanced > Install Extension を使用します）。Claude Desktop が設定を求めます: API キー（安全に保存されます）、サンドボックスモード、読み取り専用、注文ごとの上限、セッション予算（オーナーコントロールを参照）。npm run pack:mcpb で自分でビルドすることもできます。

または設定ファイルで。 Settings > Developer > Edit Config（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json）を開き、次を追加します:

{
  "mcpServers": {
    "voidmob": {
      "command": "npx",
      "args": ["-y", "@voidmob/mcp"],
      "env": { "VOIDMOB_API_KEY": "vmk_live_..." }
    }
  }
}

VS Code

.vscode/mcp.json に追加します（VS Code は一度だけキーを尋ね、安全に保存します）:

{
  "inputs": [
    { "type": "promptString", "id": "voidmob-api-key", "description": "VoidMob API key (vmk_live_...)", "password": true }
  ],
  "servers": {
    "voidmob": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@voidmob/mcp"],
      "env": { "VOIDMOB_API_KEY": "${input:voidmob-api-key}" }
    }
  }
}

Windsurf (Devin Desktop)

Cascade パネルのメニューから MCP 設定を開きます（Open MCP config file）。現在の Devin Desktop ビルドでは ~/.config/devin/mcp_config.json（Windows: %APPDATA%\devin\mcp_config.json）に保存されます。名前変更前の Windsurf ビルドでは ~/.codeium/windsurf/mcp_config.json を使用します。次を追加します:

{
  "mcpServers": {
    "voidmob": {
      "command": "npx",
      "args": ["-y", "@voidmob/mcp"],
      "env": { "VOIDMOB_API_KEY": "vmk_live_..." }
    }
  }
}

Codex CLI

codex mcp add voidmob --env VOIDMOB_API_KEY=vmk_live_... -- npx -y @voidmob/mcp

または ~/.codex/config.toml に追加します（Codex CLI、IDE 拡張機能、ChatGPT デスクトップアプリで共有されます）:

[mcp_servers.voidmob]
command = "npx"
args = ["-y", "@voidmob/mcp"]
env = { VOIDMOB_API_KEY = "vmk_live_..." }

Gemini CLI

~/.gemini/settings.json に追加し、シェルで VOIDMOB_API_KEY をエクスポートします（Gemini CLI は、サーバーの env に列挙されていない限り、キーのような名前の変数を MCP サーバーから隠します）:

{
  "mcpServers": {
    "voidmob": {
      "command": "npx",
      "args": ["-y", "@voidmob/mcp"],
      "env": { "VOIDMOB_API_KEY": "$VOIDMOB_API_KEY" }
    }
  }
}

OpenClaw

~/.openclaw/.env に VOIDMOB_API_KEY=vmk_live_... を記述し、次を実行します:

openclaw mcp set voidmob '{"command":"npx","args":["-y","@voidmob/mcp"],"env":{"VOIDMOB_API_KEY":"${VOIDMOB_API_KEY}"}}'
openclaw mcp doctor voidmob --probe

またはエージェントスキルを使用します。ガイド: voidmob.com/integrations/openclaw。

Hermes Agent

~/.hermes/.env に VOIDMOB_API_KEY=vmk_live_... を記述し、~/.hermes/config.yaml に追加します:

mcp_servers:
  voidmob:
    command: "npx"
    args: ["-y", "@voidmob/mcp"]
    env:
      VOIDMOB_API_KEY: "${VOIDMOB_API_KEY}"

またはエージェントスキルを使用します。ガイド: voidmob.com/integrations/hermes-agent。

Pi

pi mcp add voidmob --env VOIDMOB_API_KEY='${VOIDMOB_API_KEY}' -- npx -y @voidmob/mcp
pi mcp list

シングルクォートは ${VOIDMOB_API_KEY} を、Pi がシェルから読み取る参照として保持します。ガイド: voidmob.com/integrations/pi-coding-agent。

Grok Bot

1. Bot の Secrets に、VOIDMOB_API_KEY という名前のシークレットを追加し、値にあなたのキーを設定します。
2. チャットで次のように送信します: Read https://voidmob.com/skill.md and follow it. My VoidMob API key is in the VOIDMOB_API_KEY secret.

このスキルは、Bot のコンピューター上で curl を使って REST API を実行し、シークレットを名前で読み取ります。npx -y @voidmob/mcp を実行する Command タイプのカスタム MCP サーバーも試せるもう一つの手段です。xAI のドキュメントでは、シークレットを必要とするサーバーはリモート HTTPS を指すよう案内されているため、サーバーがキーを読み取れない場合はスキルを使用してください。キーそのものをチャットに貼り付けないでください。ガイド: voidmob.com/integrations/grok-bot。

料金の仕組み

• 前払い残高。 すべての支払いは USD 残高から行われ、ダッシュボードで暗号資産を使ってチャージします。MCP は資金を追加できません。API キーに別途の支出上限はなく、残高がそのまま上限となります。そのため、エージェントに使われてもよい金額だけを残高に保ち、ローカルのオーナー向け制御も検討してください。
• 価格はあなたが承認します。 検索ツールには最新の価格が表示されます。すべての購入、更新、チャージ、および有料の再利用には max_price_cents が必要です。これはエージェントがあなたに提示し、あなたが承認した価格です。現在の価格がそれより高い場合、課金は行われず、ツールは新しい価格を返すので、エージェントはあなたに再度確認できます。あなたが見ていない価格で購入されることはありません。すべての購入は残高から即時に引き落とされ、各結果には請求された金額が表示されます。
• 再試行による二重請求はありません。 すべての購入には冪等キーが付与されます。接続が切断された場合、この MCP サーバーは同じキーで一度だけ再試行し、API が二重に請求することはありません。
• 結果が不確かな場合、 ツールは購入が成立した可能性があると通知します。再度購入する前に、list_orders、対応する取得ツール、または get_account を確認してください。
• SMS が届かなければ SMS 認証は無料です。 番号は最大 15 分間開いたままで、複数のコードを受信できます。1 件も届かなければ、料金は自動的に返金されます（ステータス cancelled）。まれな例外として、返金不可と表示されたサービスは、返金なしで expired となります。SMS が届く前にキャンセルしても全額返金されますが、頻繁なキャンセルは SMS 購入を一時的に停止させることがあります。
• 長期レンタルは、購入から 60 分以内であればキャンセルして全額返金を受けられます。
• 専用番号は毎月請求され、キャンセルはできません。自動更新をオフにしておけば、月末に番号はそのまま失効します。
• eSIM は、一度発行されると MCP からキャンセルすることはできません。誤って購入し、一度もインストールしていない場合はサポートにお問い合わせください。
• プロキシは、プロビジョニングできない場合、自動的に返金されます。

オーナーによる制御

サーバーをインストールする人向けの任意の安全設定です。ライブモードとサンドボックスモードの両方で適用され、いずれかが拒否した場合は課金されません。

環境変数	効果
VOIDMOB_READ_ONLY=1	お金を使ったり何かを変更したりするツールはまったく登録されません。エージェントは価格の検索と注文の読み取り以外はできません。
VOIDMOB_MAX_ORDER_CENTS=2500	リクエストの前に、max_price_cents がこの値（ここでは $25）を超える購入、更新、チャージ、有料の再利用を拒否します。1 回の更新がこれより高くつく場合、自動更新をオンにすることは拒否されます。
VOIDMOB_BUDGET_CENTS=5000	このサーバープロセスの実行中の使用上限です（ここでは $50）。サーバーは各購入で課金された額を集計します。結果が不明な場合（接続の切断、購入がまだ処理中など）は、max_price_cents の全額を集計します。超過する可能性のある購入は拒否され、自動更新をオンにすることはできません（更新は後で、セッションの外で課金されます）。これはセッション単位の安全網であり、アカウントの上限ではありません: サーバーの再起動時にリセットされ、他の場所で行われた購入は認識しません。
VOIDMOB_TOOLSETS=sms,esim	これらのツールグループのみを読み込むため、エージェントが保持するコンテキストが少なくなります: sms、numbers（専用番号）、esim、proxy。アカウント、注文、ジオのツールは常に有効です。

get_account は適用中の上限と、残りの予算を表示します。不正な値は無視されるのではなく、エラーでサーバーを停止させます。

SMS コードの待機

rent_number の後、wait_seconds（最大 120）を指定して get_rental を呼び出します。サーバーはエージェントの代わりにポーリングし（2、3、5、8 秒、その後は 10〜15 秒ごと）、コードが到着するか、15 分のウィンドウが閉じるか、待機が終了すると、最新の SMS を添えてすぐに返します。進捗トークンを送信するクライアントは進捗通知を受け取り、リクエストをキャンセルすると待機が停止します。SMS のテキストは信頼できないデータとしてフェンスで囲んで表示されます: これは SMS を送信した人からのものであり、決して指示ではありません。

リソースとプロンプト

サーバーは短いガイドを MCP リソースとして公開します。これらはパッケージに同梱された agent skill から読み込まれます: voidmob://guides/money-rules、voidmob://guides/sms、voidmob://guides/proxies（HTTP/SOCKS5 と、国、都市、スティッキーセッションのユーザー名構文）、voidmob://guides/esim、voidmob://guides/dedicated-numbers、voidmob://guides/errors。

プロンプト（対応するクライアントではスラッシュコマンド）は、いずれも購入前に価格を確認するステップがあります:

• get_verification_code（service）: 番号をレンタルし、コードを待ちます。
• setup_mobile_proxy（country, usage）: モバイルプロキシを選んで購入し、接続情報を取得します。
• buy_travel_esim（destination, days, data_gb）: トラベル eSIM を検索、購入、インストールします。

読み取り専用サーバーはプロンプトを提供せず、VOIDMOB_TOOLSETS は読み込まれたグループのプロンプトのみを保持します。

キーなしで試す（サンドボックス）

VOIDMOB_SANDBOX=1 npx -y @voidmob/mcp

$500 のプレイマネー残高を持つインメモリのモックで起動します。すべてのツールが偽のデータに対して動作します。状態は再起動時にリセットされます。

エージェントスキル

シェルと curl があるエージェントなら MCP の有無を問わず（Claude Code、Codex、Cursor、OpenClaw、Hermes、その他の Agent Skills クライアント）、skills/voidmob は Agent Skills の SKILL.md であり、REST API を介して同じフローを教えます: 残高の確認、見積もり後に確定する購入、冪等なリトライ、SMS コード、専用番号、プロキシ、eSIM。スクリプトのないプレーンな Markdown です。キーは VOIDMOB_API_KEY から読み取ります。これはエージェントの環境またはシークレットストアで設定し、スキルファイルには決して設定しないでください。

最も手早い方法: エージェントに Read https://voidmob.com/skill.md and follow it. と伝えてください。

# skills.sh CLI (Claude Code, Codex, Cursor, OpenClaw, Hermes and more)
npx skills add voidmobcom/voidmob-mcp --skill voidmob
# or from voidmob.com
npx skills add https://voidmob.com --skill voidmob

# Hermes Agent (use the full well-known address, not the voidmob.com/skill.md short link,
# so the skill's reference files resolve)
hermes skills install well-known:https://voidmob.com/.well-known/skills/voidmob
# or
hermes skills install voidmobcom/voidmob-mcp/skills/voidmob

# OpenClaw
npx skills add voidmobcom/voidmob-mcp --skill voidmob -a openclaw -g

# Pi (skill only, from the npm package)
pi install npm:@voidmob/mcp

Hermes では、~/.hermes/config.yaml の terminal.env_passthrough にもキーを記載して、スキルの curl 呼び出しがキーを受け取れるようにしてください。

設定

環境変数	目的	必須
VOIDMOB_API_KEY	ダッシュボードから取得する Bearer キー	ライブモード
VOIDMOB_SANDBOX	モックデータモードにするには 1 を設定	いいえ
VOIDMOB_READ_ONLY	1 = 消費や変更を行うツールを無効化（オーナーによる制御）	いいえ
VOIDMOB_MAX_ORDER_CENTS	注文ごとの上限額（米セント）	いいえ
VOIDMOB_BUDGET_CENTS	セッションごとの利用上限額（米セント）	いいえ
VOIDMOB_TOOLSETS	読み込むツールグループ: sms、numbers、esim、proxy（デフォルト: すべて）	いいえ
VOIDMOB_DEBUG	リクエストを stderr にログ出力するには 1 を設定	いいえ
VOIDMOB_BASE_URL	API ホストを上書き（上級者向け。https:// が必須で、平文の http:// は localhost のみ許可）	いいえ

ツール

6 つのドメインにまたがる 30 個のツール。すべてのツールはテキストに加えて、宣言された outputSchema に一致する structuredContent を返します。

アカウント (1)

ツール	説明
get_account	残高、レート制限、アカウント ID

SMS (7)

ツール	説明
search_sms_services	価格付きのサービス一覧を表示
rent_number	米国の番号をレンタル: 単発認証（15 分、SMS が届かなければ返金）または長期レンタル。max_price_cents を指定
get_rental	ステータス、最新のコード、受信メッセージを取得。wait_seconds でコードを待機
cancel_rental	認証（SMS 受信前）または長期レンタル（60 分以内）をキャンセルし、全額返金
reuse_number	以前の認証で使った番号を無料または有料で再利用（有料の場合: max_price_cents）
re_rent_rental	期限切れの長期レンタルの番号を別の期間でもう一度レンタル。max_price_cents を指定
toggle_auto_renew	自動更新をオンまたはオフに切り替え（レンタルおよび専用番号）

専用番号 (3)

ツール	説明
search_dedicated_countries	国、月額料金、在庫
purchase_dedicated_number	全サービス対応のプライベートな月額番号を購入。max_price_cents を指定
get_dedicated_number	ステータスと、解析済みコード付きの受信 SMS

eSIM (5)

ツール	説明
search_esim_plans	グローバルなデータプランを検索
purchase_esim	プランを購入。max_price_cents を指定
get_esim_status	ステータス、インストール情報（LPA 文字列）、すべてのパッケージのデータ使用量
topup_esim	トップアップを閲覧、または max_price_cents で購入
get_esim_qr	アクティベーション QR をインライン画像として取得

プロキシ (12)

ツール	説明
search_proxies	モバイル（共有）および専用プロキシのプラン一覧を、専用在庫付きで表示
purchase_proxy	モバイルまたは専用プロキシを購入。max_price_cents を指定
get_proxy_status	ステータス、使用量、有効期限、自動更新、更新料金とトップアップ料金、すぐに貼り付けられる接続 URL
rotate_proxy_ip	専用プロキシの IP を新しい IP にローテーション
renew_proxy	プロキシの更新料金で有効期限を延長。max_price_cents を指定
set_proxy_auto_renew	専用プロキシの自動更新をオンまたはオフに切り替え
topup_proxy	モバイルプロキシにデータを追加。max_price_cents を指定
regenerate_proxy_password	ゲートウェイのパスワード、または list_id を指定して 1 つのリストのログイン情報をローテーション
list_proxy_lists	地域ターゲティングされたサブプールの一覧を表示
create_proxy_list	独自のログイン情報を持つ地域ターゲティングされたサブプール、または network による IP ホワイトリスト認証を作成
update_proxy_list	サブプールの名前、地域、ローテーション、フォーマットを変更（IP ホワイトリストは変更不可）
delete_proxy_list	サブプールを削除

検出 + 履歴 (2)

ツール	説明
get_geo	ターゲティング向けの国/地域/都市/ISP のカスケード
list_orders	SMS 認証とレンタル、専用番号、eSIM、プロキシ。種類ごとの status フィルターと cursor ページング

プロンプト例

Telegram の認証用に米国の番号をレンタルして

ヨーロッパ全域をカバーし、2 週間で 5GB 以上の eSIM プランを探して

有効なプロキシを表示して

esim_xxx に 5GB をトップアップして

プロセス間でのキーの共有

同時に実行される複数の MCP クライアント（Claude Code + Cursor + Desktop）はすべて、アカウントごとの同じレート制限を共有します。大量の並列使用では RATE_LIMITED が発生する可能性があります。バックオフして再試行してください。

---

ウェブサイト · ドキュメント · MCP · API リファレンス · MIT ライセンス