# ProxyClaw MCP server

> Provides access to a residential proxy network for fetching URLs and checking IP locations with country, state, and city targeting.

- Repository: https://github.com/Iploop/proxyclaw-mcp
- Page: https://hostedmcp.org/servers/iploop/proxyclaw-mcp
- Transport: stdio
- Stars: 1
- Latest version: 1.0.4

## Install

### Claude Code

```sh
claude mcp add --env 'IPLOOP_API_KEY=<YOUR_IPLOOP_API_KEY>' proxyclaw-mcp -- npx -y proxyclaw-mcp-server
```

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

```json
{
  "mcpServers": {
    "proxyclaw-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "proxyclaw-mcp-server"
      ],
      "env": {
        "IPLOOP_API_KEY": "<YOUR_IPLOOP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "proxyclaw-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "proxyclaw-mcp-server"
      ],
      "env": {
        "IPLOOP_API_KEY": "<YOUR_IPLOOP_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"proxyclaw-mcp","type":"stdio","command":"npx","args":["-y","proxyclaw-mcp-server"],"env":{"IPLOOP_API_KEY":"<YOUR_IPLOOP_API_KEY>"}}'
```

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

```json
{
  "mcpServers": {
    "proxyclaw-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "proxyclaw-mcp-server"
      ],
      "env": {
        "IPLOOP_API_KEY": "<YOUR_IPLOOP_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add proxyclaw-mcp --env 'IPLOOP_API_KEY=<YOUR_IPLOOP_API_KEY>' -- npx -y proxyclaw-mcp-server
```

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

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

[mcp_servers.proxyclaw-mcp.env]
IPLOOP_API_KEY = "<YOUR_IPLOOP_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'IPLOOP_API_KEY=<YOUR_IPLOOP_API_KEY>' proxyclaw-mcp npx -- -y proxyclaw-mcp-server
```

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

```json
{
  "mcpServers": {
    "proxyclaw-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "proxyclaw-mcp-server"
      ],
      "env": {
        "IPLOOP_API_KEY": "<YOUR_IPLOOP_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `IPLOOP_API_KEY` | yes | yes | Your ProxyClaw API key from iploop.io |
| `IPLOOP_PROXY_PASSWORD` | no | no |  |
| `IPLOOP_PROXY_USERNAME` | no | no |  |

## Tools (4)

- `proxy_fetch`: Fetch a URL through the ProxyClaw residential proxy network. Routes the request through real residential IPs in 195+ countries. Use for geo-restricted content, anti-bot bypass, or multi-country research.
- `proxy_check_ip`: Check the current exit IP address and geo-location when routing through the proxy. Useful to verify which country/region your requests are coming from.
- `proxy_list_countries`: List all 195+ countries available for routing through the ProxyClaw residential network.
- `proxy_rotate`: Force IP rotation by fetching with a new random session. Returns the new exit IP to confirm rotation worked.

## FAQ

### How do I configure the server?

Configure your MCP client to run Node using the absolute path to the dist/index.js file and provide your IPLOOP API key, username, and password in the environment variables.

### Can I target specific locations?

Yes, you can pass country, state, and city parameters to the proxy_fetch tool, though exact-city accuracy is not certified.

### What tools are available in this server?

The server includes tools for fetching URLs, checking IP exit locations, listing reference country codes, and rotating proxy sessions.
