Voidmob MCP README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Voidmob MCP listing page.
VoidMob MCP
Mobile proxies, non-VoIP SMS verifications, dedicated numbers, and global eSIMs - exposed as 28 tools your AI agent can call directly.
Setup
- Generate an API key at https://dashboard.voidmob.com/developers/api-keys (keys are 32-char secrets prefixed
vmk_live_). - Add the MCP to your client (snippets below). Provide the key as
VOIDMOB_API_KEY.
Claude Code
Cursor
Add to ~/.cursor/mcp.json:
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\claude_desktop_config.json (Windows), or ~/.config/Claude/claude_desktop_config.json (Linux):
Try without a key (sandbox)
Boots in-memory mocks with a $500 play-money balance. Every tool works against fake data. State resets on restart.
Configuration
| Env var | Purpose | Required |
|---|---|---|
VOIDMOB_API_KEY | Bearer key from the dashboard | Live mode |
VOIDMOB_SANDBOX | Set to 1 for mock-data mode | No |
VOIDMOB_DEBUG | Set to 1 to log requests to stderr | No |
VOIDMOB_BASE_URL | Override API host (advanced) | No |
Tools
28 tools across six domains.
Account (1)
| Tool | Description |
|---|---|
get_account | Balance, rate limits, and account id |
SMS (7)
| Tool | Description |
|---|---|
search_sms_services | List services with prices |
rent_number | Rent a US number (verification / long-term rental) |
get_rental | Read status and received messages |
cancel_rental | Cancel a verification or long-term rental |
reuse_number | Free or paid reuse of a completed verification |
re_rent_rental | Extend a long-term rental for another period |
toggle_auto_renew | Turn auto-renewal on or off (rentals and dedicated numbers) |
Dedicated numbers (3)
| Tool | Description |
|---|---|
search_dedicated_countries | Countries, monthly prices, and stock |
purchase_dedicated_number | Buy a private all-services monthly number |
get_dedicated_number | Status and received SMS with parsed codes |
eSIM (5)
| Tool | Description |
|---|---|
search_esim_plans | Find global data plans |
purchase_esim | Buy a plan |
get_esim_status | Status and data usage |
topup_esim | Browse and buy top-ups |
get_esim_qr | Fetch the activation QR as an inline image |
Proxy (10)
| Tool | Description |
|---|---|
search_proxies | List available mobile proxy plans |
purchase_proxy | Buy a mobile proxy |
get_proxy_status | Status, usage, and gateway credentials |
rotate_proxy_ip | Rotate a dedicated proxy to a new IP |
renew_proxy | Extend expiry |
topup_proxy | Add data |
regenerate_proxy_password | Rotate the gateway password |
list_proxy_lists | List geo-targeted sub-pools |
create_proxy_list | Create a geo-targeted sub-pool |
delete_proxy_list | Remove a sub-pool |
Discovery + history (2)
| Tool | Description |
|---|---|
get_geo | Cascading country/region/city/ISP for targeting |
list_orders | Active SMS / dedicated number / eSIM / proxy orders |
Example prompts
Rent me a US number for Telegram verification
Find an eSIM plan that covers all of Europe with at least 5GB for two weeks
Show me my active proxies
Top up esim_xxx with 5GB
Sharing a key across processes
Multiple MCP clients running simultaneously (Claude Code + Cursor + Desktop) all share the same per-account rate limit. Heavy parallel usage may hit RATE_LIMITED; back off and retry.
Website · Docs · MCP · API reference · MIT License