iploop avatar

Proxyclaw

iploop/proxyclaw-mcp

Connects Claude to IPLoop's residential proxy network of 175M+ IPs across 195+ countries. Exposes four tools: proxy_fetch for routing requests through residential IPs with country and city targeting, proxy_check_ip to verify your exit location, proxy_list_countries to see available routing options, and proxy_rotate to force a new IP when rate limited. Sessions stay sticky across requests. Useful when you need to scrape geo-restricted content, bypass Cloudflare or DataDome, or test how sites behave from different regions. The Node.js version handles basic proxied fetches. If you need headless rendering or anti-detection for harder targets like Amazon or LinkedIn, they ship a separate Python MCP with Playwright integration.

GitHub stars
1
tools
4
auth
Secret needed
transport
STDIO
env var
1
last updated
Apr 24, 2026

Tools

4 tools

Public tool metadata for what this MCP can expose to an agent.

proxy_fetchFetch a public URL; optional ISO country, sticky session, timeout.

Fetch a public URL; optional ISO country, sticky session, timeout.

No parameter schema in public metadata yet.

proxy_check_ipReturns the observed exit for an optional country.

Returns the observed exit for an optional country.

No parameter schema in public metadata yet.

proxy_list_countriesReference country codes, not live inventory.

Reference country codes, not live inventory.

No parameter schema in public metadata yet.

proxy_rotateRequests a new session; a distinct exit is not guaranteed.

Requests a new session; a distinct exit is not guaranteed.

No parameter schema in public metadata yet.

Sponsors

Configuration

IPLOOP_API_KEY*secret

Your ProxyClaw API key from iploop.io

Readme

ProxyClaw MCP — V2 source setup

Residential proxy tools for compatible MCP clients. Get credentials at https://platform.iploop.io/.

Install the updated source

The GitHub implementation is version 1.1.1. Do not assume the npm registry package or a registry catalog has been updated merely because this repository is current.

git clone https://github.com/Iploop/proxyclaw-mcp.git
cd proxyclaw-mcp
npm ci
npm run build

Configure your MCP client to run Node with the absolute path to dist/index.js:

{"mcpServers":{"proxyclaw":{"command":"node","args":["/ABSOLUTE/PATH/proxyclaw-mcp/dist/index.js"],"env":{"IPLOOP_API_KEY":"YOUR_ACCOUNT_API_KEY","IPLOOP_PROXY_USERNAME":"YOUR_PROXY_USERNAME","IPLOOP_PROXY_PASSWORD":"YOUR_PROXY_PASSWORD"}}}}

Requires Node 18+, npm and curl. Key-only callers retain legacy mode; setting just one V2 proxy credential is rejected. Proxy settings are discovered from the HTTPS platform metadata.


View the full README on GitHub

Details

Repository
github.com/iploop/proxyclaw-mcp
Package
proxyclaw-mcp-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active