mobileproxy
MCP server letting AI agents manage your 4G mobile and residential proxies
mobileproxy is an MCP server for mcp data access. It can run locally on your machine or as a hosted remote server.
- Platforms
- CLI, API, macOS
- Runs
- Locally or Remotely
- Version
- 0.6.1
- Listing updated
Similar MCP servers
Install
Run in a terminal
claude mcp add --transport http mcp-server https://mcp.mpsapi.com/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.mpsapi.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.mpsapi.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "http",
"url": "https://mcp.mpsapi.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-server": {
"serverUrl": "https://mcp.mpsapi.com/mcp"
}
}
}Add to Grok Bot desktop app → Connect apps → Add a custom connector
https://mcp.mpsapi.com/mcpEnter a Name (for example "mobileproxy"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.
Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-server": {
"type": "http",
"url": "https://mcp.mpsapi.com/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
MOBILEPROXY_API_KEYAPI token from https://mobileproxy.space/user.html?apiRequiredMOBILEPROXY_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 logsADSPOWER_API_KEYAdsPower Local API key, only if its security verification is on (for attach_proxy_to_adspower)
About mobileproxy
Lets an AI assistant such as Claude or Cursor look up, rotate and configure proxies bought from mobileproxy.space. Each mobile proxy is a dedicated 4G/LTE modem with a carrier IP that stays assigned to you, and it can be rotated on demand. Requests are made in plain language, for example asking which proxies are expiring or moving a proxy to another country.
The server exposes tools for account health, connection strings, free modems by geo, IP rotation, rotating until an IP is clean of spam blacklists, and a TCP fingerprint setting that makes traffic resemble a chosen operating system. Residential traffic bundles get their own plan, geo and top-up tools. Purchase and renewal tools can run as dry-run quotes before any balance is charged.
It suits people who test sites and apps as seen from mobile users in a given country, run ad or price checks by geo, or manage a fleet of proxies in AdsPower browser profiles. A hosted endpoint is also available so nothing needs installing locally.
Tools this server provides (16)
Taken from the project documentation; the running server may differ.
- get_health_snapshot
- Shows expiring proxies, residential packages low on traffic and optionally blacklisted IPs.
- list_proxies
- Lists all proxies with connection details, filterable by type or country.
- get_proxy_status
- Returns the current external IP of a proxy with an optional spam-blacklist check.
- get_connection_string
- Returns http and socks5 URLs, an import line, a curl test and the change-IP link.
- get_balance
- Returns the account balance in RUB and any partner payout amount.
- update_proxy_settings
- Changes auto-renewal, comment and automatic IP-rotation timer for up to 100 proxies.
- change_proxy_credentials
- Sets a new login and password for up to 50 proxies.
- reboot_modem
- Power-cycles the modem behind a stuck mobile proxy, once per 30 minutes.
- find_available_geo
- Lists free modems in a country or city, operators and prices per period.
- rotate_ip
- Requests a new exit IP for a mobile or residential proxy.
- rotate_until_clean
- Rotates a mobile proxy until its IP is on no spam blacklist.
- change_geo
- Moves a proxy to another country or operator.
- set_tcp_fingerprint
- Applies a TCP fingerprint profile to up to 50 proxies.
- diagnose_tcp_fingerprint
- Shows what fingerprinting endpoints observe through the proxy.
- set_residential_geo
- Reads or changes geo targeting and rotating or sticky mode for residential proxies.
- attach_proxy_to_adspower
- Writes a proxy into an AdsPower browser profile through the local API.
What it does
- Proxy health overview
- Summarises expiring proxies, low residential traffic and optionally blacklisted IPs in one check.
- Connection string export
- Returns HTTP and SOCKS5 URLs, a host:port:login:password import line and a curl test.
- IP rotation and cleanup
- Rotates a mobile proxy's IP, or keeps rotating until it appears on no spam blacklist.
- Geo and operator changes
- Moves a proxy to another country or operator without buying a new one.
- TCP fingerprint profiles
- Applies OS network signatures such as Windows, iPhone or Android to proxied traffic.
- Dry-run purchase quotes
- Estimates the cost of purchases and renewals before any balance is charged.
Good for
- Testing how sites and apps appear to mobile users on a specific carrier and country
- Checking localized ads, prices and availability by geo
- Rotating a proxy IP until it is clean of spam blacklists
- Attaching proxies to AdsPower browser profiles from a chat session
- Keeping an overview of expiring proxies and residential traffic left
mobileproxy FAQ
How do I install mobileproxy?
Download the mcpb file for Claude Desktop, run one Claude Code command with npx, add the JSON block to Cursor or Windsurf, or use the Docker image. A hosted endpoint at mcp.mpsapi.com/mcp needs no installation.
Are purchases made without confirmation?
Purchase tools can run in estimate-only mode first, and the agent asks for approval before charging the balance. The hosted endpoint returns quotes with a dashboard link instead of charging.
Which clients are supported?
Claude Desktop, Claude Code and Cursor are supported, and Windsurf works like Cursor. Cowork does not substitute environment variables in config.
Is the server open source?
The package is released under the MIT licence and is available on GitHub and npm.
How do I add mobileproxy to Claude Code?
Run this command in your terminal: claude mcp add --transport http mcp-server https://mcp.mpsapi.com/mcp
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.