io.github.NovadaLabs/proxy4agents-mcp MCP Server

Name: io.github.NovadaLabs/proxy4agents-mcp MCP Server
Author: io.github.NovadaLabs

io.github.NovadaLabs/proxy4agents-mcp

Repository Registry

What is the io.github.NovadaLabs/proxy4agents-mcp MCP server?

Residential proxy MCP for AI agents — geo-targeting, sticky sessions, anti-bot bypass.

How to install io.github.NovadaLabs/proxy4agents-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

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

Cursor

~/.cursor/mcp.json

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

Windsurf

~/.codeium/windsurf/mcp_config.json

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

VS Code

.vscode/mcp.json

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

Claude Code

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