# Novada Proxy MCP server

> Route HTTP requests through residential IPs to bypass anti-bot systems, geo-target content, and maintain sticky sessions for AI agents.

- Repository: https://github.com/NovadaLabs/proxy4agent
- Page: https://hostedmcp.org/servers/novadalabs/proxy4agent
- Transport: stdio
- Stars: 4
- License: MIT
- Latest version: 1.7.0

## Install

### Claude Code

```sh
claude mcp add --env 'BRIGHTDATA_PASS=<YOUR_BRIGHTDATA_PASS>' --env 'BRIGHTDATA_USER=<YOUR_BRIGHTDATA_USER>' --env 'NOVADA_API_KEY=<YOUR_NOVADA_API_KEY>' --env 'NOVADA_BROWSER_WS=<YOUR_NOVADA_BROWSER_WS>' --env 'NOVADA_PROXY_PASS=<YOUR_NOVADA_PROXY_PASS>' --env 'NOVADA_PROXY_USER=<YOUR_NOVADA_PROXY_USER>' --env 'OXYLABS_PASS=<YOUR_OXYLABS_PASS>' --env 'OXYLABS_USER=<YOUR_OXYLABS_USER>' --env 'PROXY_URL=<YOUR_PROXY_URL>' --env 'SMARTPROXY_PASS=<YOUR_SMARTPROXY_PASS>' --env 'SMARTPROXY_USER=<YOUR_SMARTPROXY_USER>' proxy4agent -- npx -y bestproxy4agents-mcp
```

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

```json
{
  "mcpServers": {
    "proxy4agent": {
      "command": "npx",
      "args": [
        "-y",
        "bestproxy4agents-mcp"
      ],
      "env": {
        "BRIGHTDATA_PASS": "<YOUR_BRIGHTDATA_PASS>",
        "BRIGHTDATA_USER": "<YOUR_BRIGHTDATA_USER>",
        "NOVADA_API_KEY": "<YOUR_NOVADA_API_KEY>",
        "NOVADA_BROWSER_WS": "<YOUR_NOVADA_BROWSER_WS>",
        "NOVADA_PROXY_PASS": "<YOUR_NOVADA_PROXY_PASS>",
        "NOVADA_PROXY_USER": "<YOUR_NOVADA_PROXY_USER>",
        "OXYLABS_PASS": "<YOUR_OXYLABS_PASS>",
        "OXYLABS_USER": "<YOUR_OXYLABS_USER>",
        "PROXY_URL": "<YOUR_PROXY_URL>",
        "SMARTPROXY_PASS": "<YOUR_SMARTPROXY_PASS>",
        "SMARTPROXY_USER": "<YOUR_SMARTPROXY_USER>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "proxy4agent": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "bestproxy4agents-mcp"
      ],
      "env": {
        "BRIGHTDATA_PASS": "<YOUR_BRIGHTDATA_PASS>",
        "BRIGHTDATA_USER": "<YOUR_BRIGHTDATA_USER>",
        "NOVADA_API_KEY": "<YOUR_NOVADA_API_KEY>",
        "NOVADA_BROWSER_WS": "<YOUR_NOVADA_BROWSER_WS>",
        "NOVADA_PROXY_PASS": "<YOUR_NOVADA_PROXY_PASS>",
        "NOVADA_PROXY_USER": "<YOUR_NOVADA_PROXY_USER>",
        "OXYLABS_PASS": "<YOUR_OXYLABS_PASS>",
        "OXYLABS_USER": "<YOUR_OXYLABS_USER>",
        "PROXY_URL": "<YOUR_PROXY_URL>",
        "SMARTPROXY_PASS": "<YOUR_SMARTPROXY_PASS>",
        "SMARTPROXY_USER": "<YOUR_SMARTPROXY_USER>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"proxy4agent","type":"stdio","command":"npx","args":["-y","bestproxy4agents-mcp"],"env":{"BRIGHTDATA_PASS":"<YOUR_BRIGHTDATA_PASS>","BRIGHTDATA_USER":"<YOUR_BRIGHTDATA_USER>","NOVADA_API_KEY":"<YOUR_NOVADA_API_KEY>","NOVADA_BROWSER_WS":"<YOUR_NOVADA_BROWSER_WS>","NOVADA_PROXY_PASS":"<YOUR_NOVADA_PROXY_PASS>","NOVADA_PROXY_USER":"<YOUR_NOVADA_PROXY_USER>","OXYLABS_PASS":"<YOUR_OXYLABS_PASS>","OXYLABS_USER":"<YOUR_OXYLABS_USER>","PROXY_URL":"<YOUR_PROXY_URL>","SMARTPROXY_PASS":"<YOUR_SMARTPROXY_PASS>","SMARTPROXY_USER":"<YOUR_SMARTPROXY_USER>"}}'
```

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

