Model Context ProtocolLive in Productionv1.0.0

Mobile Proxies, SMS & eSIMs for AI Agents

Open-source MCP server with 25 tools that give AI agents direct access to mobile proxies, US non-VoIP SMS verification, and global eSIM data plans. Works with Claude Code, Claude Desktop, Cursor, and any MCP-compatible client.

$ npx -y @voidmob/mcp

Get your API key GitHub npmMIT License

Quick Start

Generate an API key, drop it into your MCP client config, and your agent can call all 25 tools. One command for Claude Code, a small JSON block for everything else.

1. Get your API key

Create a key at dashboard.voidmob.com/developers/api-keys. Keys look like vmk_live_... and authenticate every request.

2. Claude Code

$ claude mcp add voidmob -- env VOIDMOB_API_KEY=vmk_live_... npx -y @voidmob/mcp

Claude Desktop

Add to claude_desktop_config.json:

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

Cursor

Add to .cursor/mcp.json:

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

Want to test first? Set VOIDMOB_SANDBOX=1 to run every tool against in-memory mock data with a $500 play-money balance, no API key required. Requires Node 22 or newer.

25 Tools, 5 Categories

Every tool your AI agent needs to work with mobile infrastructure, from searching and pricing to purchasing, monitoring, and managing.

Mobile Proxies

10 tools - Pay-per-GB and dedicated monthly options

search_proxies

List available mobile proxy plans

purchase_proxy

Buy a mobile proxy and get credentials

get_proxy_status

Status, usage, and gateway credentials

rotate_proxy_ip

Rotate a dedicated proxy to a new IP

renew_proxy

Extend a proxy's expiry

topup_proxy

Add data to an active proxy

regenerate_proxy_password

Rotate the gateway password

list_proxy_lists

List geo-targeted sub-pools

create_proxy_list

Create a geo-targeted sub-pool

delete_proxy_list

Remove a sub-pool

US Non-VoIP SMS

7 tools - Real US numbers for verification

search_sms_services

List services with live prices

rent_number

Rent a US number (verification, rental, or dedicated)

get_rental

Read status and received messages

cancel_rental

Cancel a verification or long-term rental

reuse_number

Free or paid reuse of a completed verification

re_rent_rental

Extend a long-term rental for another period

toggle_auto_renew

Turn auto-renewal on or off

Global eSIM Plans

5 tools - Data plans across 100+ countries

search_esim_plans

Find global data plans

purchase_esim

Buy a plan

get_esim_status

Status and data usage

topup_esim

Browse and buy top-ups

get_esim_qr

Fetch the activation QR as an inline image

Account

1 tool

get_account

Balance, rate limits, and account ID

Discovery & History

2 tools

get_geo

Cascading country/region/city/ISP for targeting

list_orders

Active SMS, eSIM, and proxy orders

How It Works

Agent Workflow Example

1.Agent needs to verify an account

2.Calls purchase_proxy → gets mobile IP

3.Calls rent_number → gets US number

4.Completes signup form via proxy

5.Calls get_rental → reads the verification code

6.Verifies account → done

Developer Experience

One command to add VoidMob to your MCP client

Optional sandbox mode for testing against mock data

25 tools auto-discovered by your AI agent

No API client code - agents call tools directly

Fund your wallet with crypto on the dashboard (BTC, ETH, SOL, USDT, USDC, LTC)

Pay-per-use - only pay for what agents consume

Open Source

MIT licensed. Review the code, open issues, submit PRs, or fork it. Built with the official MCP SDK and Zod validation.

View on GitHub

Standard Protocol

Built on Anthropic's MCP specification with @modelcontextprotocol/sdk. Compatible with Claude, Cursor, and any MCP-supporting client.

What is Model Context Protocol?

Model Context Protocol (MCP) is an open standard developed by Anthropic for connecting AI agents to external tools and data sources. Think of it as a universal adapter that lets AI systems like Claude request services, read files, query databases, or interact with APIs - all through a standardized interface.

Why MCP Matters for AI Agents

Zero-friction integration

Agents discover and use tools automatically

Standardized interface

One protocol, unlimited service providers

Autonomous workflows

Agents request services without manual API coding

Composable tooling

Mix and match services from different providers

For developers, MCP eliminates repetitive integration work. Instead of writing custom API clients for every service your AI agent needs, you configure MCP servers once and agents can discover capabilities on their own. For AI agents, MCP provides a structured way to access external functionality that wasn't part of their training data.

Future: x402 Micropayments

Autonomous Payments for Autonomous Agents

We're exploring x402 payment integration for VoidMob's MCP server. This would enable AI agents to pay for services automatically using Lightning Network micropayments - no API keys, no accounts, no subscriptions.

Agent requests service

Calls MCP tool → receives payment invoice

Automatic payment

Agent's Lightning wallet pays invoice instantly (under 1 second)

Service delivered

Payment verified → proxy/SMS credentials returned immediately

Why this matters:Agents don't need pre-funded accounts or API keys. They pay only when requesting services, just like handing cash to a vending machine. Complete privacy, zero friction, perfect for autonomous systems.

Learn more about x402 payments

What Developers Are Building

Testing Automation

AI agents that test signup flows, verification systems, and geo-restrictions automatically

“Claude, test our SMS verification flow from 10 different countries” → Agent uses MCP to provision numbers and proxies, completes tests, reports results

Account Management

Agents that create and maintain multiple accounts for legitimate business use cases

E-commerce sellers managing marketplace accounts, social media managers handling client profiles, QA teams maintaining test accounts

Research & Analysis

Data collection agents that gather publicly available information through real mobile IPs

Market research, competitive analysis, price monitoring - agents use real carrier IPs to appear as legitimate mobile users

Privacy Workflows

Agents that help users maintain digital privacy and anonymity

Creating anonymous accounts, testing privacy tools, verifying services work without revealing personal information

Frequently Asked Questions

Do I need an API key to use the VoidMob MCP server?

Yes for production. Generate a vmk_live_ key at the VoidMob dashboard and add it to your client config. To try the tools against mock data without a key, set VOIDMOB_SANDBOX=1 for an in-memory $500 play-money balance.

Is the VoidMob MCP server free?

The server is free and open source under the MIT license. You pay per use for real services (proxies, SMS, eSIMs) from your prepaid wallet balance. Sandbox mode uses free play-money so you can test at no cost.

Which MCP clients does it work with?

Claude Code, Claude Desktop, Cursor, and any MCP-compatible client. Add it with one command or a small JSON config block.

How is usage billed?

Pay per use from your prepaid wallet. Fund the wallet with cryptocurrency (BTC, ETH, SOL, USDT, USDC, LTC) on the VoidMob dashboard, and agents spend from that balance as they call tools.

What can an AI agent do with it?

25 tools spanning mobile proxies, US non-VoIP SMS verification, global eSIM data plans, account and balance checks, and geo discovery for precise targeting.

What are the requirements?

Node 22 or newer and an MCP-compatible client. There is no API client code to write; the agent discovers and calls the 25 tools directly.

Try It Now

Start Building with VoidMob MCP

Generate an API key, add it to your MCP client, and start building on real mobile infrastructure. The package is open source, and sandbox mode lets you test against mock data for free.