Skip to content
appsgit

Voidmob MCP

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.

github.com/voidmobcom/voidmob-mcp (opens in a new tab)

Install Voidmob MCP

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.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

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

Cursor

.cursor/mcp.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
{
  "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 Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

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

Tools (30)

Parsed from the Tools section of the README; check the repository for the current list.

  • 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

About 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.

  • mcp-server
  • agent-skills
  • agentic-ai
  • ai-agents
  • claude
  • claude-desktop
  • claude-skills
  • esim
  • mcp
  • mcpb

FAQ

Voidmob MCP FAQ

Still curious? Email info@appsgit.com.

What is Voidmob MCP?

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. The source code is at github.com/voidmobcom/voidmob-mcp.

How do I install the Voidmob MCP MCP server?

Add the command npx -y @voidmob/mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Voidmob MCP free?

The server is open source under the MIT license, so running it is free. It needs credentials (VOIDMOB_API_KEY) for the service it connects to, which may require a paid account.

Is Voidmob MCP actively maintained?

The most recent commit was on Oct 1, 2026. The latest release is v1.2.1, published Oct 1, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.