Provides access to a residential proxy network for fetching URLs and checking IP locations with country, state, and city targeting.
Also known as Iploop/proxyclaw-mcp, proxyclaw-mcp, proxyclaw-mcp-server
- Stars
- 1
- Tools
- 4
- Downloads, 30 days
- —
- Latest version
- 1.0.4
- Last commit
- Nov 3, 2026
- License
- —
What is ProxyClaw MCP?
ProxyClaw provides access to a residential proxy network for fetching URLs and checking IP locations with country, state, and city targeting. It exposes 4 tools, such as proxy_fetch, proxy_check_ip, proxy_list_countries.
Summary generated from the project's README
About ProxyClaw MCP server
ProxyClaw provides developers with a residential proxy network through a Model Context Protocol interface. It allows AI clients to fetch public URLs and verify IP locations using specific geographic targeting. Users must configure their MCP client to run the server via Node using the absolute path to the build directory. Access requires an API key, a proxy username, and a proxy password obtained from the Iploop platform.
The server includes tools like proxy_fetch for retrieving web content and proxy_check_ip for observing exit points. It supports granular targeting by allowing users to specify a country, state, or city within requests. While country selection is mandatory for these features, state and city selectors are available in the V2 implementation. The system uses curl for network operations and ensures security by passing credentials through stdin to avoid exposure in process arguments.
Written from the project's README. Every use case is checked against a quote from it.
How to install ProxyClaw MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall ProxyClaw MCP in Claude Code
$ claude mcp add --env 'IPLOOP_API_KEY=<YOUR_IPLOOP_API_KEY>' proxyclaw-mcp -- npx -y proxyclaw-mcp-serverInstall ProxyClaw MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"proxyclaw-mcp": {
"command": "npx",
"args": [
"-y",
"proxyclaw-mcp-server"
],
"env": {
"IPLOOP_API_KEY": "<YOUR_IPLOOP_API_KEY>"
}
}
}
}Install ProxyClaw MCP in VS Code
.vscode/mcp.json
{
"servers": {
"proxyclaw-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"proxyclaw-mcp-server"
],
"env": {
"IPLOOP_API_KEY": "<YOUR_IPLOOP_API_KEY>"
}
}
}
}Install ProxyClaw MCP in VS Code CLI
$ code --add-mcp '{"name":"proxyclaw-mcp","type":"stdio","command":"npx","args":["-y","proxyclaw-mcp-server"],"env":{"IPLOOP_API_KEY":"<YOUR_IPLOOP_API_KEY>"}}'Install ProxyClaw MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"proxyclaw-mcp": {
"command": "npx",
"args": [
"-y",
"proxyclaw-mcp-server"
],
"env": {
"IPLOOP_API_KEY": "<YOUR_IPLOOP_API_KEY>"
}
}
}
}Install ProxyClaw MCP in Codex
$ codex mcp add proxyclaw-mcp --env 'IPLOOP_API_KEY=<YOUR_IPLOOP_API_KEY>' -- npx -y proxyclaw-mcp-serverInstall ProxyClaw MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.proxyclaw-mcp] command = "npx" args = ["-y", "proxyclaw-mcp-server"] [mcp_servers.proxyclaw-mcp.env] IPLOOP_API_KEY = "<YOUR_IPLOOP_API_KEY>"
Install ProxyClaw MCP in Gemini CLI
$ gemini mcp add -s user -e 'IPLOOP_API_KEY=<YOUR_IPLOOP_API_KEY>' proxyclaw-mcp npx -- -y proxyclaw-mcp-serverInstall ProxyClaw MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"proxyclaw-mcp": {
"command": "npx",
"args": [
"-y",
"proxyclaw-mcp-server"
],
"env": {
"IPLOOP_API_KEY": "<YOUR_IPLOOP_API_KEY>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for proxyclaw-mcp-server 1.0.4 in an isolated container with no network and no keys. It answered and listed 4 tools.
ProxyClaw MCP tools 4
Read from the server with tools/listproxy_fetchFetch 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.
proxy_check_ipCheck the current exit IP address and geo-location when routing through the proxy. Useful to verify which country/region your requests are coming from.
proxy_list_countriesList all 195+ countries available for routing through the ProxyClaw residential network.
proxy_rotateForce IP rotation by fetching with a new random session. Returns the new exit IP to confirm rotation worked.
Configuration
IPLOOP_API_KEYRequiredSecretYour ProxyClaw API key from iploop.io
IPLOOP_PROXY_PASSWORDIPLOOP_PROXY_USERNAME
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachableiploop/proxyclaw-mcp is public and reachablegithub.com/iploop/proxyclaw-mcp ↗Pass
- Package names this repository as its sourceproxyclaw-mcp-server names iploop/proxyclaw-mcp as sourcenpmjs.com/package/proxyclaw-mcp-server ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-03github.com/iploop/proxyclaw-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from proxyclaw-mcp-serverPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubProxyClaw 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.
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
ProxyClaw MCP questions
How do I add ProxyClaw MCP to Claude Code?
Run claude mcp add --env 'IPLOOP_API_KEY=<YOUR_IPLOOP_API_KEY>' proxyclaw-mcp -- npx -y proxyclaw-mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add ProxyClaw MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does ProxyClaw MCP provide?
It exposes 4 tools, including proxy_fetch, proxy_check_ip, proxy_list_countries, proxy_rotate.
How do I configure the server?
Configure your MCP client to run Node using the absolute path to the dist/index.js file and provide your IPLOOP API key, username, and password in the environment variables.
Can I target specific locations?
Yes, you can pass country, state, and city parameters to the proxy_fetch tool, though exact-city accuracy is not certified.
What tools are available in this server?
The server includes tools for fetching URLs, checking IP exit locations, listing reference country codes, and rotating proxy sessions.