Skip to main content
Glama

HProxy MCP server

A free proxy list, a live proxy checker and an IP lookup for AI assistants, hosted by HProxy at one address. No key, no account, nothing to install.

https://mcp.hproxy.com/mcp

It speaks MCP over Streamable HTTP and is listed in the official MCP Registry as com.hproxy/mcp.

Add it to your assistant

Claude Code. In a terminal:

claude mcp add --transport http hproxy https://mcp.hproxy.com/mcp

Or as a plugin: the server plus a skill that tells Claude how to use it well. In a terminal:

claude plugin marketplace add hproxy-com/hproxy-mcp
claude plugin install hproxy@hproxy

Claude and Claude Desktop. Settings, Connectors, Add custom connector, then paste the address:

https://mcp.hproxy.com/mcp

ChatGPT. Settings, Security and login, turn on Developer mode, then create an app with this address and No authentication (Plus, Pro, Business, Enterprise and Education, on the web):

https://mcp.hproxy.com/mcp

Cursor. In ~/.cursor/mcp.json:

{ "mcpServers": { "hproxy": { "url": "https://mcp.hproxy.com/mcp" } } }

VS Code. In .vscode/mcp.json:

{ "servers": { "hproxy": { "type": "http", "url": "https://mcp.hproxy.com/mcp" } } }

Windsurf. In ~/.codeium/windsurf/mcp_config.json:

{ "mcpServers": { "hproxy": { "serverUrl": "https://mcp.hproxy.com/mcp" } } }

Gemini CLI. As an extension: the server plus a short guide for the model. In a terminal:

gemini extensions install https://github.com/hproxy-com/hproxy-mcp

Or by hand, in ~/.gemini/settings.json:

{ "mcpServers": { "hproxy": { "httpUrl": "https://mcp.hproxy.com/mcp" } } }

Any other MCP client. Add https://mcp.hproxy.com/mcp as a remote server (Streamable HTTP) with no authentication.

Related MCP server: netip-mcp

The tools

Tool

What it does

Arguments

proxy_list

Live free proxies from HProxy's public pool, re-checked around the clock: ip, port, protocols, anonymity, country, city, network, latency and 24-hour uptime.

country (two-letter code, for example de), protocol (http, https, socks4, socks5), anonymity (elite, anonymous, transparent), limit (1 to 200, default 25)

proxy_check

A real live test of each proxy: alive or not, the protocols it speaks, its anonymity grade, latency and where it exits.

proxies: up to 25, as ip:port

ip_lookup

Country, region, city, coordinates, timezone, ASN and the network behind any public address, and whether HProxy has seen it acting as a public proxy.

ips: up to 50 IPv4 or IPv6 addresses

All three only read. None of them needs a key.

Things to ask

  • "Give me twenty elite German SOCKS5 proxies and check which are alive."

  • "Find five fast US HTTP proxies, test them, and give me only the working ones."

  • "Who runs the network behind 8.8.8.8, and where is it?"

Good to know

  • These are public free proxies. Expect fewer than half to answer at any moment, set short timeouts, and never send passwords or personal data through one.

  • Limits are per IP address. The checker allows roughly twelve checks a minute with bursts of ten, because every check opens a real connection. Past a limit, the tool says how many seconds to wait.

  • For proxies that must hold up against real blocking, HProxy's paid proxies are at hproxy.com/pricing.

The same tools without MCP

Plain HTTP, no key, CORS open:

curl "https://hproxy.com/api/proxy-list?format=json&protocol=socks5&country=us"
curl "https://hproxy.com/api/proxy-check?proxy=IP:PORT"
curl "https://hproxy.com/api/ip/8.8.8.8"

Documentation: free proxy list API, proxy checker API, IP lookup API. Written for language models: hproxy.com/llms.txt.

From a terminal, the hproxy command comes with the free HProxy app:

hproxy list --country DE --protocol socks5 --limit 20
hproxy check 203.0.113.7:1080 198.51.100.3:8080
hproxy ip 8.8.8.8

The whole list as plain files, updated around the clock: hproxy-com/free-proxy-list.

Support

Support is staffed around the clock at hproxy.com/contact. You may build these tools into your own software, free of charge and without asking.

License

MIT, for the files in this repository.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to perform IP geolocation, proxy detection, and domain WHOIS lookups using IP2Location.io and IP2WHOIS data.
    5
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Enables coding agents to perform network diagnostics and lookups, including subnet calculations, port and MAC vendor information, DNS and blocklist checks, TLS certificate inspection, and public IP discovery, all without needing an account or sending telemetry.
    11
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI assistants to query IP intelligence tools such as geolocation, VPN/security checks, ASN, timezone, astronomy, user-agent parsing, abuse contacts, and bulk lookups via natural language.
    13 npm
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Enables AI agents to classify IP addresses through the VPNDetection API with read-only tools that detect VPNs, residential and datacenter proxies, Tor nodes, relays, hosting providers and CDNs, in single or bulk lookups of up to 100 addresses. It also exposes which datasets an organisation is licensed for, along with their metadata and published checksums.
    7
    708 npm
    1
    MIT