VoidMob MCP server
Give Claude Code, Codex, Cursor or any MCP client that runs local servers real US numbers for SMS codes, eSIM data plans and mobile proxies by country. Its 30 tools quote before they buy and spend from one prepaid balance.
Terminal
Editor
Desktop app
No MCP
$ claude mcp add voidmob -s user -e VOIDMOB_API_KEY=vmk_live_... -- npx -y @voidmob/mcpThen ask your agent
What's my VoidMob balance?A number back means the key and the install both work. It calls get_account, which is free.
-s user makes the server available in every project. The key goes after -e and before the double dash.
30 tools, one service at a time
Search, status and history tools are free to call. Tools marked with a dot charge your balance: each takes the price you approved and is annotated as spending, so your client can ask you before it runs.
Charges your balance; the rest are free to call
search_sms_servicesFind a service and its live price for a US non-VoIP numberrent_numberBuy a one-time verification number or a long-term rentalget_rentalWait up to two minutes for the code, or read every message receivedreuse_numberGet another code on an earlier verification number, free or paidcancel_rentalCancel a verification before any SMS, or a rental within its first hour, for a full refundre_rent_rentalRent an expired rental number againtoggle_auto_renewTurn auto-renew on or off for a rental or dedicated numbersearch_dedicated_countriesList countries with a monthly price and stockpurchase_dedicated_numberBuy a private monthly number that receives SMS from any serviceget_dedicated_numberRead its status and the messages it receivedsearch_proxiesCompare shared per-GB plans and dedicated devices by countrypurchase_proxyBuy a planget_proxy_statusRead usage, expiry and ready-to-paste connection detailsget_geoWalk countries, regions, cities and carriers with live nodescreate_proxy_listMake a geo-targeted list with its own login, or IP-whitelist authupdate_proxy_listChange a list's name, location, rotation or formatlist_proxy_listsSee the lists on a shared plandelete_proxy_listRemove a list; its login stops working at oncerotate_proxy_ipForce a new IP on a dedicated device, once a minute at mosttopup_proxyAdd GB to a shared planrenew_proxyExtend a plan by one more periodset_proxy_auto_renewTurn auto-renew on or off for a dedicated deviceregenerate_proxy_passwordReset the gateway password or one list's loginsearch_esim_plansFind plans by country or region: data, validity, 5G, pricepurchase_esimBuy a planget_esim_qrShow the QR code to scan on your phoneget_esim_statusRead install details (LPA string), expiry and data usedtopup_esimList or buy more data for an installed eSIMget_accountCheck the balance and any spend limits the owner setlist_ordersPage through orders across every service, filtered by statusWhat a session looks like
Every purchase runs the same four beats: the agent quotes, you say yes, it buys with your approved price as the ceiling, and the result lands in the chat.
A US non-VoIP number for Discord is $0.15. It stays open 15 minutes, and if no SMS arrives the $0.15 goes back to your balance. Rent it?
Your Discord verification code is 482913
That's your code. More codes can arrive on this number until it expires.
Checks before every charge
Two checks always run at VoidMob: the price you approved and your balance. Two more run inside your MCP server when you set them. A refusal at any of them charges nothing.
Per-order limitIn your MCP server, when set
VOIDMOB_MAX_ORDER_CENTS=2500
$6.99 is under the $25.00 limit (passed)
Session budgetIn your MCP server, when set
VOIDMOB_BUDGET_CENTS=5000
$6.99 of $50.00 left (passed)
Price you approvedAt VoidMob, always
max_price_cents
Live $6.99, approved $6.99 (passed)
Your balanceAt VoidMob, always
prepaid, topped up by you
$42.10 covers it (passed)
No SMS, no charge
A verification number stays open 15 minutes. If no SMS arrives, the price returns to the balance automatically, except on services marked non-refundable.
Keys you can pull
A key has no spend cap of its own, so give each agent its own and revoke it on the API Keys page whenever you like. It stops working at once.
Prompts and guides
Clients that support MCP prompts list these as commands. Each walks through a purchase with a confirm-the-price step, and the guides give the agent VoidMob's rules before it starts.
get_verification_code service
Rents a US number for the service and waits for the code.
setup_mobile_proxy country, usage
Picks and buys a mobile proxy and returns the connection details.
buy_travel_esim destination, days, data_gb
Finds, buys and installs a travel eSIM.
Guides as MCP resources: voidmob://guides/ money-rules, sms, proxies, esim, dedicated-numbers, errors. To wait for a code, get_rental takes wait_seconds (up to 120) and returns as soon as the SMS lands.
Agent runtimes with a setup guide
Each guide copies its steps from the runtime's own documentation. For what agents do with all this, see VoidMob for AI agents.
No MCP? The skill and the API
Agents that can run curl but not an MCP server get the same purchases through the agent skill, and your own code gets them through the REST API.
Agent skill
A SKILL.md in the Agent Skills format that teaches the agent the purchase flows over the REST API, with quote-then-confirm and safe retries. It reads VOIDMOB_API_KEY from the environment and has no sandbox.
Tell the agent
Read https:Or install it
npx skills add voidmobcom/REST API
Every tool maps to an endpoint under one base URL, authenticated with the same key as a bearer token. Purchases take an Idempotency-Key so a retried request never buys twice.
Base URL
https:Connect your agent
Create an API key, top it up with crypto and paste it into your client's config above. Or switch the console to Sandbox and try every tool on play money first.
Frequently Asked Questions
Common questions about the VoidMob MCP server.
VOIDMOB_MAX_ORDER_CENTS refuses any single purchase above a limit, VOIDMOB_BUDGET_CENTS caps what one server session can spend, and VOIDMOB_READ_ONLY=1 removes every tool that spends. A refused purchase charges nothing, and get_account shows the limits in force. The budget resets when the server restarts.VOIDMOB_SANDBOX=1 instead of a key and every tool runs on in-memory mock data with a play-money balance. Switch the console above to Sandbox for the exact line in your client.