Yes, Mobileproxy is free to use.

How do I install Mobileproxy?

Mobileproxy is a local plugin. Install it using npm package: @mobileproxy/mcp-server and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Mobileproxy need?

Mobileproxy requires the following credentials or environment variables: MOBILEPROXY_API_KEY, MOBILEPROXY_API_BASE, MOBILEPROXY_TIMEOUT_MS, MOBILEPROXY_DEBUG. You can find setup instructions on the server detail page.

What AI apps work with Mobileproxy?

Mobileproxy uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Mobileproxy MCP Server

by Mobileproxy

Developer ToolsUse Caution4.8MCP RegistryLocal

Free

Server data from the Official MCP Registry

MCP server for mobileproxy.space — manage your mobile proxies from Claude, Cursor, Windsurf.

About

MCP server for mobileproxy.space — manage your mobile proxies from Claude, Cursor, Windsurf.

Security Report

4.8

Use Caution4.8High Risk

This MCP server is well-structured with proper authentication, appropriate caching, and reasonable security practices. The API key is correctly handled via environment variables, and the codebase shows good error handling and input validation. Minor code quality observations exist but do not constitute security vulnerabilities. Permissions appropriately match the server's purpose of controlling mobile proxies via the mobileproxy.space API. Supply chain analysis found 3 known vulnerabilities in dependencies (1 critical, 2 high severity). Package verification found 1 issue.

7 files analyzed · 8 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

What You'll Need

Set these up before or after installing:

API token from https://mobileproxy.space/user.html?apiRequired

Environment variable: MOBILEPROXY_API_KEY

Override REST API base URL (default https://mobileproxy.space)Optional

Environment variable: MOBILEPROXY_API_BASE

HTTP request timeout in milliseconds (default 30000)Optional

Environment variable: MOBILEPROXY_TIMEOUT_MS

Set to 1 for verbose stderr logsOptional

Environment variable: MOBILEPROXY_DEBUG

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-mobileproxy-mcp-server": {
      "env": {
        "MOBILEPROXY_DEBUG": "your-mobileproxy-debug-here",
        "MOBILEPROXY_API_KEY": "your-mobileproxy-api-key-here",
        "MOBILEPROXY_API_BASE": "your-mobileproxy-api-base-here",
        "MOBILEPROXY_TIMEOUT_MS": "your-mobileproxy-timeout-ms-here"
      },
      "args": [
        "-y",
        "@mobileproxy/mcp-server"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

@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.

License

MIT

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Mobileproxy MCP Server

About

Security Report

Findings (8)Action required

Permissions Required

What You'll Need

How to Install

Documentation

@mobileproxy/mcp-server

Quickstart

Claude Desktop

Claude Code

Available tools (MVP)

Configuration

Client compatibility

Links

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Toleno

mcp-creator-python

MarkItDown

mcp-creator-typescript

FinAgent