Back to Directory/Developer Tools

io.github.Furhworld/proxyclaw

Residential proxy MCP server. 175M+ IPs in 195+ countries with anti-bot bypass.

Developer ToolsJavaScriptv1.0.4

🌐 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 doesProxy routing + fetchFull anti-bot + headless render + structured extraction
Best forSimple fetches, geo-targetingScraping protected sites (Amazon, eBay, LinkedIn), JS-rendered pages
Anti-detectionChrome fingerprint headersTLS JA3 spoofing + Playwright anti-detection
Installnpx proxyclaw-mcp-serveruvx proxyclaw-mcp-server[all]
Tools4 (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


Built with ⚑ by IPLoop

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y proxyclaw-mcp-server

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-furhworld-proxyclaw": {
      "command": "npx",
      "args": [
        "-y",
        "proxyclaw-mcp-server"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

proxyclaw-mcp-servernpm

Compatible MCP Clients

io.github.Furhworld/proxyclaw works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More