{
  "markdown": "# VoidMob MCP\n\n[![npm version](https://img.shields.io/npm/v/@voidmob/mcp)](https://www.npmjs.com/package/@voidmob/mcp)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)\n[![Node](https://img.shields.io/node/v/@voidmob/mcp)](https://nodejs.org)\n\nMobile proxies, non-VoIP SMS verifications, dedicated numbers, and global eSIMs - exposed as 28 tools your AI agent can call directly.\n\n```bash\nnpx -y @voidmob/mcp\n```\n\n## Setup\n\n1. Generate an API key at https://dashboard.voidmob.com/developers/api-keys (keys are 32-char secrets prefixed `vmk_live_`).\n2. Add the MCP to your client (snippets below). Provide the key as `VOIDMOB_API_KEY`.\n\n### Claude Code\n\n```bash\nclaude mcp add voidmob -- env VOIDMOB_API_KEY=vmk_live_... npx -y @voidmob/mcp\n```\n\n### Cursor\n\nAdd to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"voidmob\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@voidmob/mcp\"],\n      \"env\": { \"VOIDMOB_API_KEY\": \"vmk_live_...\" }\n    }\n  }\n}\n```\n\n### Claude Desktop\n\nAdd 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):\n\n```json\n{\n  \"mcpServers\": {\n    \"voidmob\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@voidmob/mcp\"],\n      \"env\": { \"VOIDMOB_API_KEY\": \"vmk_live_...\" }\n    }\n  }\n}\n```\n\n## Try without a key (sandbox)\n\n```bash\nVOIDMOB_SANDBOX=1 npx -y @voidmob/mcp\n```\n\nBoots in-memory mocks with a $500 play-money balance. Every tool works against fake data. State resets on restart.\n\n## Configuration\n\n| Env var | Purpose | Required |\n|---|---|---|\n| `VOIDMOB_API_KEY` | Bearer key from the dashboard | Live mode |\n| `VOIDMOB_SANDBOX` | Set to `1` for mock-data mode | No |\n| `VOIDMOB_DEBUG` | Set to `1` to log requests to stderr | No |\n| `VOIDMOB_BASE_URL` | Override API host (advanced) | No |\n\n## Tools\n\n28 tools across six domains.\n\n### Account (1)\n\n| Tool | Description |\n|---|---|\n| `get_account` | Balance, rate limits, and account id |\n\n### SMS (7)\n\n| Tool | Description |\n|---|---|\n| `search_sms_services` | List services with prices |\n| `rent_number` | Rent a US number (verification / long-term rental) |\n| `get_rental` | Read status and received messages |\n| `cancel_rental` | Cancel a verification or long-term rental |\n| `reuse_number` | Free or paid reuse of a completed verification |\n| `re_rent_rental` | Extend a long-term rental for another period |\n| `toggle_auto_renew` | Turn auto-renewal on or off (rentals and dedicated numbers) |\n\n### Dedicated numbers (3)\n\n| Tool | Description |\n|---|---|\n| `search_dedicated_countries` | Countries, monthly prices, and stock |\n| `purchase_dedicated_number` | Buy a private all-services monthly number |\n| `get_dedicated_number` | Status and received SMS with parsed codes |\n\n### eSIM (5)\n\n| Tool | Description |\n|---|---|\n| `search_esim_plans` | Find global data plans |\n| `purchase_esim` | Buy a plan |\n| `get_esim_status` | Status and data usage |\n| `topup_esim` | Browse and buy top-ups |\n| `get_esim_qr` | Fetch the activation QR as an inline image |\n\n### Proxy (10)\n\n| Tool | Description |\n|---|---|\n| `search_proxies` | List available mobile proxy plans |\n| `purchase_proxy` | Buy a mobile proxy |\n| `get_proxy_status` | Status, usage, and gateway credentials |\n| `rotate_proxy_ip` | Rotate a dedicated proxy to a new IP |\n| `renew_proxy` | Extend expiry |\n| `topup_proxy` | Add data |\n| `regenerate_proxy_password` | Rotate the gateway password |\n| `list_proxy_lists` | List geo-targeted sub-pools |\n| `create_proxy_list` | Create a geo-targeted sub-pool |\n| `delete_proxy_list` | Remove a sub-pool |\n\n### Discovery + history (2)\n\n| Tool | Description |\n|---|---|\n| `get_geo` | Cascading country/region/city/ISP for targeting |\n| `list_orders` | Active SMS / dedicated number / eSIM / proxy orders |\n\n## Example prompts\n\n> Rent me a US number for Telegram verification\n\n> Find an eSIM plan that covers all of Europe with at least 5GB for two weeks\n\n> Show me my active proxies\n\n> Top up esim_xxx with 5GB\n\n## Sharing a key across processes\n\nMultiple 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.\n\n---\n\n<p align=\"center\">\n  <a href=\"https://voidmob.com\">Website</a> · <a href=\"https://voidmob.com/docs\">Docs</a> · <a href=\"https://voidmob.com/mcp\">MCP</a> · <a href=\"https://dashboard.voidmob.com/api-reference\">API reference</a> · MIT License\n</p>\n",
  "bytes": 4540,
  "sha": "addc82d526a3afb2cf564ecb1eddcb2f5da81a0d66af80875c3063f2f76a1e3a",
  "repo_slug": "voidmobcom/voidmob-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_voidmobcom_voidmob_mcp_52e64861/readme"
}