{
  "markdown": "# 🌐 ProxyClaw MCP Server\n\n**Model Context Protocol (MCP) server for ProxyClaw by IPLoop.**\n\nRoute web requests through 175M+ residential IPs across 195+ countries — directly from Claude Desktop, Cursor, Zed, or any MCP-compatible client.\n\n> **The only residential proxy network with an MCP server.** Your AI can now browse from real homes, not datacenters.\n\n---\n\n## ✨ What You Get\n\n- **195+ countries** — Route requests through real residential IPs\n- **Anti-bot bypass** — Cloudflare, DataDome, PerimeterX can't tell the difference\n- **Zero config** — One environment variable, four powerful tools\n- **Sticky sessions** — Same IP across multiple requests\n- **City & ISP targeting** — Pinpoint precision when you need it\n\n## ⚡ Node.js vs Python — Which One?\n\nWe ship **two** MCP servers. Choose based on what you need:\n\n| | **This repo (Node.js)** | **[Python version](https://github.com/Iploop/proxyclaw-mcp-py)** |\n|---|---|---|\n| **What it does** | Proxy routing + fetch | Full anti-bot + headless render + structured extraction |\n| **Best for** | Simple fetches, geo-targeting | Scraping protected sites (Amazon, eBay, LinkedIn), JS-rendered pages |\n| **Anti-detection** | Chrome fingerprint headers | TLS JA3 spoofing + Playwright anti-detection |\n| **Install** | `npx proxyclaw-mcp-server` | `uvx proxyclaw-mcp-server[all]` |\n| **Tools** | 4 (fetch, check_ip, list_countries, rotate) | 6 (+ stealth fetch, render, scrape, extract) |\n\n**→ Use Node.js** if you just need to route requests through residential IPs.\n\n**→ Use Python** if you're scraping hard targets (Cloudflare, SPAs, React sites) or need structured data extraction from 60+ supported sites.\n\nBoth use the same proxy network — just different levels of power.\n\n---\n\n## 🚀 Install (30 seconds)\n\n### 1. Get Your Free API Key\n\nSign up at **[iploop.io/signup](https://iploop.io/signup.html)** — 0.5 GB free, no credit card.\n\n### 2. Add to Claude Desktop\n\nOpen `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"proxyclaw\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"proxyclaw-mcp-server\"],\n      \"env\": {\n        \"IPLOOP_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. Done.\n\n### 3. Verify\n\nAsk Claude:\n\n> \"Check my exit IP through the proxy\"\n\nClaude will call `proxy_check_ip` and show you the residential IP you're routing through.\n\n---\n\n## 🛠️ Available Tools\n\n### `proxy_fetch`\n\nFetch any URL through a residential proxy.\n\n```json\n{\n  \"url\": \"https://example.com\",\n  \"country\": \"US\",\n  \"city\": \"newyork\",\n  \"session\": \"my-session-id\",\n  \"timeout\": 30\n}\n```\n\n**Use when:** Scraping geo-restricted sites, checking prices by region, bypassing bot detection.\n\n### `proxy_check_ip`\n\nCheck which IP and country you're exiting from.\n\n```json\n{\n  \"country\": \"DE\"\n}\n```\n\n**Use when:** Verifying your proxy location before scraping.\n\n### `proxy_list_countries`\n\nList all 195+ available countries.\n\n```json\n{}\n```\n\n**Use when:** You need to know the exact 2-letter code for Madagascar.\n\n### `proxy_rotate`\n\nForce a new IP rotation.\n\n```json\n{\n  \"country\": \"GB\"\n}\n```\n\n**Use when:** Your current IP got rate-limited and you need a fresh one.\n\n---\n\n## 💬 Example Conversations\n\n> **You:** \"Check what Amazon.com shows from a US IP\"\n>\n> **Claude:** *[calls proxy_fetch with country=US, returns HTML]*\n\n> **You:** \"Now check the same page from Japan\"\n>\n> **Claude:** *[calls proxy_fetch with country=JP, returns different pricing/content]*\n\n> **You:** \"List all countries where I can route through\"\n>\n> **Claude:** *[calls proxy_list_countries, returns 195+ countries]*\n\n> **You:** \"My current IP is blocked. Rotate to a new UK IP\"\n>\n> **Claude:** *[calls proxy_rotate with country=GB, confirms new IP]*\n\n---\n\n## 🔒 Security\n\n- API key is passed via environment variable — never hardcoded\n- All traffic to target sites is TLS-encrypted\n- Proxy auth is plaintext to our proxy gateway only (same as any HTTP proxy)\n- No data is logged or stored by the MCP server\n\n---\n\n## 📦 Advanced: Local Install\n\n```bash\nnpm install -g proxyclaw-mcp-server\n\n# Run directly\nIPLOOP_API_KEY=your_key proxyclaw-mcp-server\n```\n\nOr with Docker:\n\n```bash\ndocker run -e IPLOOP_API_KEY=your_key proxyclaw/mcp-server\n```\n\n---\n\n## 🆓 Free Tier\n\n- **0.5 GB** bandwidth included\n- All 195+ countries available\n- No credit card required\n\nUpgrade anytime at [iploop.io](https://iploop.io).\n\n---\n\n## 🔗 Links\n\n- **Website:** [proxyclaw.ai](https://proxyclaw.ai)\n- **Platform:** [iploop.io](https://iploop.io)\n- **GitHub:** [github.com/Iploop/proxyclaw-mcp](https://github.com/Iploop/proxyclaw-mcp)\n- **MCP Docs:** [modelcontextprotocol.io](https://modelcontextprotocol.io)\n\n---\n\nBuilt with ⚡ by [IPLoop](https://iploop.io)\n",
  "bytes": 4798,
  "sha": "12d5485d9871ac2c1e79d06ae1f95b39abd438b222510d7682842d83d848fba6",
  "repo_slug": "iploop/proxyclaw-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_furhworld_proxyclaw_98491253/readme"
}