# proxy-scraper MCP server

> Provides verified HTTP, SOCKS4, and SOCKS5 proxy lists that are rebuilt hourly through automated handshake and content checks.

- Repository: https://github.com/maximilianfeix/proxy-scraper
- Page: https://hostedmcp.org/servers/maximilianfeix/proxy-scraper
- Transport: stdio
- Stars: 94
- License: MIT
- Latest version: 1.34.0

## Install

### Claude Code

```sh
claude mcp add proxy-scraper -- uvx proxy-scraper-cli
```

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

```json
{
  "mcpServers": {
    "proxy-scraper": {
      "command": "uvx",
      "args": [
        "proxy-scraper-cli"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "proxy-scraper": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "proxy-scraper-cli"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"proxy-scraper","type":"stdio","command":"uvx","args":["proxy-scraper-cli"]}'
```

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

```json
{
  "mcpServers": {
    "proxy-scraper": {
      "command": "uvx",
      "args": [
        "proxy-scraper-cli"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add proxy-scraper -- uvx proxy-scraper-cli
```

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

```toml
[mcp_servers.proxy-scraper]
command = "uvx"
args = ["proxy-scraper-cli"]
```

### Gemini CLI

```sh
gemini mcp add -s user proxy-scraper uvx -- proxy-scraper-cli
```

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

```json
{
  "mcpServers": {
    "proxy-scraper": {
      "command": "uvx",
      "args": [
        "proxy-scraper-cli"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `PROXY_SCRAPER_SERVE_PASSWORD` | no | no |  |

## FAQ

### How often are the proxy lists updated?

The proxy lists are rebuilt approximately every hour.

### How do you ensure the proxies in the list actually work?

Proxies must pass several checks, including a handshake, a second request to an unrelated site to confirm the exit IP, and a content check to ensure data integrity.

### Do I need an API key to use these proxies?

No, there is no signup or API key required to access the lists.

### Is it safe to use these proxies for sensitive information?

No, you should never use free proxies for logins, payments, or personal data.
