v0.1.2 live on npm

Mobile proxies, controlled by your AI agent

@mobileproxy/mcp-server is an MCP server that lets Claude Code, Claude Desktop, Cursor, Windsurf and any other MCP-aware client manage your proxies in natural language — rotate IP, switch country, buy a new modem, check balance. One config block, eight tools, no glue code.

View on GitHub View on npm In MCP Registry

Quickstart

Drop one block into your client config, restart, ask. Replace YOUR_API_KEY with a token from /user.html?api.

~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows.

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

Save as .mcp.json in the root of any project. Claude Code will ask for approval on first run.

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

~/.cursor/mcp.json globally, or .cursor/mcp.json per workspace.

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

What your agent can do

Eight tools cover the typical lifecycle — discover, monitor, mutate, purchase.

list_proxies

List every proxy in your account with full credentials and expiry. Filter by type or country.

read

get_proxy_status

Current external IP of a proxy plus optional spam-blacklist scan.

read

get_balance

Account balance in RUB and partner payout amount.

read

get_geo_list

All available geo-locations with free-modem counts. Filter by ISO country code.

read

get_price

Price quote across all durations (1, 7, 30, 90, 365 days) for any country, in RUB or USD.

read

rotate_ip

Force a new carrier IP on a mobile proxy. Optional auto-verify with the new IP.

mutate

change_geo

Move an existing proxy to a different country or mobile operator without re-buying.

mutate

buy_proxy

Purchase one or more new proxies. Marked destructive — the client will ask for confirmation.

destructive

What you can ask the agent

Account farming / scraping

"Rotate the IP on proxy 470663, then verify with ifconfig.me before each request." The agent loops rotate_ip + get_proxy_status indefinitely.

Geo-aware workflows

"List locations available in Turkey, then move proxy 470663 there." The agent chains get_geo_list + change_geo automatically.

Hands-free top-ups

"Check my balance, and if I have enough for 5 mobile proxies in Germany for a week, buy them with auto-renewal." Composes get_balance + get_price + buy_proxy with confirmation.

FAQ

Do I need to write code?

No. Add one JSON block to your client config, restart the client, and ask in natural language. The agent picks the right tool from the description.

What does it cost?

The MCP server itself is free and open-source (MIT). You pay only for the proxies in your mobileproxy.space account, at the usual rates.

Is my API key safe?

The server runs locally on your machine as a child process of your AI client. The token never leaves your computer. We recommend IP-restricting the token at /user.html?api.

Which clients are supported?

Any MCP-aware client: Claude Code, Claude Desktop, Cursor, Windsurf, Cowork, and a growing list in the official MCP Registry.

Ready to plug it in?

Get your API key from the cabinet, copy the quickstart block, restart your AI client — done.

Get API key