{
  "markdown": "# @mobileproxy/mcp-server\n\nModel Context Protocol server for [mobileproxy.space](https://mobileproxy.space) — gives Claude Code, Claude Desktop, Cursor, Windsurf and other MCP-compatible agents direct control over your mobile proxies.\n\n## Quickstart\n\n### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"mobileproxy\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@mobileproxy/mcp-server\"],\n      \"env\": {\n        \"MOBILEPROXY_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```\nclaude mcp add mobileproxy \\\n  --command \"npx -y @mobileproxy/mcp-server\" \\\n  --env MOBILEPROXY_API_KEY=your_api_key\n```\n\nGet your API key at [mobileproxy.space/user.html?api](https://mobileproxy.space/user.html?api).\n\n## Available tools (MVP)\n\n| Tool | Kind | Description |\n|---|---|---|\n| `list_proxies` | read | List all proxies in your account; filter by type / id_country |\n| `get_proxy_status` | read | Current external IP for a proxy + optional spam-blacklist check |\n| `get_balance` | read | Account balance in RUB + partner payout amount if any |\n| `get_geo_list` | read | All available geo locations (geoid, ISO, free-modem count); filter by country |\n| `get_price` | read | Prices across all durations (1/3/7/14/30/60/90/180/365 d) for a country |\n| `rotate_ip` | mutating | Force the mobile proxy to grab a new carrier IP, with optional verify |\n| `change_geo` | mutating | Swap a proxy's modem to a different country/operator without re-buying |\n| `buy_proxy` | **destructive** | Purchase one or more proxies — spends real balance, ask before calling |\n\nAll read tools cache geo/country lookups (5–60 min) to stay friendly with the ~3 req/sec per-token rate limit.\n\n## Configuration\n\n| Env var | Default | Purpose |\n|---|---|---|\n| `MOBILEPROXY_API_KEY` | **required** | Your API token from `/user.html?api` |\n| `MOBILEPROXY_API_BASE` | `https://mobileproxy.space` | Override for dev/staging |\n| `MOBILEPROXY_TIMEOUT_MS` | `30000` | HTTP request timeout |\n| `MOBILEPROXY_DEBUG` | `0` | Set to `1` for verbose stderr logs |\n\n## Client compatibility\n\n| Client | Supported | Notes |\n|---|---|---|\n| Claude Code CLI | ✅ | `${env:VAR}` substitution works in `.mcp.json` |\n| Cursor | ✅ | hard-code env in config (no substitution) |\n| Windsurf | ✅ | as Cursor |\n| Cowork / CCD | ⚠️ | works but `${env:VAR}` is **not** substituted — hard-code locally |\n| Claude Desktop (classic) | ✅ | put `mcpServers` block in `claude_desktop_config.json` |\n\nSee [docs/INSTALL.md](docs/INSTALL.md) for per-client setup and the env-var workaround.\n\n## Links\n\n- [Install guide](docs/INSTALL.md)\n- [Publishing runbook](docs/PUBLISH.md)\n- [Full development spec](https://mobileproxy.space) (internal)\n- [Model Context Protocol](https://modelcontextprotocol.io)\n\n## License\n\nMIT\n",
  "bytes": 2909,
  "sha": "4cf19a4e4e32f566b8c3974fc38cb22264873909192b1f6074ebcde369393a38",
  "repo_slug": "mobileproxy/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mobileproxy_mcp_server_73b3ac8d/readme"
}