Name: mobileproxy
Author: mobileproxy

What can you do with mobileproxy?

@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

License

MIT

Install

Add mobileproxy to your client. Pick the one you use.

claude mcp add mcp-server -- npx -y @mobileproxy/mcp-server

codex mcp add mcp-server -- npx -y @mobileproxy/mcp-server

amp mcp add mcp-server -- npx -y @mobileproxy/mcp-server

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

Add to `claude_desktop_config.json`, then restart Claude Desktop.

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

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

code --add-mcp '{"name":"mcp-server","command":"npx","args":["-y","@mobileproxy/mcp-server"]}'

Or add the block manually to `.vscode/mcp.json` under `servers`.

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

Add to `~/.codeium/windsurf/mcp_config.json`.

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

Add to `cline_mcp_settings.json` via the MCP Servers panel.

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

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "mcp-server": {
      "type": "local",
      "command": "npx",
      "args": [
        "-y",
        "@mobileproxy/mcp-server"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "mcp-server": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mobileproxy/mcp-server"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

npx -y @mobileproxy/mcp-server

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.

8 tools

mobileproxy exposes 8 tools to a connected agent.

list_proxies: read
get_proxy_status: read
get_balance: read
get_geo_list: read
get_price: read
rotate_ip: mutating
change_geo: mutating
buy_proxy: **destructive**

Score

66 / 100

Good

Documentation22/25
Maintenance13/25
Trust13/20
Capability6/15
Install experience12/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 95 days ago
Has a release history
Repository is not archived
Licensed MIT
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
8 tool(s) documented
Provides prompt templates
Provides resources
12 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

Read the full rubric →

Version history

Versions	Published
0.1.1Latest	May 28, 2026