VoidMob MCP

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

npx -y @voidmob/mcp

Quick Start

Add VoidMob to your MCP client. No auth, no config, no API key.

Claude Code

claude mcp add voidmob -- npx -y @voidmob/mcp

Cursor

Add to ~/.cursor/mcp.json:

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

Claude Desktop

Add to your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Restart your client. You now have 23 tools for mobile proxies, SMS verification, eSIM, and wallet operations.

Available Tools

Mobile Proxies (8 tools)

| Tool | Description | |------|-------------| | search_proxies | Search mobile proxy products by country or type (shared, dedicated standard, dedicated premium) | | purchase_proxy | Purchase a mobile proxy and get connection credentials | | get_proxy_status | Check bandwidth usage, connection details, and IP | | rotate_proxy | Rotate to a new IP address (dedicated proxies only) | | get_proxy_lists | Get geo-targeted proxy lists for a shared proxy | | create_proxy_list | Create a new proxy list with location targeting | | get_openvpn_config | Get OpenVPN configuration file for a dedicated proxy | | get_vless_config | Get VLESS connection URI for a dedicated premium proxy |

SMS - US Non-VoIP (7 tools)

| Tool | Description | |------|-------------| | search_sms_services | Search US non-VoIP SMS services with verification, rental, and dedicated pricing | | get_sms_price | Get all pricing tiers for a specific service | | rent_number | Rent a US number - verification (20min), long-term rental (3-30 days), or dedicated (28 days) | | get_messages | Check for incoming SMS messages on a rented number | | cancel_rental | Cancel a rental (full refund for verification with no messages) | | reuse_number | Reuse a completed number to receive another SMS | | toggle_auto_renew | Toggle auto-renewal for long-term rentals and dedicated numbers |

eSIM (5 tools)

| Tool | Description | |------|-------------| | search_esim_plans | Search eSIM data plans by country, data amount, duration, or features (5G, hotspot) | | get_esim_plan_details | Get full plan details including network type, speed, and activation policy | | purchase_esim | Purchase an eSIM plan and get QR code, activation code, and ICCID | | get_esim_usage | Check data usage and remaining balance for an active eSIM | | topup_esim | Browse available top-up products or purchase a top-up for an active eSIM |

Wallet (2 tools)

| Tool | Description | |------|-------------| | get_balance | Get wallet balance in USD and cents | | deposit | Create a crypto deposit (BTC, ETH, SOL, USDT, USDC, LTC, DOGE) |

General (1 tool)

| Tool | Description | |------|-------------| | list_orders | List all orders across SMS, eSIM, and proxy services with filtering |

Example Conversations

These are things you can ask Claude, Cursor, or any MCP client after adding VoidMob:

Set up a dedicated US mobile proxy and give me the credentials

Rotate my US dedicated proxy IP

Create a US-only proxy list on my shared proxy

Get the OpenVPN config for my US dedicated proxy

What VLESS connection options do I have for my premium proxy?

Rent me a dedicated US phone number that receives from all services

Set up a 7-day WhatsApp rental with auto-renew

Check if my verification code arrived

Find eSIM plans that cover all of Europe with at least 5GB

Find the cheapest eSIM plan for 2 weeks in Japan with at least 5GB

Top up my Japan eSIM with more data

Show me all my active orders

Sandbox Mode

VoidMob MCP currently runs in sandbox mode. All 23 tools work, but the data is mock.

• $50 starting balance - enough to try every tool
• Stateful - renting a number deducts balance, messages appear after a few seconds, deposits auto-confirm
• Deposits auto-confirm in ~5 seconds
• State resets on server restart
• No auth required - zero config, just npx -y @voidmob/mcp

The sandbox is designed to let you explore the full flow: deposit funds, rent a number, receive a verification code, check your balance. Everything behaves like the real API, just with mock data underneath.

API Access

Currently in sandbox mode. Join the waitlist at voidmob.com for early API access.