proxyclaw-mcp

🌐 ProxyClaw MCP Server

Model Context Protocol (MCP) server for ProxyClaw by IPLoop.

Route web requests through 175M+ residential IPs across 195+ countries — directly from Claude Desktop, Cursor, Zed, or any MCP-compatible client.

The only residential proxy network with an MCP server. Your AI can now browse from real homes, not datacenters.

---

✨ What You Get

• 195+ countries — Route requests through real residential IPs
• Anti-bot bypass — Cloudflare, DataDome, PerimeterX can't tell the difference
• Zero config — One environment variable, four powerful tools
• Sticky sessions — Same IP across multiple requests
• City & ISP targeting — Pinpoint precision when you need it

⚡ Node.js vs Python — Which One?

We ship two MCP servers. Choose based on what you need:

| | This repo (Node.js) | Python version | |---|---|---| | What it does | Proxy routing + fetch | Full anti-bot + headless render + structured extraction | | Best for | Simple fetches, geo-targeting | Scraping protected sites (Amazon, eBay, LinkedIn), JS-rendered pages | | Anti-detection | Chrome fingerprint headers | TLS JA3 spoofing + Playwright anti-detection | | Install | npx proxyclaw-mcp-server | uvx proxyclaw-mcp-server[all] | | Tools | 4 (fetch, check_ip, list_countries, rotate) | 6 (+ stealth fetch, render, scrape, extract) |

→ Use Node.js if you just need to route requests through residential IPs.

→ Use Python if you're scraping hard targets (Cloudflare, SPAs, React sites) or need structured data extraction from 60+ supported sites.

Both use the same proxy network — just different levels of power.

---

🚀 Install (30 seconds)

1. Get Your Free API Key

Sign up at iploop.io/signup — 0.5 GB free, no credit card.

2. Add to Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "proxyclaw": {
      "command": "npx",
      "args": ["-y", "proxyclaw-mcp-server"],
      "env": {
        "IPLOOP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop. Done.

3. Verify

Ask Claude:

"Check my exit IP through the proxy"

Claude will call proxy_check_ip and show you the residential IP you're routing through.

---

🛠️ Available Tools

proxy_fetch

Fetch any URL through a residential proxy.

{
  "url": "https://example.com",
  "country": "US",
  "city": "newyork",
  "session": "my-session-id",
  "timeout": 30
}

Use when: Scraping geo-restricted sites, checking prices by region, bypassing bot detection.

proxy_check_ip

Check which IP and country you're exiting from.

{
  "country": "DE"
}

Use when: Verifying your proxy location before scraping.

proxy_list_countries

List all 195+ available countries.

{}

Use when: You need to know the exact 2-letter code for Madagascar.

proxy_rotate

Force a new IP rotation.

{
  "country": "GB"
}

Use when: Your current IP got rate-limited and you need a fresh one.

---

💬 Example Conversations

You: "Check what Amazon.com shows from a US IP" Claude: [calls proxy_fetch with country=US, returns HTML]

You: "Now check the same page from Japan" Claude: [calls proxy_fetch with country=JP, returns different pricing/content]

You: "List all countries where I can route through" Claude: [calls proxy_list_countries, returns 195+ countries]

You: "My current IP is blocked. Rotate to a new UK IP" Claude: [calls proxy_rotate with country=GB, confirms new IP]

---

🔒 Security

• API key is passed via environment variable — never hardcoded
• All traffic to target sites is TLS-encrypted
• Proxy auth is plaintext to our proxy gateway only (same as any HTTP proxy)
• No data is logged or stored by the MCP server

---

📦 Advanced: Local Install

npm install -g proxyclaw-mcp-server

# Run directly
IPLOOP_API_KEY=your_key proxyclaw-mcp-server

Or with Docker:

docker run -e IPLOOP_API_KEY=your_key proxyclaw/mcp-server

---

🆓 Free Tier

• 0.5 GB bandwidth included
• All 195+ countries available
• No credit card required

Upgrade anytime at iploop.io.

---

🔗 Links

• Website: proxyclaw.ai
• Platform: iploop.io
• GitHub: github.com/Iploop/proxyclaw-mcp
• MCP Docs: modelcontextprotocol.io

---

Built with ⚡ by IPLoop