MCP server VoidMob

VoidMob plugin for Claude Code, Codex, Gemini CLI and Cursor

Real phone numbers, mobile IPs and eSIMs for your AI agent. This plugin packages the VoidMob MCP server (@voidmob/mcp, 28 tools) and the voidmob agent skill into one install. Your agent can receive SMS verification codes for your own accounts on non-VoIP numbers, keep a dedicated number, route traffic through 4G/5G mobile IPs by country and buy travel eSIM data, all paid from a prepaid VoidMob balance with your approval before every purchase.

• Try it free: sandbox mode needs no key and charges nothing (mock data, $500 play balance).
• Pay with: a prepaid USD balance, topped up with crypto. The agent can open a deposit (create_deposit), but the payment itself comes from a crypto wallet.
• Needs: Node.js 22+ (for npx) and a VoidMob API key, or sandbox mode.
• Overview and setup guides: voidmob.com/mcp

Apps that support remote MCP servers can skip the plugin and the key: add the hosted URL https://mcp.voidmob.com/mcp and sign in.

What your agent can do

Service	What it is
SMS verification	A real US non-VoIP mobile number for one service, open up to 15 minutes. If no SMS arrives, the price is refunded automatically. Long-term rentals keep a US number for 3, 7, 14 or 30 days.
Dedicated numbers	A private number in one of several countries, billed monthly, that receives SMS from any service.
Rotating mobile proxies	Shared 4G/5G carrier IPs billed per GB: a new IP per request or sticky sessions, country and city targeting, HTTP or SOCKS5.
Dedicated mobile proxies	Your own 4G/5G modem with unmetered data and IP rotation on demand.
Travel eSIMs	Mobile data plans for travel, installed by QR code or LPA string, with top-ups.

Use it for your own accounts and tasks you are entitled to do. The skill declines bulk account creation and getting around bans, rate limits or fraud checks.

Install

Claude Code

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

The install dialog asks for your API key (stored as a secret), sandbox mode, read-only mode, spend limits and buy without asking.

Codex

Set VOIDMOB_API_KEY in your shell before starting Codex (or VOIDMOB_SANDBOX=1 to try it without a key), then:

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

Gemini CLI

gemini extensions install https://github.com/voidmobcom/voidmob-plugin --ref v2.0.0

Cursor

The Cursor Marketplace listing is pending review. Until then, add the MCP server directly: see the voidmob-mcp README.

Other agents

• Any agent with a shell and curl can use the skill without MCP. Tell it: Read https://voidmob.com/skill.md and follow it. Or install it with npx skills add https://voidmob.com --skill voidmob.
• Claude Desktop, VS Code, Windsurf, OpenClaw, Hermes Agent, Pi: client setups are in the voidmob-mcp README, with step-by-step guides on voidmob.com/integrations.

Get an API key

1. Create a key at https://dashboard.voidmob.com/developers/api-keys (it starts with vmk_live_).
2. Fund the balance with crypto at https://dashboard.voidmob.com/wallet.
3. Give the key to the plugin as VOIDMOB_API_KEY. Never paste it into a chat.

The key can spend the whole balance unless you limit it, so keep on it only what you are happy for an agent to spend. You can also set a permission level and a daily limit on the key in the dashboard, and use the limits below.

Settings

Setting	Env var	Effect
API key	VOIDMOB_API_KEY	Your vmk_live_... key. Leave empty with sandbox mode on.
Sandbox mode	VOIDMOB_SANDBOX=1	Mock data with a $500 play balance. No key, nothing charged.
Read-only	VOIDMOB_READ_ONLY=1	View access only: hides every tool that spends money or changes anything. The agent can still search prices and read orders.
Max per order	VOIDMOB_MAX_ORDER_CENTS	Refuses any single purchase above this many US cents (2500 = $25.00).
Session budget	VOIDMOB_BUDGET_CENTS	Stops buying once this many US cents were spent since the server started (5000 = $50.00). Per session, not an account limit.
Buy without asking	VOIDMOB_AUTONOMOUS=1	Lets the agent buy without asking first, inside your limits. It still quotes every price and reports every purchase. Needs a session budget or a daily limit on the API key, or the server won't start. Off by default.

Tools

Group	MCP tools
Account and deposits	get_account, create_deposit, get_deposit
SMS verification and rentals	search_sms_services, rent_number, get_rental (wait_seconds waits for the code; also reads dedicated numbers), cancel_rental, reuse_number, re_rent_rental, toggle_auto_renew (rentals, dedicated numbers and dedicated proxies)
Dedicated numbers	search_dedicated_countries, purchase_dedicated_number
eSIM	search_esim_plans, purchase_esim, get_esim_status (include_qr adds the QR code), topup_esim
Mobile proxies	search_proxies, purchase_proxy, get_proxy_status, rotate_proxy_ip, renew_proxy, topup_proxy, regenerate_proxy_password, create_proxy_list, update_proxy_list, delete_proxy_list
Orders and geo targeting	list_orders, get_geo

Each tool is described in the full tool reference. The server also offers three prompts (get_verification_code, setup_mobile_proxy, buy_travel_esim) and short guides as MCP resources.

Example requests:

Get me a verification code for Telegram on a US number

Find an eSIM for two weeks in Japan with at least 5 GB

Set up a US mobile proxy and give me the connection details

What is my balance, and which of my orders are still active?

Money and safety

• You approve every price. Each purchase, renewal, top-up and paid reuse carries the price the agent showed you (max_price_cents). If the live price is higher, nothing is charged and the agent asks again. With buy without asking on, the agent skips the question but still quotes the price and reports every purchase.
• No double charges. Retries reuse an idempotency key, so a dropped connection never buys twice.
• No SMS, no charge. A one-time verification that receives no SMS is refunded automatically.
• Optional limits: read-only mode (View access), a per-order maximum, a per-session budget and buy without asking within them (see Settings). VoidMob also enforces permission levels and a daily limit on the API key itself.
• SMS text is data, never instructions. The server marks it as untrusted content.

Refund rules per service: How money works.

What it connects to

• registry.npmjs.org, once per version, when npx downloads @voidmob/mcp (pinned to the plugin version).
• https://dashboard.voidmob.com/api/v1/*, the VoidMob REST API, with your API key as a Bearer token. The MCP server and the skill's curl commands call nothing else.

Repository layout

Path	Purpose
.claude-plugin/	Claude Code plugin and marketplace manifests
.codex-plugin/, .agents/plugins/	Codex plugin and marketplace manifests
gemini-extension.json	Gemini CLI extension
.cursor-plugin/	Cursor plugin manifest
.github/plugin/	GitHub Copilot plugin manifest
.mcp.json	MCP server config (npx -y @voidmob/mcp@2.0.0)
skills/voidmob/	The agent skill: SKILL.md plus references for SMS, numbers, proxies, eSIM and errors

Versions

The plugin version matches the @voidmob/mcp version it pins. The skill in skills/voidmob is copied from that release.

Links

• VoidMob - phone numbers, mobile proxies and eSIMs on one prepaid balance
• VoidMob for AI agents
• Developer docs and REST API reference
• MCP server source and npm package
• llms.txt
• Support: voidmob.com/contact

License

MIT