# mobileproxy

> mobileproxy is an MCP server for mcp data access. MCP server letting AI agents manage your 4G mobile and residential proxies. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Platforms:** CLI, API, macOS, Windows, Linux, Web, VS Code
- **Repository:** https://github.com/mobileproxy/mcp-server
- **MCP Registry name:** io.github.mobileproxy/mcp-server
- **Categories:** [mcp data access](https://ai-powered.com/categories/mcp-data-access)
- **Listing updated:** 2026-11-21

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp-server https://mcp.mpsapi.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.mpsapi.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.mpsapi.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.mpsapi.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "serverUrl": "https://mcp.mpsapi.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
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.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.mpsapi.com/mcp"
    }
  }
}
```

## Tools

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

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

## Alternatives

- [AeonProxy](https://ai-powered.com/mcp/aeonproxy): AeonProxy is a freemium MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/mobileproxy
