Skip to content
MCP server

mobileproxy

MCP server letting AI agents manage your 4G mobile and residential proxies

Install

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/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.mpsapi.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.mpsapi.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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/mcp

Enter a Name (for example "mobileproxy"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

Full Grok Bot setup guide

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?apiRequired
  • 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_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.

How AIPoweredBot checks servers