Voidmob Mcp

VoidMob MCP

[](https://www.npmjs.com/package/@voidmob/mcp) [](LICENSE) [](https://nodejs.org)

Mobile proxies, non-VoIP SMS verifications, dedicated numbers, and global eSIMs - exposed as 28 tools your AI agent can call directly.

npx -y @voidmob/mcp

Setup

1. Generate an API key at https://dashboard.voidmob.com/developers/api-keys (keys are 32-char secrets prefixed vmk_live_).
2. Add the MCP to your client (snippets below). Provide the key as VOIDMOB_API_KEY.

Claude Code

claude mcp add voidmob -- env VOIDMOB_API_KEY=vmk_live_... npx -y @voidmob/mcp

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "voidmob": {
      "command": "npx",
      "args": ["-y", "@voidmob/mcp"],
      "env": { "VOIDMOB_API_KEY": "vmk_live_..." }
    }
  }
}

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):

{
  "mcpServers": {
    "voidmob": {
      "command": "npx",
      "args": ["-y", "@voidmob/mcp"],
      "env": { "VOIDMOB_API_KEY": "vmk_live_..." }
    }
  }
}

Try without a key (sandbox)

VOIDMOB_SANDBOX=1 npx -y @voidmob/mcp

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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: voidmobcom
• Source: voidmobcom/voidmob-mcp
• License: MIT
• Homepage: https://voidmob.com

Install and usage instructions live in the source repository linked above.