Mcp Server
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.
- tools
- 28
- auth
- Secret needed
- transport
- STDIO, HTTP
- env vars
- 5
- last updated
- Oct 11, 2026
Tools
28 toolsPublic tool metadata for what this MCP can expose to an agent.
get_health_snapshotWhat needs attention: expiring proxies (with auto-renewal state), residential packages low on traffic, optionally blacklisted IPs
What needs attention: expiring proxies (with auto-renewal state), residential packages low on traffic, optionally blacklisted IPs
No parameter schema in public metadata yet.
list_proxiesAll proxies with connection details; filter by type or country
All proxies with connection details; filter by type or country
No parameter schema in public metadata yet.
get_proxy_statusCurrent external IP of a proxy + optional spam-blacklist check
Current external IP of a proxy + optional spam-blacklist check
No parameter schema in public metadata yet.
get_connection_stringhttp:// / socks5:// URLs, a host:port:login:password import line, a curl test, and the change-IP link
http:// / socks5:// URLs, a host:port:login:password import line, a curl test, and the change-IP link
No parameter schema in public metadata yet.
get_balanceBalance in RUB + partner payout amount if any
Balance in RUB + partner payout amount if any
No parameter schema in public metadata yet.
get_account_historyTop-ups, purchases, renewals and refunds with receipt links
Top-ups, purchases, renewals and refunds with receipt links
No parameter schema in public metadata yet.
update_proxy_settingsAuto-renewal, comment and automatic IP-rotation timer for up to 100 proxies at once
Auto-renewal, comment and automatic IP-rotation timer for up to 100 proxies at once
No parameter schema in public metadata yet.
change_proxy_credentialsNew login and password for up to 50 proxies, e.g. after a leak
New login and password for up to 50 proxies, e.g. after a leak
No parameter schema in public metadata yet.
reboot_modemPower-cycle the modem behind a stuck mobile proxy (once per 30 min)
Power-cycle the modem behind a stuck mobile proxy (once per 30 min)
No parameter schema in public metadata yet.
find_available_geoFree modems in a country or city, operators that have them, and prices per period — in one call
Free modems in a country or city, operators that have them, and prices per period — in one call
No parameter schema in public metadata yet.
get_geo_listAll locations (geoid, ISO, free-modem count); filter by country
All locations (geoid, ISO, free-modem count); filter by country
No parameter schema in public metadata yet.
get_pricePrices for every rental period (1/3/7/14/30/60/90/180/365 d) in a country
Prices for every rental period (1/3/7/14/30/60/90/180/365 d) in a country
No parameter schema in public metadata yet.
rotate_ipNew exit IP: mobile proxies reconnect to the carrier; sticky residential proxies get a new peer
New exit IP: mobile proxies reconnect to the carrier; sticky residential proxies get a new peer
No parameter schema in public metadata yet.
rotate_until_cleanRotate a mobile proxy until its IP is on no spam blacklist; keep_if_clean keeps a good current IP
Rotate a mobile proxy until its IP is on no spam blacklist; keep_if_clean keeps a good current IP
No parameter schema in public metadata yet.
change_geoMove a proxy to another country or operator without re-buying
Move a proxy to another country or operator without re-buying
No parameter schema in public metadata yet.
buy_proxyBuy proxies — charges the balance (hosted: quote_proxy_purchase)
Buy proxies — charges the balance (hosted: quote_proxy_purchase)
No parameter schema in public metadata yet.
renew_proxiesExtend up to 100 proxies by a period — charges the balance (hosted: quote_renewal)
Extend up to 100 proxies by a period — charges the balance (hosted: quote_renewal)
No parameter schema in public metadata yet.
list_tcp_profilesPresets: Android, iPhone, Windows, macOS, Linux…
Presets: Android, iPhone, Windows, macOS, Linux…
No parameter schema in public metadata yet.
get_tcp_fingerprintWhich profile each proxy currently presents (null = native)
Which profile each proxy currently presents (null = native)
No parameter schema in public metadata yet.
set_tcp_fingerprintApply a profile to up to 50 proxies; profile_id=0 restores native. Reaches the equipment within a minute
Apply a profile to up to 50 proxies; profile_id=0 restores native. Reaches the equipment within a minute
No parameter schema in public metadata yet.
diagnose_tcp_fingerprintWhat fingerprinting endpoints observe through the proxy vs. the applied profile (up to ~45 s)
What fingerprinting endpoints observe through the proxy vs. the applied profile (up to ~45 s)
No parameter schema in public metadata yet.
list_residential_plansGB bundles with price per GB
GB bundles with price per GB
No parameter schema in public metadata yet.
get_residential_locationsCountries / regions / cities / ASNs valid for geo targeting
Countries / regions / cities / ASNs valid for geo targeting
No parameter schema in public metadata yet.
get_residential_trafficDaily consumption and burn rate
Daily consumption and burn rate
No parameter schema in public metadata yet.
set_residential_geoRead or change geo targeting and rotating/sticky mode — free and reversible
Read or change geo targeting and rotating/sticky mode — free and reversible
No parameter schema in public metadata yet.
buy_residentialBuy a traffic bundle — charges the balance (hosted: quote_residential_purchase)
Buy a traffic bundle — charges the balance (hosted: quote_residential_purchase)
No parameter schema in public metadata yet.
add_residential_trafficTop up a package, keeping its geo and connection string (hosted: quote_residential_topup)
Top up a package, keeping its geo and connection string (hosted: quote_residential_topup)
No parameter schema in public metadata yet.
attach_proxy_to_adspowerWrite a proxy (and the change-IP link) into an AdsPower browser profile — experimental, local build only
Write a proxy (and the change-IP link) into an AdsPower browser profile — experimental, local build only
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
MOBILEPROXY_API_KEY*secretAPI token from https://mobileproxy.space/user.html?api
MOBILEPROXY_API_BASEOverride REST API base URL (default https://mpsapi.com)
MOBILEPROXY_TIMEOUT_MSHTTP request timeout in milliseconds (default 30000)
MOBILEPROXY_DEBUGSet to 1 for verbose stderr logs
ADSPOWER_API_KEYsecretAdsPower Local API key, only if its security verification is on (for attach_proxy_to_adspower)
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.
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
Details
- Repository
- github.com/mobileproxy/mcp-server
- Category
- Mobile Development
- Package
@mobileproxy/mcp-server- Transport
- STDIO, HTTP
- Auth
- Required
- Registry
- MCP registry, active
Related Mobile Development MCP servers
View all
Remote Cameramoda.ai/remote-cameraCapture photos remotely from mobile devices via S3-backed upload URLs0stars
Prospeo Mcp Serverprospeo-v2/prospeo-mcp-serverProspeo: Find, search, and enrich people and companies with verified emails and mobile numbers.0stars
Siteauditthegridwork/siteauditAudit websites for accessibility, performance, SEO, design, and mobile. 47 WCAG checks.0stars
Electronics MCP Serverswedsamuel1230/electronic-mcp-server14 electronics tools: resistor decoder, capacitor calculator, GPIO reference for ESP32/Arduino/STM320stars
Singapore Proxy Mcpxavierfok/singapore-proxy-mcpBrowse the web and run Google search through real Singapore mobile carrier IPs.0stars