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.

---

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.

| Problem | Proxy4Agent |
|---------|-----------|
| Amazon, LinkedIn block your agent | Residential IPs from real home devices |
| Cloudflare / Akamai bot challenges | Bypassed via real device fingerprints |
| JS-rendered pages return blank | Browser API runs real Chromium |
| Geo-restricted or localized content | 195+ countries, city-level targeting |
| Multi-step workflows lose session | Sticky sessions — same IP across calls |
| Need structured search results | Built-in Google search, clean JSON output |

---

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 → 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.

| Feature | Novada | BrightData | Smartproxy | Oxylabs | Generic HTTP |
|---------|--------|------------|------------|---------|-------------|
| Auto country targeting | ✓ | ✓ | ✓ | ✓ | manual |
| Auto city targeting | ✓ | ✓ | ✓ | ✓ | manual |
| Sticky sessions | ✓ | ✓ | ✓ | ✓ | manual |
| Built-in search API | ✓ | — | — | — | — |
| Browser API (JS render) | ✓ | — | — | — | — |

---

Get Your Credentials

Sign up at novada.com — 30 seconds, no credit card.

| Tool | Required env vars | Where to get them |
|------|-------------------|-------------------|
| agentproxy_fetch | NOVADA_PROXY_USER + NOVADA_PROXY_PASS | Dashboard → Residential Proxies → Endpoint Generator |
| agentproxy_session | NOVADA_PROXY_USER + NOVADA_PROXY_PASS | Dashboard → Residential Proxies → Endpoint Generator |
| agentproxy_search | NOVADA_API_KEY | Dashboard → API Keys |
| agentproxy_render [BETA] | NOVADA_BROWSER_WS | Dashboard → Browser API → Playground → copy Puppeteer URL |
| agentproxy_status | _(none)_ | — |

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:

| Client | Install method |
|--------|---------------|
| Claude Code | claude mcp add bestproxy4agents -e ... -- npx -y bestproxy4agents |
| Cursor | Settings → MCP → Add server → npx -y bestproxy4agents |
| Windsurf | MCP config → npx -y bestproxy4agents |
| Cline | MCP settings → command: npx, args: ["-y", "bestproxy4agents"] |
| Continue | .continue/config.json → mcpServers |
| Smithery | smithery.ai/server/proxy4agent |
| Any MCP client | stdio transport, npx -y bestproxy4agents |

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

…