ProxyClaw MCP Server
ProxyClaw MCP gives MCP clients residential-proxy tools to fetch URLs, check exit IP/geolocation, list country codes, and rotate sessions.
proxy_fetch: fetch public HTTP/HTTPS URLs through residential IPs; supports country/city targeting, sticky sessions, and timeouts. Schema includes ASN, but README says V2 ASN targeting is unavailable; exact city accuracy is not certified, and README mentions state/city while the schema has nostatefield.proxy_check_ip: return the observed exit IP and geo-location, optionally for a country.proxy_list_countries: list reference country codes, not live inventory.proxy_rotate: request a new session/IP; a distinct exit is not guaranteed.Requires API key/proxy credentials; key-only legacy mode is retained, partial V2 credentials are rejected, inputs are validated, and responses are bounded. No universal anti-bot, fixed-exit, free-quota, or live-inventory guarantee.
Supports running the MCP server via Docker.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ProxyClaw MCP Server Check what Amazon shows from a US IP"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 buildConfigure 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.
Related MCP server: ProxyBase MCP
Tools
proxy_fetch: fetch a public URL; optional ISO country, sticky session, timeout.proxy_check_ip: returns the observed exit for an optional country.proxy_list_countries: reference country codes, not live inventory.proxy_rotate: requests a new session; a distinct exit is not guaranteed.
Example proxy_fetch: {"url":"https://example.com","country":"US","session":"demo123","timeout":15}.
Deployed V2 state/city targeting
Pass country, optional state and city in proxy_fetch. No feature flag is required. State/city selectors are deployed in V2. Country is required; state is optional for a city request. Exact-city accuracy is not certified: some Austin test exits were labeled San Antonio or Schertz by independent geo services. Inspect the observed location when precision matters. V2 ASN targeting remains unavailable.
Safety and limits
Country input is validated across all traffic tools; selectors and timeouts are validated before network use. Credentials pass to curl through stdin rather than process arguments. Error responses do not echo credentials. Target errors return tool errors; oversized responses are bounded. HTTPS targets protect target TLS, not necessarily the proxy authentication transport.
No universal CAPTCHA/anti-bot, fixed exit, earnings, free quota or live inventory guarantee. Browser rendering and other SDKs require separate compatibility verification.
Tests: npm test. Current proxy/SDK guide: https://proxyclaw.ai/docs.html
Support: support@iploop.io
Available Tools
4 toolsproxy_check_ipA
Check the current exit IP address and geo-location when routing through the proxy. Useful to verify which country/region your requests are coming from.
Inputs: country.
proxy_fetchA
Fetch a URL through the ProxyClaw residential proxy network. Routes the request through real residential IPs in 195+ countries. Use for geo-restricted content, anti-bot bypass, or multi-country research.
Inputs: url (required), country, city, session, +2 more.
proxy_list_countriesA
List all 195+ countries available for routing through the ProxyClaw residential network.
Inputs: no named parameters.
proxy_rotateA
Force IP rotation by fetching with a new random session. Returns the new exit IP to confirm rotation worked.
Inputs: country.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a distinct purpose: check IP, fetch URL, list countries, and rotate IP. There is no overlap between these functions.
All tools follow a consistent 'proxy_verb' pattern (e.g., proxy_check_ip, proxy_fetch), making them easy to understand and remember.
The set of 4 tools covers the core proxy operations (check, fetch, list, rotate) without unnecessary extras, well-scoped for the proxy domain.
Core proxy workflows are covered: checking IP, fetching through proxy, listing countries, and rotating IP. One minor gap might be the lack of a tool to set the country explicitly, but rotation and checks suffice.
Maintenance
Related MCP Connectors
Residential proxy traffic and raw fetch for agents, 190+ countries, sticky sessions. Pay per call.
Buy and manage residential, mobile and datacenter proxies in 170+ countries, prepaid per GB
Residential proxies for AI agents: usage, proxy URLs by country, IP purity checks and cost quotes.
Residential and mobile proxies and Private modems for AI agents: proxy URLs, stock, rotation, top-up
Related MCP Servers
AlicenseNot gradedqualityDmaintenanceEnables AI agents to route HTTP requests through millions of real residential IPs, bypassing anti-bot systems and geo-targeting by country or city.4MIT
ProxyBase MCPofficial
AlicenseNot gradedqualityDmaintenanceGive AI Agents Residential SOCKS5 Passports to Bypass Bot Defenses.2MIT- AlicenseNot gradedqualityDmaintenanceRoutes AI agent HTTP requests through residential proxies to bypass anti-bot systems, geo-target by country/city, and maintain sticky sessions across multi-step workflows.15 npm1MIT

quantumproxies-mcpofficial
AlicenseAqualityCmaintenanceEnables AI agents to scrape, search, map, and crawl the web through residential proxies with real-browser TLS fingerprints, and to generate ready-to-use proxy endpoints of various types for any HTTP client.2550 npmMIT