Skip to main content
Glama

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.

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 tools
proxy_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

    A4.3/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a distinct purpose: check IP, fetch URL, list countries, and rotate IP. There is no overlap between these functions.

    Naming Consistency5/5

    All tools follow a consistent 'proxy_verb' pattern (e.g., proxy_check_ip, proxy_fetch), making them easy to understand and remember.

    Tool Count5/5

    The set of 4 tools covers the core proxy operations (check, fetch, list, rotate) without unnecessary extras, well-scoped for the proxy domain.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Routes 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 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      25
      50 npm
      MIT