Summary
Plugs Claude and other MCP clients directly into the mobileproxy.space HTTP API so you can list, rotate, and purchase mobile proxies without leaving your editor. Exposes eight tools: read operations for listing proxies, checking current IPs and blacklist status, fetching geo availability and pricing, plus mutating calls to rotate IPs and swap modem locations. The buy_proxy tool is flagged destructive since it spends real account balance. Requires an API key from your mobileproxy.space account and respects their rate limits with built-in caching on geo lookups. Useful if you're managing mobile proxy infrastructure for testing, scraping, or automation workflows and want conversational control over provisioning and rotation.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →@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
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Configuration
MOBILEPROXY_API_KEY*secretAPI token from https://mobileproxy.space/user.html?api
MOBILEPROXY_API_BASEOverride REST API base URL (default https://mobileproxy.space)
MOBILEPROXY_TIMEOUT_MSHTTP request timeout in milliseconds (default 30000)
MOBILEPROXY_DEBUGSet to 1 for verbose stderr logs
Categories
Registryactive
Package@mobileproxy/mcp-server
TransportSTDIO
AuthRequired
UpdatedMay 28, 2026