```json
{
  "mcpServers": {
    "proxy4agent": {
      "command": "npx",
      "args": [
        "-y",
        "bestproxy4agents-mcp"
      ],
      "env": {
        "BRIGHTDATA_PASS": "<YOUR_BRIGHTDATA_PASS>",
        "BRIGHTDATA_USER": "<YOUR_BRIGHTDATA_USER>",
        "NOVADA_API_KEY": "<YOUR_NOVADA_API_KEY>",
        "NOVADA_BROWSER_WS": "<YOUR_NOVADA_BROWSER_WS>",
        "NOVADA_PROXY_PASS": "<YOUR_NOVADA_PROXY_PASS>",
        "NOVADA_PROXY_USER": "<YOUR_NOVADA_PROXY_USER>",
        "OXYLABS_PASS": "<YOUR_OXYLABS_PASS>",
        "OXYLABS_USER": "<YOUR_OXYLABS_USER>",
        "PROXY_URL": "<YOUR_PROXY_URL>",
        "SMARTPROXY_PASS": "<YOUR_SMARTPROXY_PASS>",
        "SMARTPROXY_USER": "<YOUR_SMARTPROXY_USER>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add proxy4agent --env 'BRIGHTDATA_PASS=<YOUR_BRIGHTDATA_PASS>' --env 'BRIGHTDATA_USER=<YOUR_BRIGHTDATA_USER>' --env 'NOVADA_API_KEY=<YOUR_NOVADA_API_KEY>' --env 'NOVADA_BROWSER_WS=<YOUR_NOVADA_BROWSER_WS>' --env 'NOVADA_PROXY_PASS=<YOUR_NOVADA_PROXY_PASS>' --env 'NOVADA_PROXY_USER=<YOUR_NOVADA_PROXY_USER>' --env 'OXYLABS_PASS=<YOUR_OXYLABS_PASS>' --env 'OXYLABS_USER=<YOUR_OXYLABS_USER>' --env 'PROXY_URL=<YOUR_PROXY_URL>' --env 'SMARTPROXY_PASS=<YOUR_SMARTPROXY_PASS>' --env 'SMARTPROXY_USER=<YOUR_SMARTPROXY_USER>' -- npx -y bestproxy4agents-mcp
```

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

```toml
[mcp_servers.proxy4agent]
command = "npx"
args = ["-y", "bestproxy4agents-mcp"]

[mcp_servers.proxy4agent.env]
BRIGHTDATA_PASS = "<YOUR_BRIGHTDATA_PASS>"
BRIGHTDATA_USER = "<YOUR_BRIGHTDATA_USER>"
NOVADA_API_KEY = "<YOUR_NOVADA_API_KEY>"
NOVADA_BROWSER_WS = "<YOUR_NOVADA_BROWSER_WS>"
NOVADA_PROXY_PASS = "<YOUR_NOVADA_PROXY_PASS>"
NOVADA_PROXY_USER = "<YOUR_NOVADA_PROXY_USER>"
OXYLABS_PASS = "<YOUR_OXYLABS_PASS>"
OXYLABS_USER = "<YOUR_OXYLABS_USER>"
PROXY_URL = "<YOUR_PROXY_URL>"
SMARTPROXY_PASS = "<YOUR_SMARTPROXY_PASS>"
SMARTPROXY_USER = "<YOUR_SMARTPROXY_USER>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'BRIGHTDATA_PASS=<YOUR_BRIGHTDATA_PASS>' -e 'BRIGHTDATA_USER=<YOUR_BRIGHTDATA_USER>' -e 'NOVADA_API_KEY=<YOUR_NOVADA_API_KEY>' -e 'NOVADA_BROWSER_WS=<YOUR_NOVADA_BROWSER_WS>' -e 'NOVADA_PROXY_PASS=<YOUR_NOVADA_PROXY_PASS>' -e 'NOVADA_PROXY_USER=<YOUR_NOVADA_PROXY_USER>' -e 'OXYLABS_PASS=<YOUR_OXYLABS_PASS>' -e 'OXYLABS_USER=<YOUR_OXYLABS_USER>' -e 'PROXY_URL=<YOUR_PROXY_URL>' -e 'SMARTPROXY_PASS=<YOUR_SMARTPROXY_PASS>' -e 'SMARTPROXY_USER=<YOUR_SMARTPROXY_USER>' proxy4agent npx -- -y bestproxy4agents-mcp
```

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

