# Voidmob MCP (MCP server)

> Voidmob MCP is an MCP server that adds messaging tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Mobile proxies, non-VoIP SMS verifications, dedicated numbers, and global eSIMs for AI agents. It has 28 GitHub stars, is released under the MIT license and runs locally with npx -y @voidmob/mcp.

Mobile proxies, non-VoIP SMS verifications, dedicated numbers, and global eSIMs - exposed as 30 tools your AI agent can call directly, plus short guides (resources) and guided prompts.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/voidmobcom/voidmob-mcp |
| GitHub stars | 28 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: @voidmob/mcp |
| Remote URL | none |
| Needs API key | yes |
| Official | yes |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Communication |
| Latest release | v1.2.1 (Oct 1, 2026) |
| Last commit | Oct 1, 2026 |
| MCP registry name | io.github.voidmobcom/voidmob-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "voidmob-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@voidmob/mcp"
      ],
      "env": {
        "VOIDMOB_API_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env VOIDMOB_API_KEY=your-value --transport stdio voidmob-mcp -- npx -y @voidmob/mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "voidmob-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@voidmob/mcp"
      ],
      "env": {
        "VOIDMOB_API_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "voidmob_api_key",
      "description": "VOIDMOB_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "voidmob-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@voidmob/mcp"
      ],
      "env": {
        "VOIDMOB_API_KEY": "${input:voidmob_api_key}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `VOIDMOB_API_KEY` (secret): API key from https://dashboard.voidmob.com/developers/api-keys (vmklive...). Needed for real purchases; without it tools are listed but every call returns…
- `VOIDMOB_SANDBOX`: Set 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_ONLY`: Set to 1 to hide every tool that spends money or changes anything (searches and reads stay available).
- `VOIDMOB_MAX_ORDER_CENTS`: Refuse any single purchase, renewal or top-up whose max price is above this many US cents (e.g. 2500 = $25).
- `VOIDMOB_BUDGET_CENTS`: Spend cap 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…
- `VOIDMOB_TOOLSETS`: Comma list of tool groups to load: sms, numbers, esim, proxy (account, orders and geo tools are always on). Default: all.

## Tools

- `get_account`: Balance, rate limits, and account id
- `search_sms_services`: List services with prices
- `rent_number`: Rent a US number: one-time verification (15 min, refunded if no SMS) or long-term rental; takes maxpricecents
- `get_rental`: Read status, the latest code and received messages; waitseconds waits for the code
- `cancel_rental`: Cancel a verification (before any SMS) or long-term rental (within 60 min), with a full refund
- `reuse_number`: Free or paid reuse of an earlier verification's number (paid: maxpricecents)
- `re_rent_rental`: Re-rent an expired long-term rental's number for another period; takes maxpricecents
- `toggle_auto_renew`: Turn auto-renewal on or off (rentals and dedicated numbers)
- `search_dedicated_countries`: Countries, monthly prices, and stock
- `purchase_dedicated_number`: Buy a private all-services monthly number; takes maxpricecents
- `get_dedicated_number`: Status and received SMS with parsed codes
- `search_esim_plans`: Find global data plans
- `purchase_esim`: Buy a plan; takes maxpricecents
- `get_esim_status`: Status, install details (LPA string) and data usage across all packages
- `topup_esim`: Browse top-ups, or buy one with maxpricecents
- `get_esim_qr`: Fetch the activation QR as an inline image
- `search_proxies`: List mobile (shared) and dedicated proxy plans, with dedicated stock
- `purchase_proxy`: Buy a mobile or dedicated proxy; takes maxpricecents
- `get_proxy_status`: Status, usage, expiry, auto-renew, renewal and top-up prices, ready-to-paste connection URLs
- `rotate_proxy_ip`: Rotate a dedicated proxy to a new IP
- `renew_proxy`: Extend expiry at the proxy's renewal price; takes maxpricecents
- `set_proxy_auto_renew`: Turn auto-renew on or off for a dedicated proxy
- `topup_proxy`: Add data to a mobile proxy; takes maxpricecents
- `regenerate_proxy_password`: Rotate the gateway password, or one list's login with listid
- `list_proxy_lists`: List geo-targeted sub-pools
- `create_proxy_list`: Create a geo-targeted sub-pool with its own login, or IP-whitelist auth with network
- `update_proxy_list`: Change a sub-pool's name, geo, rotation or format (the IP whitelist cannot change)
- `delete_proxy_list`: Remove a sub-pool
- `get_geo`: Cascading country/region/city/ISP for targeting
- `list_orders`: SMS verifications and rentals, dedicated numbers, eSIMs and proxies; per-kind status filter and cursor paging

## Similar MCP servers

- [Strata](https://appsgit.com/mcp-servers/strata): MCP server for progressive tool usage at any scale (see https://klavis.ai). (5,807 stars, Apache-2.0, official)
- [Vexa](https://appsgit.com/mcp-servers/vexa): Meeting bot and transcripts for Google Meet, Teams and Zoom. (2,856 stars, Apache-2.0, official, needs API key)
- [MCP Server for WinDbg Crash Analysis](https://appsgit.com/mcp-servers/mcp-server-for-windbg-crash-analysis): A Model Context Protocol server for Windows crash dump analysis using WinDbg/CDB. (1,607 stars, MIT)
- [Rocketmq Rust](https://appsgit.com/mcp-servers/rocketmq-rust): 🚀 Apache RocketMQ built in Rust 🦀 — faster, safer, and more memory-efficient. (1,524 stars, Apache-2.0)
- [Wassette](https://appsgit.com/mcp-servers/wassette): Wassette: A security-oriented runtime that runs WebAssembly Components via MCP. (957 stars, MIT, official)
- [Line Bot MCP Server](https://appsgit.com/mcp-servers/line-bot-mcp-server): MCP server that integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account. (783 stars, Apache-2.0, official, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/voidmob-mcp
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.