proxy4agents-mcp

Name: proxy4agents-mcp
Author: NovadaLabs

NovadaLabs

Get started Repository

Residential proxy MCP for AI agents — bypass Cloudflare and anti-bot walls. npm: novada-proxy-mcp.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add proxy4agents --env NOVADA_PROXY_USER='<NOVADA_PROXY_USER>' --env NOVADA_PROXY_PASS='<NOVADA_PROXY_PASS>' --env NOVADA_API_KEY='<NOVADA_API_KEY>' --env NOVADA_BROWSER_WS='<NOVADA_BROWSER_WS>' --env BRIGHTDATA_USER='<BRIGHTDATA_USER>' --env BRIGHTDATA_PASS='<BRIGHTDATA_PASS>' --env SMARTPROXY_USER='<SMARTPROXY_USER>' --env SMARTPROXY_PASS='<SMARTPROXY_PASS>' -- npx -y bestproxy4agents-mcp

~/.codex/config.toml

[mcp_servers.proxy4agents]
command = "npx"
args = ["-y", "bestproxy4agents-mcp"]
env = { NOVADA_PROXY_USER = "<NOVADA_PROXY_USER>", NOVADA_PROXY_PASS = "<NOVADA_PROXY_PASS>", NOVADA_API_KEY = "<NOVADA_API_KEY>", NOVADA_BROWSER_WS = "<NOVADA_BROWSER_WS>", BRIGHTDATA_USER = "<BRIGHTDATA_USER>", BRIGHTDATA_PASS = "<BRIGHTDATA_PASS>", SMARTPROXY_USER = "<SMARTPROXY_USER>", SMARTPROXY_PASS = "<SMARTPROXY_PASS>" }

# codex mcp add proxy4agents --env NOVADA_PROXY_USER='<NOVADA_PROXY_USER>' --env NOVADA_PROXY_PASS='<NOVADA_PROXY_PASS>' --env NOVADA_API_KEY='<NOVADA_API_KEY>' --env NOVADA_BROWSER_WS='<NOVADA_BROWSER_WS>' --env BRIGHTDATA_USER='<BRIGHTDATA_USER>' --env BRIGHTDATA_PASS='<BRIGHTDATA_PASS>' --env SMARTPROXY_USER='<SMARTPROXY_USER>' --env SMARTPROXY_PASS='<SMARTPROXY_PASS>' -- npx -y bestproxy4agents-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "proxy4agents": {
      "command": "npx",
      "args": [
        "-y",
        "bestproxy4agents-mcp"
      ],
      "env": {
        "NOVADA_PROXY_USER": "<NOVADA_PROXY_USER>",
        "NOVADA_PROXY_PASS": "<NOVADA_PROXY_PASS>",
        "NOVADA_API_KEY": "<NOVADA_API_KEY>",
        "NOVADA_BROWSER_WS": "<NOVADA_BROWSER_WS>",
        "BRIGHTDATA_USER": "<BRIGHTDATA_USER>",
        "BRIGHTDATA_PASS": "<BRIGHTDATA_PASS>",
        "SMARTPROXY_USER": "<SMARTPROXY_USER>",
        "SMARTPROXY_PASS": "<SMARTPROXY_PASS>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "proxy4agents": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "bestproxy4agents-mcp"
      ],
      "env": {
        "NOVADA_PROXY_USER": "<NOVADA_PROXY_USER>",
        "NOVADA_PROXY_PASS": "<NOVADA_PROXY_PASS>",
        "NOVADA_API_KEY": "<NOVADA_API_KEY>",
        "NOVADA_BROWSER_WS": "<NOVADA_BROWSER_WS>",
        "BRIGHTDATA_USER": "<BRIGHTDATA_USER>",
        "BRIGHTDATA_PASS": "<BRIGHTDATA_PASS>",
        "SMARTPROXY_USER": "<SMARTPROXY_USER>",
        "SMARTPROXY_PASS": "<SMARTPROXY_PASS>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "proxy4agents": {
      "command": "npx",
      "args": [
        "-y",
        "bestproxy4agents-mcp"
      ],
      "env": {
        "NOVADA_PROXY_USER": "<NOVADA_PROXY_USER>",
        "NOVADA_PROXY_PASS": "<NOVADA_PROXY_PASS>",
        "NOVADA_API_KEY": "<NOVADA_API_KEY>",
        "NOVADA_BROWSER_WS": "<NOVADA_BROWSER_WS>",
        "BRIGHTDATA_USER": "<BRIGHTDATA_USER>",
        "BRIGHTDATA_PASS": "<BRIGHTDATA_PASS>",
        "SMARTPROXY_USER": "<SMARTPROXY_USER>",
        "SMARTPROXY_PASS": "<SMARTPROXY_PASS>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "proxy4agents": {
      "command": "npx",
      "args": [
        "-y",
        "bestproxy4agents-mcp"
      ],
      "env": {
        "NOVADA_PROXY_USER": "<NOVADA_PROXY_USER>",
        "NOVADA_PROXY_PASS": "<NOVADA_PROXY_PASS>",
        "NOVADA_API_KEY": "<NOVADA_API_KEY>",
        "NOVADA_BROWSER_WS": "<NOVADA_BROWSER_WS>",
        "BRIGHTDATA_USER": "<BRIGHTDATA_USER>",
        "BRIGHTDATA_PASS": "<BRIGHTDATA_PASS>",
        "SMARTPROXY_USER": "<SMARTPROXY_USER>",
        "SMARTPROXY_PASS": "<SMARTPROXY_PASS>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "proxy4agents": {
      "command": "npx",
      "args": [
        "-y",
        "bestproxy4agents-mcp"
      ],
      "env": {
        "NOVADA_PROXY_USER": "<NOVADA_PROXY_USER>",
        "NOVADA_PROXY_PASS": "<NOVADA_PROXY_PASS>",
        "NOVADA_API_KEY": "<NOVADA_API_KEY>",
        "NOVADA_BROWSER_WS": "<NOVADA_BROWSER_WS>",
        "BRIGHTDATA_USER": "<BRIGHTDATA_USER>",
        "BRIGHTDATA_PASS": "<BRIGHTDATA_PASS>",
        "SMARTPROXY_USER": "<SMARTPROXY_USER>",
        "SMARTPROXY_PASS": "<SMARTPROXY_PASS>"
      }
    }
  }
}

Environment variables

NOVADA_PROXY_USER
NOVADA_PROXY_PASS
NOVADA_API_KEY
NOVADA_BROWSER_WS
BRIGHTDATA_USER
BRIGHTDATA_PASS
SMARTPROXY_USER
SMARTPROXY_PASS

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related