Voidmob MCP Server

by voidmobcomio.github.voidmobcom/voidmob-mcpv1.2.1

Mobile proxies, non-VoIP SMS verifications, dedicated numbers, and global eSIMs for AI agents and MCP clients.

28Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active8d ago

Install Voidmob MCP server

claude mcp add voidmob -e VOIDMOB_API_KEY='<voidmob-api-key>' -- npx -y @voidmob/mcp

{
  "mcpServers": {
    "voidmob": {
      "command": "npx",
      "args": [
        "-y",
        "@voidmob/mcp"
      ],
      "env": {
        "VOIDMOB_API_KEY": "<voidmob-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "voidmob": {
      "command": "npx",
      "args": [
        "-y",
        "@voidmob/mcp"
      ],
      "env": {
        "VOIDMOB_API_KEY": "<voidmob-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "voidmob": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@voidmob/mcp"
      ],
      "env": {
        "VOIDMOB_API_KEY": "<voidmob-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "voidmob": {
      "command": "npx",
      "args": [
        "-y",
        "@voidmob/mcp"
      ],
      "env": {
        "VOIDMOB_API_KEY": "<voidmob-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
VOIDMOB_API_KEY	—	yes	API key from https://dashboard.voidmob.com/developers/api-keys (vmk_live_...). Needed for real purchases; without it tools are listed but every call returns setup instructions.
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 refused.
VOIDMOB_TOOLSETS	—	—	Comma list of tool groups to load: sms, numbers, esim, proxy (account, orders and geo tools are always on). Default: all.

Freshness

Active — last maintenance signal 8d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-01 · 8d ago · GitHub
Latest release
2026-10-01 · 8d ago · GitHub · v1.2.1
Package published
no data · npm/PyPI
Registry entry updated
2026-10-01 · 8d ago · official registry · v1.2.1

FAQ

›How do I install the Voidmob MCP server in Claude Code?

Run: claude mcp add voidmob -e VOIDMOB_API_KEY='<voidmob-api-key>' -- npx -y @voidmob/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Voidmob require an API key?

Yes. It expects VOIDMOB_API_KEY, of which 1 is a secret.

›Can I use Voidmob as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Voidmob in the official MCP registry?

Yes, as io.github.voidmobcom/voidmob-mcp.