Residential proxy MCP server for AI agents — bypass Cloudflare/Akamai, geo-target 195+ countries, sticky sessions. Multi-provider: Novada, BrightData, Smartproxy, Oxylabs.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add proxy-veil --env NOVADA_PROXY_USER='<NOVADA_PROXY_USER>' --env NOVADA_PROXY_PASS='<NOVADA_PROXY_PASS>' --env NOVADA_API_KEY='<NOVADA_API_KEY>' --env BRIGHTDATA_USER='<BRIGHTDATA_USER>' --env BRIGHTDATA_PASS='<BRIGHTDATA_PASS>' --env SMARTPROXY_USER='<SMARTPROXY_USER>' --env SMARTPROXY_PASS='<SMARTPROXY_PASS>' --env OXYLABS_USER='<OXYLABS_USER>' -- npx -y proxy-veil~/.codex/config.toml
[mcp_servers.proxy-veil]
command = "npx"
args = ["-y", "proxy-veil"]
env = { NOVADA_PROXY_USER = "<NOVADA_PROXY_USER>", NOVADA_PROXY_PASS = "<NOVADA_PROXY_PASS>", NOVADA_API_KEY = "<NOVADA_API_KEY>", BRIGHTDATA_USER = "<BRIGHTDATA_USER>", BRIGHTDATA_PASS = "<BRIGHTDATA_PASS>", SMARTPROXY_USER = "<SMARTPROXY_USER>", SMARTPROXY_PASS = "<SMARTPROXY_PASS>", OXYLABS_USER = "<OXYLABS_USER>" }
# codex mcp add proxy-veil --env NOVADA_PROXY_USER='<NOVADA_PROXY_USER>' --env NOVADA_PROXY_PASS='<NOVADA_PROXY_PASS>' --env NOVADA_API_KEY='<NOVADA_API_KEY>' --env BRIGHTDATA_USER='<BRIGHTDATA_USER>' --env BRIGHTDATA_PASS='<BRIGHTDATA_PASS>' --env SMARTPROXY_USER='<SMARTPROXY_USER>' --env SMARTPROXY_PASS='<SMARTPROXY_PASS>' --env OXYLABS_USER='<OXYLABS_USER>' -- npx -y proxy-veil~/.cursor/mcp.json
{
"mcpServers": {
"proxy-veil": {
"command": "npx",
"args": [
"-y",
"proxy-veil"
],
"env": {
"NOVADA_PROXY_USER": "<NOVADA_PROXY_USER>",
"NOVADA_PROXY_PASS": "<NOVADA_PROXY_PASS>",
"NOVADA_API_KEY": "<NOVADA_API_KEY>",
"BRIGHTDATA_USER": "<BRIGHTDATA_USER>",
"BRIGHTDATA_PASS": "<BRIGHTDATA_PASS>",
"SMARTPROXY_USER": "<SMARTPROXY_USER>",
"SMARTPROXY_PASS": "<SMARTPROXY_PASS>",
"OXYLABS_USER": "<OXYLABS_USER>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"proxy-veil": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"proxy-veil"
],
"env": {
"NOVADA_PROXY_USER": "<NOVADA_PROXY_USER>",
"NOVADA_PROXY_PASS": "<NOVADA_PROXY_PASS>",
"NOVADA_API_KEY": "<NOVADA_API_KEY>",
"BRIGHTDATA_USER": "<BRIGHTDATA_USER>",
"BRIGHTDATA_PASS": "<BRIGHTDATA_PASS>",
"SMARTPROXY_USER": "<SMARTPROXY_USER>",
"SMARTPROXY_PASS": "<SMARTPROXY_PASS>",
"OXYLABS_USER": "<OXYLABS_USER>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"proxy-veil": {
"command": "npx",
"args": [
"-y",
"proxy-veil"
],
"env": {
"NOVADA_PROXY_USER": "<NOVADA_PROXY_USER>",
"NOVADA_PROXY_PASS": "<NOVADA_PROXY_PASS>",
"NOVADA_API_KEY": "<NOVADA_API_KEY>",
"BRIGHTDATA_USER": "<BRIGHTDATA_USER>",
"BRIGHTDATA_PASS": "<BRIGHTDATA_PASS>",
"SMARTPROXY_USER": "<SMARTPROXY_USER>",
"SMARTPROXY_PASS": "<SMARTPROXY_PASS>",
"OXYLABS_USER": "<OXYLABS_USER>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"proxy-veil": {
"command": "npx",
"args": [
"-y",
"proxy-veil"
],
"env": {
"NOVADA_PROXY_USER": "<NOVADA_PROXY_USER>",
"NOVADA_PROXY_PASS": "<NOVADA_PROXY_PASS>",
"NOVADA_API_KEY": "<NOVADA_API_KEY>",
"BRIGHTDATA_USER": "<BRIGHTDATA_USER>",
"BRIGHTDATA_PASS": "<BRIGHTDATA_PASS>",
"SMARTPROXY_USER": "<SMARTPROXY_USER>",
"SMARTPROXY_PASS": "<SMARTPROXY_PASS>",
"OXYLABS_USER": "<OXYLABS_USER>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"proxy-veil": {
"command": "npx",
"args": [
"-y",
"proxy-veil"
],
"env": {
"NOVADA_PROXY_USER": "<NOVADA_PROXY_USER>",
"NOVADA_PROXY_PASS": "<NOVADA_PROXY_PASS>",
"NOVADA_API_KEY": "<NOVADA_API_KEY>",
"BRIGHTDATA_USER": "<BRIGHTDATA_USER>",
"BRIGHTDATA_PASS": "<BRIGHTDATA_PASS>",
"SMARTPROXY_USER": "<SMARTPROXY_USER>",
"SMARTPROXY_PASS": "<SMARTPROXY_PASS>",
"OXYLABS_USER": "<OXYLABS_USER>"
}
}
}
}Environment variables
NOVADA_PROXY_USERNOVADA_PROXY_PASSNOVADA_API_KEYBRIGHTDATA_USERBRIGHTDATA_PASSSMARTPROXY_USERSMARTPROXY_PASSOXYLABS_USER
Replace the placeholders with your own credentials and keep them out of version control.