# @mobileproxy/mcp-server

Model Context Protocol server for mobileproxy.space — give Claude/Cursor/Windsurf direct control over your dedicated 4G mobile and residential proxies

- **Type:** MCP server
- **Trust:** 85/100 (A), scored on the package rubric
- **Verification:** verified (build provenance)
- **Version:** 0.6.0
- **Author:** Unknown
- **License:** MIT
- **npm:** @mobileproxy/mcp-server
- **Endpoints:** streamable-http https://mcp.mpsapi.com/mcp
- **Source:** https://github.com/mobileproxy/mcp-server
- **Endpoint health:** reachable (last checked 2026-10-03T06:28:37.281Z, 1 sample) — uptime is not a security property and is not part of the trust score
- **Compatible clients:** claude-code, cursor, copilot, chatgpt, gemini (basis: transport)

## Trust

85/100 (A), scored on the package rubric
- Publisher verified: no
- Build provenance: verified attestation
- npm trusted publishing (OIDC): yes
- Install scripts: nothing suspicious found
- Prompt-injection scan: not run
- Obfuscation scan: not run
- Evidence age: 1 day

## Security scan

- **Status:** clean
- **Scanned:** 2026-10-03T06:28:08.510Z
- **Version scanned:** 0.6.0
- **CVEs:** none found by OSV at scan time

## Tools

32 declared. Statically extracted from the shipped source — a floor on the surface, not a census.
- `get_account_history` — Lists balance operations newest first: top-ups, purchases, renewals and refunds, with the
- `attach_proxy_to_adspower` — Writes a mobileproxy.space proxy into an AdsPower browser profile through the AdsPower
- `quote_proxy_purchase` — Calculates the price of mobile, server or backconnect proxies for a location, period and
- `buy_proxy` — Buys one or more mobile, server or backconnect proxies and charges the account balance
- `change_geo` — Swaps the underlying modem of a proxy to one in a different country and/or
- `find_available_geo` — Answers "where can I get a mobile proxy in <country/city> on <operator>, and what
- `get_balance` — Returns the current account balance in RUB, plus the can_payout amount for accounts
- `get_connection_string` — Returns a proxy's credentials as ready-to-paste strings: http:// and socks5:// URLs, a
- `get_geo_list` — Returns all geo-locations (geoid + human caption + ISO + free-modem
- `get_health_snapshot` — One-call answer to "is everything OK with my proxies?": balance, proxies expiring
- `get_price` — Returns mobile proxy prices for a country across all rental periods (1, 3, 7, 14, 30,
- `get_proxy_status` — Returns the CURRENT external IP of a proxy and optionally checks if that
- `list_proxies` — Returns all proxies owned by the authenticated user with full connection
- `quote_renewal` — Calculates the price of extending one or more mobile, server or backconnect proxies by a
- `renew_proxies` — Extends one or more mobile, server or backconnect proxies by a period and charges the
- `update_proxy_settings` — Changes settings on one or more proxies at once: auto-renewal on or off, a comment, and
- `change_proxy_credentials` — Sets a new login and password on one or more proxies, for example after credentials
- `reboot_modem` — Power-cycles the 4G modem behind a mobile proxy, which clears most hangs where the proxy
- `quote_residential_purchase` — Calculates the price and traffic volume of a residential proxy package from
- `buy_residential` — Buys a residential (home ISP) proxy: a traffic bundle rather than a time rental. Charges
- `quote_residential_topup` — Calculates the price of adding traffic to an existing residential proxy without buying it.
- `add_residential_traffic` — Tops up the traffic quota of an existing residential proxy, keeping its geo settings and
- `set_residential_geo` — Reads or changes the geo targeting and session mode of a residential proxy. With only
- `get_residential_locations` — Lists geo targets available for residential proxies: countries, regions (states),
- `list_residential_plans` — Returns the residential (home ISP) proxy plans with price per GB. Residential is billed
- `get_residential_traffic` — Returns daily traffic consumption for a residential proxy. Use it to answer
- `rotate_ip` — Gets a proxy a new exit IP. Mobile proxies (proxy_type=0) reconnect to the carrier and
- `rotate_until_clean` — Gets a mobile proxy onto an IP that is on no spam/abuse blacklist: rotates, checks the
- `list_tcp_profiles` — Lists the TCP/IP fingerprint presets a mobile or server proxy can present at the network
- `get_tcp_fingerprint` — Shows which TCP fingerprint profile each proxy currently imitates (profile_id null = the
- `set_tcp_fingerprint` — Makes mobile or server proxies present a TCP fingerprint profile from list_tcp_profiles,
- `diagnose_tcp_fingerprint` — Sends a real request through the proxy to fingerprinting endpoints and compares what they

## Install

**Verdict: install** — No blocking findings and no open coverage gaps — safe to install as configured.
**Config** (claude-code):
```json
"{\n  \"mcpServers\": {\n    \"mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@mobileproxy/mcp-server\"\n      ],\n      \"env\": {\n        \"MOBILEPROXY_API_KEY\": \"<YOUR_MOBILEPROXY_API_KEY>\",\n        \"ADSPOWER_API_KEY\": \"<YOUR_ADSPOWER_API_KEY>\"\n      }\n    }\n  }\n}"
```
**Credentials it will ask for** (names only — Forge never holds a value):
- `MOBILEPROXY_API_KEY` — Mobileproxy API Key (required)
- `ADSPOWER_API_KEY` — Adspower API Key (optional)
Placeholders only. Forge never holds, brokers, or transmits a credential value — replace each <YOUR_NAME> in your own config file. Do not send a value back to Forge; no Forge endpoint accepts one.
- This entry needs 2 credentials (1 required). The generated config carries placeholders, so it will fail in the editor rather than at runtime if they are left unset.

## Blast radius

Moderate blast radius — runs locally and hosted; holds an api key.
- Floor 29, ceiling 29 (tier: moderate)
- This is impact, not likelihood. A high radius is not a defect: a filesystem server is supposed to write files. It is never part of the trust score.

## Machine-readable views of this entry

- Signed JSON: https://forgeregistry.com/api/v1/packages/%40mobileproxy%2Fmcp-server
- Install plan: https://forgeregistry.com/api/v1/packages/%40mobileproxy%2Fmcp-server/install-plan
- Alternatives: https://forgeregistry.com/api/v1/alternatives/%40mobileproxy%2Fmcp-server
- HTML page: https://forgeregistry.com/registry/%40mobileproxy%2Fmcp-server
- MCP: POST https://forgeregistry.com/api/mcp → `forge_get_package` / `forge_install_plan`

## About this document

Generated by Forge (https://forgeregistry.com) — a compact rendering of the same record served, signed, at the JSON URL above. Trust and scan facts are the registry's own measurements; anything Forge did not measure is named as unmeasured rather than omitted.
