The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Proxyclaw listing page.
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.
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.
Sign up at iploop.io/signup — 0.5 GB free, no credit card.
Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Restart Claude Desktop. Done.
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.
proxy_fetchFetch any URL through a residential proxy.
Use when: Scraping geo-restricted sites, checking prices by region, bypassing bot detection.
proxy_check_ipCheck which IP and country you're exiting from.
Use when: Verifying your proxy location before scraping.
proxy_list_countriesList all 195+ available countries.
Use when: You need to know the exact 2-letter code for Madagascar.
proxy_rotateForce a new IP rotation.
Use when: Your current IP got rate-limited and you need a fresh one.
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]
Or with Docker:
Upgrade anytime at iploop.io.
Built with ⚡ by IPLoop