# mobileproxy.space MCP server

> Allows AI agents to manage dedicated 4G/LTE mobile and residential proxies, including IP rotation, geo-targeting, and TCP fingerprinting.

- Repository: https://github.com/mobileproxy/mcp-server
- Page: https://hostedmcp.org/servers/mobileproxy/mcp-server
- Transport: stdio, remote
- Stars: 0
- License: MIT
- Latest version: 0.6.1

## Install

### Claude Code

```sh
claude mcp add --env 'MOBILEPROXY_API_KEY=<YOUR_MOBILEPROXY_API_KEY>' --env 'ADSPOWER_API_KEY=<YOUR_ADSPOWER_API_KEY>' mcp-server -- npx -y @mobileproxy/mcp-server
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@mobileproxy/mcp-server"
      ],
      "env": {
        "MOBILEPROXY_API_KEY": "<YOUR_MOBILEPROXY_API_KEY>",
        "ADSPOWER_API_KEY": "<YOUR_ADSPOWER_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mobileproxy/mcp-server"
      ],
      "env": {
        "MOBILEPROXY_API_KEY": "<YOUR_MOBILEPROXY_API_KEY>",
        "ADSPOWER_API_KEY": "<YOUR_ADSPOWER_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@mobileproxy/mcp-server"],"env":{"MOBILEPROXY_API_KEY":"<YOUR_MOBILEPROXY_API_KEY>","ADSPOWER_API_KEY":"<YOUR_ADSPOWER_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@mobileproxy/mcp-server"
      ],
      "env": {
        "MOBILEPROXY_API_KEY": "<YOUR_MOBILEPROXY_API_KEY>",
        "ADSPOWER_API_KEY": "<YOUR_ADSPOWER_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add mcp-server --env 'MOBILEPROXY_API_KEY=<YOUR_MOBILEPROXY_API_KEY>' --env 'ADSPOWER_API_KEY=<YOUR_ADSPOWER_API_KEY>' -- npx -y @mobileproxy/mcp-server
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp-server]
command = "npx"
args = ["-y", "@mobileproxy/mcp-server"]

[mcp_servers.mcp-server.env]
MOBILEPROXY_API_KEY = "<YOUR_MOBILEPROXY_API_KEY>"
ADSPOWER_API_KEY = "<YOUR_ADSPOWER_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'MOBILEPROXY_API_KEY=<YOUR_MOBILEPROXY_API_KEY>' -e 'ADSPOWER_API_KEY=<YOUR_ADSPOWER_API_KEY>' mcp-server npx -- -y @mobileproxy/mcp-server
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@mobileproxy/mcp-server"
      ],
      "env": {
        "MOBILEPROXY_API_KEY": "<YOUR_MOBILEPROXY_API_KEY>",
        "ADSPOWER_API_KEY": "<YOUR_ADSPOWER_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `MOBILEPROXY_API_KEY` | yes | yes | API token from https://mobileproxy.space/user.html?api |
| `ADSPOWER_API_KEY` | no | yes | AdsPower Local API key, only if its security verification is on (for attach_proxy_to_adspower) |
| `MOBILEPROXY_API_BASE` | no | no | Override REST API base URL (default https://mpsapi.com) |
| `MOBILEPROXY_DEBUG` | no | no | Set to 1 for verbose stderr logs |
| `MOBILEPROXY_TIMEOUT_MS` | no | no | HTTP request timeout in milliseconds (default 30000) |

## Tools (28)

- `get_health_snapshot`
- `list_proxies`
- `get_proxy_status`
- `get_connection_string`
- `get_balance`
- `get_account_history`
- `update_proxy_settings`
- `change_proxy_credentials`
- `reboot_modem`
- `find_available_geo`
- `get_geo_list`
- `get_price`
- `rotate_ip`
- `rotate_until_clean`
- `change_geo`
- `buy_proxy`
- `renew_proxies`
- `list_tcp_profiles`
- `get_tcp_fingerprint`
- `set_tcp_fingerprint`
- `diagnose_tcp_fingerprint`
- `list_residential_plans`
- `get_residential_locations`
- `get_residential_traffic`
- `set_residential_geo`
- `buy_residential`
- `add_residential_traffic`
- `attach_proxy_to_adspower`

## FAQ

### What can I do with the mobile proxies?

You can rotate IPs on demand, change the country or operator, check connection status, and set TCP fingerprints to mimic specific devices like iPhones or Windows desktops.

### Does the server store my API key?

No, the server does not keep a copy of your key; each request carries it or an encrypted OAuth token.