voidmob-mcp — Claude Code MCP server: features and setup
Connects an AI agent to mobile proxies, non-VoIP SMS verification, dedicated numbers, and global eSIMs. Useful when an agent needs access to these services.
claude mcp add --env VOIDMOB_API_KEY=<VOIDMOB_API_KEY> --env VOIDMOB_SANDBOX=<VOIDMOB_SANDBOX> --env VOIDMOB_READ_ONLY=<VOIDMOB_READ_ONLY> --env VOIDMOB_MAX_ORDER_CENTS=<VOIDMOB_MAX_ORDER_CENTS> --env VOIDMOB_BUDGET_CENTS=<VOIDMOB_BUDGET_CENTS> --transport stdio voidmob-mcp -- npx -y @voidmob/mcpWhat voidmob-mcp does
voidmob-mcp gives an agent 30 tools for mobile proxies, non-VoIP SMS verification, dedicated numbers, and global eSIMs. It also includes short reference resources and guided prompts. Run the server with npx -y @voidmob/mcp.
You need a VOIDMOB_API_KEY and a funded prepaid balance, topped up with crypto. Purchases require max_price_cents set to a price you approved; if the price rises, the purchase is not charged. The balance sets the API key’s spending limit, so configure spending controls before handing purchases to an agent.
What it helps with
- connect mobile proxies to an AI agent
- request non-VoIP SMS verification
- use a dedicated number through agent tools
- add global eSIMs to an agent workflow
Example prompts for the agent
- Find available mobile proxies and show me their prices.
- Find a non-VoIP option for SMS verification.
- Show available global eSIMs and their prices.
How to install voidmob-mcp
Platform CLI
claude mcp add --env VOIDMOB_API_KEY=<VOIDMOB_API_KEY> --env VOIDMOB_SANDBOX=<VOIDMOB_SANDBOX> --env VOIDMOB_READ_ONLY=<VOIDMOB_READ_ONLY> --env VOIDMOB_MAX_ORDER_CENTS=<VOIDMOB_MAX_ORDER_CENTS> --env VOIDMOB_BUDGET_CENTS=<VOIDMOB_BUDGET_CENTS> --transport stdio voidmob-mcp -- npx -y @voidmob/mcpReplace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
codex mcp add voidmob-mcp --env VOIDMOB_API_KEY=<VOIDMOB_API_KEY> --env VOIDMOB_SANDBOX=<VOIDMOB_SANDBOX> --env VOIDMOB_READ_ONLY=<VOIDMOB_READ_ONLY> --env VOIDMOB_MAX_ORDER_CENTS=<VOIDMOB_MAX_ORDER_CENTS> --env VOIDMOB_BUDGET_CENTS=<VOIDMOB_BUDGET_CENTS> -- npx -y @voidmob/mcpReplace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"mcpServers": {
"voidmob-mcp": {
"command": "npx",
"args": [
"-y",
"@voidmob/mcp"
],
"env": {
"VOIDMOB_API_KEY": "<VOIDMOB_API_KEY>",
"VOIDMOB_SANDBOX": "<VOIDMOB_SANDBOX>",
"VOIDMOB_READ_ONLY": "<VOIDMOB_READ_ONLY>",
"VOIDMOB_MAX_ORDER_CENTS": "<VOIDMOB_MAX_ORDER_CENTS>",
"VOIDMOB_BUDGET_CENTS": "<VOIDMOB_BUDGET_CENTS>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"servers": {
"voidmob-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@voidmob/mcp"
],
"env": {
"VOIDMOB_API_KEY": "<VOIDMOB_API_KEY>",
"VOIDMOB_SANDBOX": "<VOIDMOB_SANDBOX>",
"VOIDMOB_READ_ONLY": "<VOIDMOB_READ_ONLY>",
"VOIDMOB_MAX_ORDER_CENTS": "<VOIDMOB_MAX_ORDER_CENTS>",
"VOIDMOB_BUDGET_CENTS": "<VOIDMOB_BUDGET_CENTS>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
gemini mcp add -e VOIDMOB_API_KEY=<VOIDMOB_API_KEY> -e VOIDMOB_SANDBOX=<VOIDMOB_SANDBOX> -e VOIDMOB_READ_ONLY=<VOIDMOB_READ_ONLY> -e VOIDMOB_MAX_ORDER_CENTS=<VOIDMOB_MAX_ORDER_CENTS> -e VOIDMOB_BUDGET_CENTS=<VOIDMOB_BUDGET_CENTS> voidmob-mcp npx -y @voidmob/mcpReplace <…> with your own values. 1 more environment variable is in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about voidmob-mcp
How do I install voidmob-mcp in Claude Code?
Run claude mcp add voidmob-mcp -e VOIDMOB_API_KEY=<VOIDMOB_API_KEY> -- npx -y @voidmob/mcp, replacing the placeholder with your API key.
What does voidmob-mcp do?
It gives an agent tools for mobile proxies, non-VoIP SMS verification, dedicated numbers, and global eSIMs. The package also includes reference resources and guided prompts.
Do purchases need approval?
Yes. Set max_price_cents to a price you have approved. If the current price is higher, the purchase is not charged.
