Bestproxy4agents MCP Server
by novadalabsio.github.NovadaLabs/proxy4agents-mcpv1.7.0
Residential proxy MCP for AI agents — geo-targeting, sticky sessions, anti-bot bypass.
context tax
queued
security
queued
cold start
queued
freshness
Slowing4mo ago
Install Bestproxy4agents MCP server
Install in Claude Code
claude mcp add bestproxy4agents -e NOVADA_PROXY_USER='<novada-proxy-user>' -e NOVADA_PROXY_PASS='<novada-proxy-pass>' -e NOVADA_API_KEY='<novada-api-key>' -e NOVADA_BROWSER_WS='<novada-browser-ws>' -e BRIGHTDATA_USER='<brightdata-user>' -e BRIGHTDATA_PASS='<brightdata-pass>' -e SMARTPROXY_USER='<smartproxy-user>' -e SMARTPROXY_PASS='<smartproxy-pass>' -e OXYLABS_USER='<oxylabs-user>' -e OXYLABS_PASS='<oxylabs-pass>' -e PROXY_URL='<proxy-url>' -- npx -y bestproxy4agents-mcpInstall in Cursor
{
"mcpServers": {
"bestproxy4agents": {
"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>",
"OXYLABS_USER": "<oxylabs-user>",
"OXYLABS_PASS": "<oxylabs-pass>",
"PROXY_URL": "<proxy-url>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"bestproxy4agents": {
"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>",
"OXYLABS_USER": "<oxylabs-user>",
"OXYLABS_PASS": "<oxylabs-pass>",
"PROXY_URL": "<proxy-url>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"bestproxy4agents": {
"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>",
"OXYLABS_USER": "<oxylabs-user>",
"OXYLABS_PASS": "<oxylabs-pass>",
"PROXY_URL": "<proxy-url>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"bestproxy4agents": {
"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>",
"OXYLABS_USER": "<oxylabs-user>",
"OXYLABS_PASS": "<oxylabs-pass>",
"PROXY_URL": "<proxy-url>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| NOVADA_PROXY_USER | — | yes | Novada residential proxy username |
| NOVADA_PROXY_PASS | — | yes | Novada residential proxy password |
| NOVADA_API_KEY | — | yes | Novada Scraper API key for search tool |
| NOVADA_BROWSER_WS | — | yes | Novada Browser API WebSocket URL for render tool |
| BRIGHTDATA_USER | — | yes | BrightData full username including zone |
| BRIGHTDATA_PASS | — | yes | BrightData proxy password |
| SMARTPROXY_USER | — | yes | Smartproxy username |
| SMARTPROXY_PASS | — | yes | Smartproxy password |
| OXYLABS_USER | — | yes | Oxylabs username |
| OXYLABS_PASS | — | yes | Oxylabs password |
| PROXY_URL | — | yes | Generic HTTP proxy URL (http://user:pass@host:port) |
Freshness
Slowing — last maintenance signal 4mo ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-06-18 · 4mo ago · GitHub
Latest release
2026-04-13 · 6mo ago · GitHub · v1.7.1
Package published
no data · npm/PyPI
Registry entry updated
2026-04-10 · 6mo ago · official registry · v1.7.0
FAQ
›How do I install the Bestproxy4agents MCP server in Claude Code?
Run: claude mcp add bestproxy4agents -e NOVADA_PROXY_USER='<novada-proxy-user>' -e NOVADA_PROXY_PASS='<novada-proxy-pass>' -e NOVADA_API_KEY='<novada-api-key>' -e NOVADA_BROWSER_WS='<novada-browser-ws>' -e BRIGHTDATA_USER='<brightdata-user>' -e BRIGHTDATA_PASS='<brightdata-pass>' -e SMARTPROXY_USER='<smartproxy-user>' -e SMARTPROXY_PASS='<smartproxy-pass>' -e OXYLABS_USER='<oxylabs-user>' -e OXYLABS_PASS='<oxylabs-pass>' -e PROXY_URL='<proxy-url>' -- npx -y bestproxy4agents-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Bestproxy4agents require an API key?
Yes. It expects NOVADA_PROXY_USER, NOVADA_PROXY_PASS, NOVADA_API_KEY, NOVADA_BROWSER_WS, BRIGHTDATA_USER, BRIGHTDATA_PASS, SMARTPROXY_USER, SMARTPROXY_PASS, OXYLABS_USER, OXYLABS_PASS, PROXY_URL, of which 11 are secrets.
›Can I use Bestproxy4agents as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Bestproxy4agents in the official MCP registry?
Yes, as io.github.NovadaLabs/proxy4agents-mcp.