io.github.voidmobcom/voidmob-mcp
Mobile proxies, SMS verifications, and global eSIM data plans for AI agents.
Versions
0.1.1latestTools 28
search_dedicated_countries List countries where dedicated numbers are offered, with your monthly price and stock status. A dedicated number is a private number that receives SMS for ALL services, renews monthly, and stays yours until you stop renewing.
purchase_dedicated_number Buy a dedicated monthly number in a country from search_dedicated_countries. Quote-then-commit: the tool fetches your live price and ties max_price_cents to it so you never pay above the quote. Returns a ded_xxx id - poll get_dedicated_number to read incoming SMS.
get_dedicated_number Read a dedicated number
get_account Get the authenticated account: id, USD wallet balance, and per-endpoint-group rate limits. Use this before money-touching tool calls to confirm sufficient funds.
search_proxies Search available mobile proxy plans (shared rotating mobile IPs, billed by data). Each result includes the plan id, location, data allowance, duration, and price. Region/city/ISP targeting is configured per list after purchase via create_proxy_list.
purchase_proxy Purchase a proxy plan. Returns 202 Accepted with status=provisioning; the gateway becomes active in 1-2 minutes. Poll get_proxy_status until status=
get_proxy_status Read a proxy
rotate_proxy_ip Rotate a dedicated proxy to a new IP. Shared proxies rotate per-request through their lists - use create_proxy_list / list_proxy_lists instead.
renew_proxy Extend a proxy
topup_proxy Add more data to a shared proxy plan. Quote-then-commit: derives per-GB price from the proxy
regenerate_proxy_password Rotate the main proxy gateway password. Returns the new credentials.
list_proxy_lists List proxy lists for a shared proxy (geo-targeted sub-pools that share the proxy
create_proxy_list Create a new geo-targeted proxy list on a shared proxy. Provide either a single country (with optional region/city/isp/zip subfilters) or a countries array (2-30, mutually exclusive with the subfilters). To edit an existing list, delete it and create a new one.
delete_proxy_list Delete a proxy list. The list
search_sms_services Search available US non-VoIP SMS services with prices per row. Returns each service
get_rental Read a rental
rent_number Rent a US non-VoIP phone number. kind=
cancel_rental Cancel a rental. For verifications (ver_xxx) the API may refund if no message arrived. For long-term rentals (ren_xxx) cancellation is typically non-refundable - check the response.
reuse_number Reuse a completed/expired verification to receive another SMS. Free reuse is available when allow_reuse is true on the verification. Paid reuse ($0.50) is available when allow_paid_reuse is true.
re_rent_rental Re-rent the same number for another period at the current price. Only works on an expired rental whose re_rent_available is true (the provider has not yet released the number). Re-uses the rental
toggle_auto_renew Turn auto-renewal on/off for a long-term rental (ren_xxx) or a dedicated number (ded_xxx).
get_geo Cascading geo discovery for proxy list targeting. No params -> countries; country=US -> regions; country=US®ion=California -> cities; +city=Los%20Angeles -> ISPs.
list_orders List the user
search_esim_plans Search global eSIM data plans. Each result includes the full plan shape (countries, region, data limit, validity, routing location, 5G/hotspot/calls/SMS/topup features) so a separate plan-details tool is unnecessary.
purchase_esim Purchase an eSIM plan. Quote-then-commit: the tool fetches the live price and ties max_price_cents to it so you never pay above what you saw.
get_esim_status Read an eSIM
topup_esim Browse top-up products (omit topup_product_id) or purchase a specific top-up (supply topup_product_id) for an active eSIM.
get_esim_qr Fetch the activation QR code for an eSIM as an image. Most MCP clients render the image inline so the user can scan it directly.
Permissions 2
network medium env_vars low