```json
{
  "mcpServers": {
    "proxy4agent": {
      "command": "npx",
      "args": [
        "-y",
        "bestproxy4agents-mcp"
      ],
      "env": {
        "BRIGHTDATA_PASS": "<YOUR_BRIGHTDATA_PASS>",
        "BRIGHTDATA_USER": "<YOUR_BRIGHTDATA_USER>",
        "NOVADA_API_KEY": "<YOUR_NOVADA_API_KEY>",
        "NOVADA_BROWSER_WS": "<YOUR_NOVADA_BROWSER_WS>",
        "NOVADA_PROXY_PASS": "<YOUR_NOVADA_PROXY_PASS>",
        "NOVADA_PROXY_USER": "<YOUR_NOVADA_PROXY_USER>",
        "OXYLABS_PASS": "<YOUR_OXYLABS_PASS>",
        "OXYLABS_USER": "<YOUR_OXYLABS_USER>",
        "PROXY_URL": "<YOUR_PROXY_URL>",
        "SMARTPROXY_PASS": "<YOUR_SMARTPROXY_PASS>",
        "SMARTPROXY_USER": "<YOUR_SMARTPROXY_USER>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `BRIGHTDATA_PASS` | no | yes | BrightData proxy password |
| `BRIGHTDATA_USER` | no | yes | BrightData full username including zone |
| `NOVADA_API_KEY` | no | yes | Novada Scraper API key for search tool |
| `NOVADA_BROWSER_WS` | no | yes | Novada Browser API WebSocket URL for render tool |
| `NOVADA_PROXY_PASS` | no | yes | Novada residential proxy password |
| `NOVADA_PROXY_USER` | no | yes | Novada residential proxy username |
| `OXYLABS_PASS` | no | yes | Oxylabs password |
| `OXYLABS_USER` | no | yes | Oxylabs username |
| `PROXY_URL` | no | yes | Generic HTTP proxy URL (http://user:pass@host:port) |
| `SMARTPROXY_PASS` | no | yes | Smartproxy password |
| `SMARTPROXY_USER` | no | yes | Smartproxy username |

## Tools (30)

- `novada_proxy_fetch`
- `novada_proxy_batch_fetch`
- `novada_proxy_extract`
- `novada_proxy_map`
- `novada_proxy_crawl`
- `novada_proxy_session`
- `novada_proxy_search`
- `novada_proxy_render`
- `novada_proxy_research`
- `novada_proxy_status`
- `url`
- `country`
- `city`
- `session_id`
- `format`
- `timeout`
- `urls`
- `concurrency`
- `fields`
- `render_fallback`
- `limit`
- `include_external`
- `verify_sticky`
- `query`
- `num`
- `language`
- `wait_for`
- `depth`
- `include_content`
- `schema`

## FAQ

### How can I bypass anti-bot systems like Cloudflare or Akamai?

The server routes your requests through over 2 million real residential IPs from devices like Android phones, Windows PCs, and Macs, making them indistinguishable from human browsers.

### Can I use this with other proxy providers?

Yes, the server is designed to work with any HTTP proxy provider, including BrightData, Smartproxy, and Oxylabs.

### Does it support JavaScript-heavy websites?

Yes, by using the `novada_proxy_render` tool, you can render JS-heavy pages using a real Chromium instance.
