Proxy4agents MCP

Novada Proxy

The agent-first residential proxy MCP — works with any provider.

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. Powered by Novada .

Why · Install · Tools · Prompts · Resources · Providers · Agent-First

---

Works with Claude Code, Cursor, Windsurf, Cline, Continue, and any MCP-compatible AI agent.

[!TIP]

Free tier available — sign up at novada.com, no credit card required. Get free access to Scraper API, Web Unblocker, and residential proxies to start building immediately.

---

Getting Started

For Humans

1. Create a free account at novada.com — no credit card required
2. Get your credentials at Dashboard → Residential Proxies → Endpoint Generator — copy your username and password
3. Install and run:

# Claude Code

claude mcp add novada-proxy-mcp \ -e NOVADA_PROXY_USER=your_username \ -e NOVADA_PROXY_PASS=your_password \ -- npx -y novada-proxy-mcp

Or use the CLI directly

npx novada-proxy-mcp status npx novada-proxy fetch https://example.com

For Agents

[!NOTE]

Agents: Tell your human to complete steps 1-2 above. Once credentials are set as environment variables, all 10 tools are available immediately. No API key rotation, no token refresh — proxy credentials are persistent.

Required env vars:

NOVADA_PROXY_USER — from novada.com dashboard NOVADA_PROXY_PASS — from novada.com dashboard

Optional (for extra features): NOVADA_API_KEY — enables novada_proxy_search (Google search) NOVADA_BROWSER_WS — enables novada_proxy_render (JS rendering) NOVADA_PROXY_ZONE — "res" (default), "isp", or "dcp"

Need help? Contact support@novada.com

---

Why Novada Proxy

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

---

10 Tools at a Glance

---

Quick Decision Guide

When To Use Which Tool

Goal: "Scrape a single URL"

└─ Static HTML page? → novada_proxy_fetch └─ Need specific fields? → novada_proxy_extract (fields or schema mode) └─ React/Vue SPA / blank page? → novada_proxy_render

Goal: "Scrape multiple URLs" └─ You have the URLs already → novada_proxy_batch_fetch └─ You need links from one page → novada_proxy_map → novada_proxy_batch_fetch └─ You need to crawl a whole site → novada_proxy_crawl → novada_proxy_batch_fetch

Goal: "Research a topic" → novada_proxy_research (search + fetch + findings in one call)

Goal: "Search the web" → novada_proxy_search → novada_proxy_batch_fetch

Goal: "Login + multi-page flow" → novada_proxy_session (same session_id)

Goal: "Check if proxy works" → novada_proxy_status

---

5 Prompts

Pre-built agent workflows that chain multiple tools together. Call these from any MCP client to execute common patterns in one step.

[!NOTE]

Prompts orchestrate multi-tool workflows automatically. For example, research_topic runs novada_proxy_search then novada_proxy_batch_fetch in sequence — the agent doesn't need to figure out the pipeline.

---

5 Resources

Always-accessible reference data that agents can read at any time, without making proxy calls.

---

Quick Install

Core — fetch any URL through residential proxy:

claude mcp add novada-proxy-mcp \

-e NOVADA_PROXY_USER=your_username \ -e NOVADA_PROXY_PASS=your_password \ -- npx -y novada-proxy-mcp

Search only:

claude mcp add novada-proxy-mcp \

-e NOVADA_API_KEY=your_key \ -- npx -y novada-proxy-mcp

All tools (proxy + search + browser render):

claude mcp add novada-proxy-mcp \

-e NOVADA_PROXY_USER=your_username \ -e NOVADA_PROXY_PASS=your_password \ -e NOVADA_API_KEY=your_key \ -e NOVADA_BROWSER_WS=your_browser_ws_url \ -- npx -y novada-proxy-mcp

Cursor / Windsurf / Cline — add to MCP config:

{

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

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

---

Providers

Novada Proxy works with any HTTP proxy provider. Novada is the built-in default with the deepest integration.

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

|