Mobileproxy MCP

Name: Mobileproxy MCP
Author: mobileproxy

by mobileproxyversion 0.6.1i★ –iComputer or cloud

Registry nameio.github.mobileproxy/mcp-server

Install

Overview

Description from the maker (original English)

Control dedicated 4G mobile and residential proxies on mobileproxy.space from AI agents.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Computer or cloud
Transport: stdio, Streamable HTTP
Category: Other
You need to fill in: MOBILEPROXY_API_KEY, ADSPOWER_API_KEY, Authorization

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on the maker’s server: what you ask it goes through their server.
You fill in yourself: MOBILEPROXY_API_KEY, MOBILEPROXY_API_BASE, MOBILEPROXY_TIMEOUT_MS, MOBILEPROXY_DEBUG, ADSPOWER_API_KEY, Authorization

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

Runs in the cloudNothing to install; it connects over the internet
npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Or run it on your computer

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "mobileproxy": {
      "command": "npx",
      "args": [
        "-y",
        "@mobileproxy/mcp-server"
      ],
      "env": {
        "MOBILEPROXY_API_KEY": "your-value",
        "MOBILEPROXY_API_BASE": "your-value",
        "MOBILEPROXY_TIMEOUT_MS": "your-value",
        "MOBILEPROXY_DEBUG": "your-value",
        "ADSPOWER_API_KEY": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add --transport http mobileproxy https://mcp.mpsapi.com/mcp --header 'Authorization: your-value'

Or run it on your computer

claude mcp add mobileproxy --env MOBILEPROXY_API_KEY=your-value --env MOBILEPROXY_API_BASE=your-value --env MOBILEPROXY_TIMEOUT_MS=your-value --env MOBILEPROXY_DEBUG=your-value --env ADSPOWER_API_KEY=your-value -- npx -y @mobileproxy/mcp-server

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "mobileproxy": {
      "url": "https://mcp.mpsapi.com/mcp",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

Or run it on your computer

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "mobileproxy": {
      "command": "npx",
      "args": [
        "-y",
        "@mobileproxy/mcp-server"
      ],
      "env": {
        "MOBILEPROXY_API_KEY": "your-value",
        "MOBILEPROXY_API_BASE": "your-value",
        "MOBILEPROXY_TIMEOUT_MS": "your-value",
        "MOBILEPROXY_DEBUG": "your-value",
        "ADSPOWER_API_KEY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "mobileproxy": {
      "type": "http",
      "url": "https://mcp.mpsapi.com/mcp",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

Or run it on your computer

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "mobileproxy": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mobileproxy/mcp-server"
      ],
      "env": {
        "MOBILEPROXY_API_KEY": "your-value",
        "MOBILEPROXY_API_BASE": "your-value",
        "MOBILEPROXY_TIMEOUT_MS": "your-value",
        "MOBILEPROXY_DEBUG": "your-value",
        "ADSPOWER_API_KEY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

MOBILEPROXY_API_KEY secret required env
API token from https://mobileproxy.space/user.html?api
MOBILEPROXY_API_BASE env
Override REST API base URL (default https://mpsapi.com)
MOBILEPROXY_TIMEOUT_MS env
HTTP request timeout in milliseconds (default 30000)
MOBILEPROXY_DEBUG env
Set to 1 for verbose stderr logs
ADSPOWER_API_KEY secret env
AdsPower Local API key, only if its security verification is on (for attach_proxy_to_adspower)
Authorization secret HTTP header
Bearer . Optional for clients that sign in with OAuth (claude.ai connectors).

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

We have not read this server’s tool list yet; we check endpoints in rotation.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account mobileproxy, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
… Not checked yet
Endpoint responds
Not checked yet; we check endpoints in rotation
… Not checked yet
Sign-in with OAuth
Not checked yet; we check endpoints in rotation
… Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint

Compared with others in Otheri

More stars than 0% of the other 32461 servers in this category
Published to the registry more recently than 60% of the other 32461 servers in this category
Basic checks equal to or better than 100% of the other 32461 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Mobileproxy MCP safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: MOBILEPROXY_API_KEY, ADSPOWER_API_KEY, Authorization

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.6.1) reached the registry 26 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, dotnet-mcp

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago

Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated yesterday

Install

dotnet-mcp

by Skymly

MCP server for .NET symbols, XAML, source generators, and restricted workspace edit

Runs on your computerUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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

Every mobile proxy is a dedicated 4G/LTE modem with a real carrier IP that stays yours for as long as you need, and you rotate it on demand. Typical uses: testing sites and apps the way mobile users in a given country and network see them, checking ads and localized content by geo, price and availability monitoring, and keeping your own traffic private.

Quickstart

Get your API key at mobileproxy.space/user.html?api.

Claude Desktop — one click

Download mobileproxy.mcpb from the latest release, double-click it, paste your API key. Claude Desktop ships its own Node.js, nothing else to install.

Claude Code

claude mcp add mobileproxy --scope user --env MOBILEPROXY_API_KEY=your_api_key -- npx -y @mobileproxy/mcp-server

--scope user stores the key in your user config, not in the project, so it never ends up in git.

Remote server — nothing to install

The hosted endpoint https://mcp.mpsapi.com/mcp runs the same tools, with two differences: it leaves out the local-only AdsPower bridge, and it quotes purchases, renewals and top-ups instead of charging the balance (quote_proxy_purchase, quote_renewal, quote_residential_purchase, quote_residential_topup return the amount and a dashboard link). Install the package locally to buy from the chat.

claude.ai: Settings → Connectors → Add custom connector → URL https://mcp.mpsapi.com/mcp → paste your API key on the sign-in page.
Claude Code:

  claude mcp add --transport http mobileproxy https://mcp.mpsapi.com/mcp --header "Authorization: Bearer your_api_key"

Cursor: {"mcpServers": {"mobileproxy": {"url": "https://mcp.mpsapi.com/mcp", "headers": {"Authorization": "Bearer your_api_key"}}}}

The server keeps no copy of your key: each request carries it, or an OAuth token that contains it encrypted.

Cursor, Windsurf, Claude Desktop (manual JSON)

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

Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows). Cursor: ~/.cursor/mcp.json.

Docker

docker run -i --rm -e MOBILEPROXY_API_KEY=your_api_key ghcr.io/mobileproxy/mcp-server

In an MCP client config use "command": "docker" with "args": ["run", "-i", "--rm", "-e", "MOBILEPROXY_API_KEY", "ghcr.io/mobileproxy/mcp-server"].

Быстрый старт по-русски

MCP-сервер даёт Claude, Cursor и другим AI-агентам прямое управление вашими прокси на mobileproxy.space: список прокси, смена IP, смена страны и оператора, баланс, покупка.

Возьмите API-ключ в личном кабинете.
Установите:

Claude Desktop — скачайте mobileproxy.mcpb из последнего релиза, откройте файл двойным кликом и вставьте ключ.
Claude Code — одна команда: bash claude mcp add mobileproxy --scope user --env MOBILEPROXY_API_KEY=ваш_ключ -- npx -y @mobileproxy/mcp-server
Без установки — удалённый сервер https://mcp.mpsapi.com/mcp: в claude.ai добавьте его как коннектор (ключ вводится на странице входа), в Claude Code — claude mcp add --transport http mobileproxy https://mcp.mpsapi.com/mcp --header "Authorization: Bearer ваш_ключ".

Попросите агента обычными словами:

«Всё ли в порядке с моими прокси?»
«Дай строку для импорта прокси 470663 в AdsPower»
«Смени IP на прокси 470663, пока не будет чистый»
«Где в Казани есть свободные модемы Мегафона и сколько это стоит?»
«Пропиши прокси 470663 в профиль AdsPower jc8y5g3» (AdsPower должен быть запущен)
«Поставь прокси 470663 TCP-отпечаток Windows 11 и проверь, что видят сайты»
«Перенеси прокси 470663 в Турцию»
«Сколько стоят 5 прокси в Германии на неделю?»

Покупки агент всегда сначала считает в режиме estimate_only и просит подтверждения — деньги без вашего «да» не списываются.

Available tools

read tools only look things up. write tools change something — a proxy, its settings or the balance — and are annotated as destructive, so MCP clients such as Claude ask before running them. Purchase tools (local build only) also take estimate_only: true for a dry run.

Account and proxies

Tool	Kind	Description
`get_health_snapshot`	read	What needs attention: expiring proxies (with auto-renewal state), residential packages low on traffic, optionally blacklisted IPs
`list_proxies`	read	All proxies with connection details; filter by type or country
`get_proxy_status`	read	Current external IP of a proxy + optional spam-blacklist check
`get_connection_string`	read	`http://` / `socks5://` URLs, a `host:port:login:password` import line, a curl test, and the change-IP link
`get_balance`	read	Balance in RUB + partner payout amount if any
`get_account_history`	read	Top-ups, purchases, renewals and refunds with receipt links
`update_proxy_settings`	write	Auto-renewal, comment and automatic IP-rotation timer for up to 100 proxies at once
`change_proxy_credentials`	write	New login and password for up to 50 proxies, e.g. after a leak
`reboot_modem`	write	Power-cycle the modem behind a stuck mobile proxy (once per 30 min)

Mobile, server and backconnect proxies

Tool	Kind	Description
`find_available_geo`	read	Free modems in a country or city, operators that have them, and prices per period — in one call
`get_geo_list`	read	All locations (geoid, ISO, free-modem count); filter by country
`get_price`	read	Prices for every rental period (1/3/7/14/30/60/90/180/365 d) in a country
`rotate_ip`	write	New exit IP: mobile proxies reconnect to the carrier; sticky residential proxies get a new peer
`rotate_until_clean`	write	Rotate a mobile proxy until its IP is on no spam blacklist; `keep_if_clean` keeps a good current IP
`change_geo`	write	Move a proxy to another country or operator without re-buying
`buy_proxy`	write	Buy proxies — charges the balance (hosted: `quote_proxy_purchase`)
`renew_proxies`	write	Extend up to 100 proxies by a period — charges the balance (hosted: `quote_renewal`)

TCP fingerprint (mobile and server proxies)

Sets the OS signature a proxy shows at the network level (TTL, window, MSS, TCP option order), so proxied traffic looks like the device it represents — for example a Windows desktop or an iPhone.

Tool	Kind	Description
`list_tcp_profiles`	read	Presets: Android, iPhone, Windows, macOS, Linux…
`get_tcp_fingerprint`	read	Which profile each proxy currently presents (null = native)
`set_tcp_fingerprint`	write	Apply a profile to up to 50 proxies; `profile_id=0` restores native. Reaches the equipment within a minute
`diagnose_tcp_fingerprint`	read	What fingerprinting endpoints observe through the proxy vs. the applied profile (up to ~45 s)

Residential proxies (type 3)

Residential is billed by traffic volume, not by rental period, so it has its own plan, geo and top-up tools.

Tool	Kind	Description
`list_residential_plans`	read	GB bundles with price per GB
`get_residential_locations`	read	Countries / regions / cities / ASNs valid for geo targeting
`get_residential_traffic`	read	Daily consumption and burn rate
`set_residential_geo`	write	Read or change geo targeting and rotating/sticky mode — free and reversible
`buy_residential`	write	Buy a traffic bundle — charges the balance (hosted: `quote_residential_purchase`)
`add_residential_traffic`	write	Top up a package, keeping its geo and connection string (hosted: `quote_residential_topup`)

Notes on residential:

Geo codes come from get_residential_locations. The backend ignores unknown values and leaves the proxy in its previous location.
Changing geo rewrites the provider login; the response carries the new http/socks5 strings.
In list_proxies a residential entry has proxy_type: 3, both ports equal (one port serves HTTP and SOCKS5), and a residential_traffic_* quota block.

Local integrations

Tool	Kind	Description
`attach_proxy_to_adspower`	write	Write a proxy (and the change-IP link) into an AdsPower browser profile — experimental, local build only

attach_proxy_to_adspower talks to the AdsPower Local API on your computer, so AdsPower must be running with its Local API enabled. It is built from AdsPower's API documentation and covered by tests, but not yet verified against a live AdsPower install — please report problems in Issues.

Read tools cache geo and country lookups (5–60 min) to stay within the ~3 requests/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://mpsapi.com`	API portal, reachable from Russia too; override for dev/staging
`MOBILEPROXY_TIMEOUT_MS`	`30000`	HTTP request timeout
`MOBILEPROXY_DEBUG`	`0`	Set to `1` for verbose stderr logs
`ADSPOWER_API_URL`	`http://local.adspower.net:50325`	AdsPower Local API address, for `attach_proxy_to_adspower`
`ADSPOWER_API_KEY`	unset	Only if AdsPower's Local API has security verification on

Running as a remote HTTP server

npx -y @mobileproxy/mcp-server --http (or the Docker image with --http) serves MCP over Streamable HTTP at /mcp. It is stateless and holds no key of its own: clients send their API key as Authorization: Bearer …, and with MOBILEPROXY_OAUTH_SECRET set it also acts as an OAuth 2.1 server for claude.ai connectors. See deploy/README.md for the Docker + nginx setup and every setting.

Client compatibility

Client	Supported	Notes
Claude Desktop	✅	one-click `.mcpb`, or the JSON block above
Claude Code CLI	✅	`claude mcp add ... --scope user`; `${env:VAR}` also works in `.mcp.json`
Cursor	✅	hard-code env in config (no substitution)
Windsurf	✅	as Cursor
Cowork / CCD	⚠️	`${env:VAR}` is not substituted — use user-scope config or a system-wide env var

See docs/INSTALL.md for per-client setup and troubleshooting.

Privacy

This server is a thin client for the mobileproxy.space API; it adds no tracking of its own.

What it processes: your mobileproxy.space API key and the parameters of each tool call, which it forwards to the mobileproxy.space API (mpsapi.com) to act on your account. It does not read or store your conversations, prompts or files.
Local install (npm, `.mcpb`, Docker): everything runs on your computer. The key stays in your MCP client's configuration or your OS keychain.
**Hosted endpoint (`mcp.mpsap

Only the beginning is shown; read the rest in the repo

Mobileproxy MCP

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Or run it on your computer

Or run it on your computer

Or run it on your computer

Or run it on your computer

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

dotnet-mcp

README from the maker

@mobileproxy/mcp-server

Quickstart

Claude Desktop — one click

Claude Code

Remote server — nothing to install

Cursor, Windsurf, Claude Desktop (manual JSON)

Docker

Быстрый старт по-русски

Available tools

Account and proxies

Mobile, server and backconnect proxies

TCP fingerprint (mobile and server proxies)

Residential proxies (type 3)

Local integrations

Configuration

Running as a remote HTTP server

Client compatibility

Privacy