
Voidmob Mcp
Connects your AI agent to VoidMob's mobile infrastructure with 25 tools spanning SMS verification, eSIM data plans, and mobile proxies. You can rent US numbers for one-time verifications or long-term use, purchase global eSIM plans with data tracking and QR code generation, and buy mobile proxies with IP rotation and geo-targeted sub-pools. Includes a sandbox mode with mock data for testing without spending credits. Useful when your agent needs to verify accounts across services, provision connectivity in specific regions, or route requests through mobile IPs for testing or scraping workflows.
- GitHub stars
- 22
- tools
- 28
- auth
- Secret needed
- transport
- STDIO, HTTP
- env vars
- 7
- last updated
- Nov 5, 2026
Tools
28 toolsPublic tool metadata for what this MCP can expose to an agent.
get_accountBalance, rate limits, account id, and the access level and spending limits in force with a deposit link
Balance, rate limits, account id, and the access level and spending limits in force with a deposit link
No parameter schema in public metadata yet.
create_depositAdd funds with crypto: the exact amount, network, address and deadline to pay, and the payment window where you can check the address. Spends nothing
Add funds with crypto: the exact amount, network, address and deadline to pay, and the payment window where you can check the address. Spends nothing
No parameter schema in public metadata yet.
get_depositA deposit's status, how much more to send if it is underpaid, and what was credited; without an id, the coins with their minimums and the 5 newest deposits
A deposit's status, how much more to send if it is underpaid, and what was credited; without an id, the coins with their minimums and the 5 newest deposits
No parameter schema in public metadata yet.
search_sms_servicesList services with prices
List services with prices
No parameter schema in public metadata yet.
rent_numberRent a US number: one-time verification (15 min, refunded if no SMS) or long-term rental; takes max_price_cents
Rent a US number: one-time verification (15 min, refunded if no SMS) or long-term rental; takes max_price_cents
No parameter schema in public metadata yet.
get_rentalRead a verification, rental or dedicated number (ded_): status, the latest code and received messages; wait_seconds waits for a verification's code
Read a verification, rental or dedicated number (ded_): status, the latest code and received messages; wait_seconds waits for a verification's code
No parameter schema in public metadata yet.
cancel_rentalCancel a verification (before any SMS) or long-term rental (within 60 min), with a full refund
Cancel a verification (before any SMS) or long-term rental (within 60 min), with a full refund
No parameter schema in public metadata yet.
reuse_numberFree or paid reuse of an earlier verification's number (paid: max_price_cents)
Free or paid reuse of an earlier verification's number (paid: max_price_cents)
No parameter schema in public metadata yet.
re_rent_rentalRe-rent an expired long-term rental's number for another period; takes max_price_cents
Re-rent an expired long-term rental's number for another period; takes max_price_cents
No parameter schema in public metadata yet.
toggle_auto_renewTurn auto-renewal on or off for a rental, dedicated number or dedicated proxy (prx_)
Turn auto-renewal on or off for a rental, dedicated number or dedicated proxy (prx_)
No parameter schema in public metadata yet.
search_dedicated_countriesCountries, monthly prices, and stock
Countries, monthly prices, and stock
No parameter schema in public metadata yet.
purchase_dedicated_numberBuy a private all-services monthly number; takes max_price_cents
Buy a private all-services monthly number; takes max_price_cents
No parameter schema in public metadata yet.
search_esim_plansFind global data plans
Find global data plans
No parameter schema in public metadata yet.
purchase_esimBuy a plan; takes max_price_cents
Buy a plan; takes max_price_cents
No parameter schema in public metadata yet.
get_esim_statusStatus, install details (LPA string) and data usage across all packages; include_qr adds the activation QR as an inline image
Status, install details (LPA string) and data usage across all packages; include_qr adds the activation QR as an inline image
No parameter schema in public metadata yet.
topup_esimBrowse top-ups, or buy one with max_price_cents
Browse top-ups, or buy one with max_price_cents
No parameter schema in public metadata yet.
search_proxiesList mobile (shared) and dedicated proxy plans, with dedicated stock
List mobile (shared) and dedicated proxy plans, with dedicated stock
No parameter schema in public metadata yet.
purchase_proxyBuy a mobile or dedicated proxy; takes max_price_cents
Buy a mobile or dedicated proxy; takes max_price_cents
No parameter schema in public metadata yet.
get_proxy_statusStatus, usage, expiry, auto-renew, renewal and top-up prices, ready-to-paste connection URLs, and its geo-targeted lists
Status, usage, expiry, auto-renew, renewal and top-up prices, ready-to-paste connection URLs, and its geo-targeted lists
No parameter schema in public metadata yet.
rotate_proxy_ipRotate a dedicated proxy to a new IP
Rotate a dedicated proxy to a new IP
No parameter schema in public metadata yet.
renew_proxyExtend expiry at the proxy's renewal price; takes max_price_cents
Extend expiry at the proxy's renewal price; takes max_price_cents
No parameter schema in public metadata yet.
topup_proxyAdd data to a mobile proxy; takes max_price_cents
Add data to a mobile proxy; takes max_price_cents
No parameter schema in public metadata yet.
regenerate_proxy_passwordRotate the gateway password, or one list's login with list_id
Rotate the gateway password, or one list's login with list_id
No parameter schema in public metadata yet.
create_proxy_listCreate a geo-targeted sub-pool with its own login, or IP-whitelist auth with network
Create a geo-targeted sub-pool with its own login, or IP-whitelist auth with network
No parameter schema in public metadata yet.
update_proxy_listChange a sub-pool's name, geo, rotation or format (the IP whitelist cannot change)
Change a sub-pool's name, geo, rotation or format (the IP whitelist cannot change)
No parameter schema in public metadata yet.
delete_proxy_listRemove a sub-pool
Remove a sub-pool
No parameter schema in public metadata yet.
get_geoCascading country/region/city/ISP for targeting
Cascading country/region/city/ISP for targeting
No parameter schema in public metadata yet.
list_ordersSMS verifications and rentals, dedicated numbers, eSIMs and proxies; per-kind status filter and cursor paging
SMS verifications and rentals, dedicated numbers, eSIMs and proxies; per-kind status filter and cursor paging
No parameter schema in public metadata yet.
Sponsors
Configuration
VOIDMOB_API_KEYsecretAPI key from https://dashboard.voidmob.com/developers/api-keys (vmk_live_...). Needed for real purchases; without it tools are listed but every call returns setup instructions.
VOIDMOB_SANDBOXSet to 1 to use offline mock data with a $500 play balance instead of the live API (no key needed, nothing is charged).
VOIDMOB_READ_ONLYSet to 1 to hide every tool that spends money or changes anything (searches and reads stay available).
VOIDMOB_MAX_ORDER_CENTSRefuse any single purchase, renewal or top-up whose max price is above this many US cents (e.g. 2500 = $25).
VOIDMOB_BUDGET_CENTSSpending limit in US cents for this server process (a per-session safety net, not an account limit); purchases that would exceed it, and turning on auto-renew, are refused.
VOIDMOB_AUTONOMOUSSet to 1 to let the agent buy without asking first, within the limits. Needs VOIDMOB_BUDGET_CENTS or a daily limit on the API key; every limit still applies.
VOIDMOB_TOOLSETSComma list of tool groups to load: sms, numbers, esim, proxy (account, deposit, orders and geo tools are always on). Default: all.
Readme
VoidMob MCP
Real mobile infrastructure for AI agents: US non-VoIP numbers for SMS verification codes, private dedicated numbers, 4G/5G mobile proxies and travel eSIMs. 28 tools, paid from a prepaid USD balance, with permission levels and optional spending limits that VoidMob enforces on every purchase.
Details
- Repository
- github.com/voidmobcom/voidmob-mcp
- Website
- voidmob.com
- Categories
- Communication & Messaging, Mobile Development
- Package
@voidmob/mcp- Transport
- STDIO, HTTP
- Auth
- Required
- Registry
- MCP registry, active
