@mobileproxy/mcp-server

@mobileproxy/mcp-server

Model Context Protocol server for mobileproxy.space — gives Claude Code, Claude Desktop, Cursor, Windsurf and other MCP-compatible agents direct control over your mobile proxies.

Quickstart

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "mobileproxy": {
      "command": "npx",
      "args": ["-y", "@mobileproxy/mcp-server"],
      "env": {
        "MOBILEPROXY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add mobileproxy \
  --command "npx -y @mobileproxy/mcp-server" \
  --env MOBILEPROXY_API_KEY=your_api_key

Get your API key at mobileproxy.space/user.html?api.

Available tools (MVP)

Tool	Kind	Description
list_proxies	read	List all proxies in your account; filter by type / id_country
get_proxy_status	read	Current external IP for a proxy + optional spam-blacklist check
get_balance	read	Account balance in RUB + partner payout amount if any
get_geo_list	read	All available geo locations (geoid, ISO, free-modem count); filter by country
get_price	read	Prices across all durations (1/3/7/14/30/60/90/180/365 d) for a country
rotate_ip	mutating	Force the mobile proxy to grab a new carrier IP, with optional verify
change_geo	mutating	Swap a proxy's modem to a different country/operator without re-buying
buy_proxy	destructive	Purchase one or more proxies — spends real balance, ask before calling

All read tools cache geo/country lookups (5–60 min) to stay friendly with the ~3 req/sec per-token rate limit.

Configuration

Env var	Default	Purpose
MOBILEPROXY_API_KEY	required	Your API token from /user.html?api
MOBILEPROXY_API_BASE	https://mobileproxy.space	Override for dev/staging
MOBILEPROXY_TIMEOUT_MS	30000	HTTP request timeout
MOBILEPROXY_DEBUG	0	Set to 1 for verbose stderr logs

Client compatibility

Client	Supported	Notes
Claude Code CLI	✅	${env:VAR} substitution works in .mcp.json
Cursor	✅	hard-code env in config (no substitution)
Windsurf	✅	as Cursor
Cowork / CCD	⚠️	works but ${env:VAR} is not substituted — hard-code locally
Claude Desktop (classic)	✅	put mcpServers block in claude_desktop_config.json

See docs/INSTALL.md for per-client setup and the env-var workaround.

Links

• Install guide
• Publishing runbook
• Full development spec (internal)
• Model Context Protocol

License

MIT