Proxy Veil

Proxy4Agent

Residential proxy MCP server for AI agents. Route any HTTP request through 2M+ real home devices — Android phones, Windows PCs, Macs — to bypass anti-bot systems, geo-target by country or city, and maintain sticky sessions across multi-step workflows.

Works with Claude Code, Cursor, Windsurf, Cline, Continue, and any MCP-compatible AI agent. Powered by [Novada](https://www.novada.com).

---

Why Proxy4Agent

AI agents get blocked on 60–70% of commercial websites. Standard HTTP requests are detected and rejected by Cloudflare, Akamai, DataDome, PerimeterX, and similar systems. Proxy4Agent routes your agent through real residential IPs — so it looks indistinguishable from a human browser.

---

Providers

Proxy4Agent works with any HTTP proxy. Novada is the built-in default with the deepest integration. BrightData, Smartproxy, and Oxylabs have dedicated adapters with full auto-targeting. Any other provider works via the generic adapter.

Priority: Novada → BrightData → Smartproxy → Oxylabs → Generic. First configured provider wins.

Novada (default — recommended)

Full integration: automatic geo-targeting, city-level targeting, sticky sessions, 195+ countries.

claude mcp add bestproxy4agents \

-e NOVADA_PROXY_USER=your_username \ -e NOVADA_PROXY_PASS=your_password \ -- npx -y bestproxy4agents

Get credentials: [novada.com](https://www.novada.com) → Dashboard → Residential Proxies → Endpoint Generator

BrightData

Full integration: automatic country/city/session targeting via BrightData's username-suffix format.

claude mcp add bestproxy4agents \

-e BRIGHTDATA_USER="brd-customer-abc123-zone-residential" \ -e BRIGHTDATA_PASS=your_password \ -- npx -y bestproxy4agents

Get credentials: brightdata.com → Proxies & Scraping → Residential → Access Parameters

BRIGHTDATA_USER is your full username including zone (e.g. brd-customer-abc123-zone-residential). Optional: BRIGHTDATA_HOST (default: zproxy.lum-superproxy.io), BRIGHTDATA_PORT (default: 22225).

Smartproxy

Full integration: automatic country/city/session targeting.

claude mcp add bestproxy4agents \

-e SMARTPROXY_USER=your_username \ -e SMARTPROXY_PASS=your_password \ -- npx -y bestproxy4agents

Get credentials: smartproxy.com → Dashboard → Residential → Endpoint Generator

Optional: SMARTPROXY_HOST (default: gate.smartproxy.com), SMARTPROXY_PORT (default: 10001).

Oxylabs

Full integration: automatic country/city/session targeting.

claude mcp add bestproxy4agents \

-e OXYLABS_USER=your_username \ -e OXYLABS_PASS=your_password \ -- npx -y bestproxy4agents

Get credentials: oxylabs.io → Dashboard → Residential Proxies → Access Details

Optional: OXYLABS_HOST (default: pr.oxylabs.io), OXYLABS_PORT (default: 7777).

Generic HTTP Proxy — any other provider

Set PROXY_URL to use IPRoyal, your own infrastructure, or any standard HTTP proxy.

# IPRoyal

claude mcp add bestproxy4agents \ -e PROXY_URL="http://username:password@geo.iproyal.com:12321" \ -- npx -y bestproxy4agents

Any HTTP proxy

claude mcp add bestproxy4agents \ -e PROXY_URL="http://user:pass@your-proxy-host:port" \ -- npx -y bestproxy4agents

Note: With the generic adapter, encode country/city/session targeting directly in your proxy URL per your provider's format. country, city, and session_id tool parameters are logged as warnings and not forwarded.

---

Get Your Credentials

Sign up at [novada.com](https://www.novada.com) — 30 seconds, no credit card.

You only need credentials for the tools you use.

---

Install

Fetch + Session (core — recommended start):

claude mcp add bestproxy4agents \

-e NOVADA_PROXY_USER=your_username \ -e NOVADA_PROXY_PASS=your_password \ -e NOVADA_PROXY_HOST=your_account_host \ -- npx -y bestproxy4agents

Search only:

claude mcp add bestproxy4agents \

-e NOVADA_API_KEY=your_key \ -- npx -y bestproxy4agents

All tools:

claude mcp add bestproxy4agents \

-e NOVADA_PROXY_USER=your_username \ -e NOVADA_PROXY_PASS=your_password \ -e NOVADA_PROXY_HOST=your_account_host \ -e NOVADA_API_KEY=your_key \ -- npx -y bestproxy4agents

`NOVADA_PROXY_HOST` — your account-specific proxy host from the Endpoint Generator (e.g. abc123.vtv.na.novada.pro). Required for reliable sticky sessions. Defaults to the shared load balancer if omitted.

---

Compatible With

Proxy4Agent works with any MCP-compatible AI client:

Claude Code example (copy-paste ready):

claude mcp add bestproxy4agents \

-e NOVADA_PROXY_USER=your_username \ -e NOVADA_PROXY_PASS=your_password \ -- npx -y bestproxy4agents

Cursor / Windsurf / Cline — add to your MCP config:

{

"mcpServers": { "bestproxy4agents": { "command": "npx", "args": ["-y", "bestproxy4agents"], "env": { "NOVADA_PROXY_USER": "your_username", "NOVADA_PROXY_PASS": "your_password" } } } }

---

Tools

agentproxy_fetch

Fetch any URL through a residential proxy. Works on Amazon, LinkedIn, Cloudflare-protected pages, and most anti-bot-protected sites.

Requires: Any proxy provider — Novada (NOVADA_PROXY_USER + NOVADA_PROXY_PASS), BrightData, Smartproxy, Oxylabs, or PROXY_URL

---

agentproxy_session

Sticky session fetch — every call with the same session_id uses the same residential IP. Essential for login flows, paginated scraping, and price monitoring across pages.

Requires: Any proxy provider — Novada (NOVADA_PROXY_USER + NOVADA_PROXY_PASS), BrightData, Smartproxy, Oxylabs, or PROXY_URL

---

agentproxy_search

Structured Google search via Novada. Returns titles, URLs, and descriptions — no HTML parsing needed. Best for discovery and research tasks.

Requires: NOVADA_API_KEY

---

agentproxy_render [BETA]

Render JavaScript-heavy pages using Novada's Browser API (real Chromium, full JS execution). Use for SPAs, React/Vue apps, and pages that return blank without a real browser.

Requires: NOVADA_BROWSER_WS (copy the Puppeteer URL from Dashboard → Browser API → Playground)

---

agentproxy_status

Check Novada's proxy network health — live node count, device types, service status. No credentials required.

---

Real-World Results

Live outputs from actual API calls — not fabricated.

Geo-targeting: same URL, different exit countries

agentproxy_fetch(url="https://httpbin.org/ip", country="US", format="raw")

→ { "origin": "200.50.235.236" } ← US residential IP

agentproxy_fetch(url="https://httpbin.org/ip", country="JP", format="raw") → { "origin": "60.85.57.175" } ← Japan residential IP

Sticky session: same IP confirmed across two requests

agentproxy_session(session_id="job001", url="https://httpbin.org/ip", format="raw")

→ { "origin": "103.135.135.168" }

agentproxy_session(session_id="job001", url="https://httpbin.org/ip", format="raw") → { "origin": "103.135.135.168" } ← same IP, confirmed ✓

Amazon — 1.6 MB product page, not blocked

agentproxy_fetch(url="https://www.amazon.com/dp/B0BSHF7WHW", cou