HProxy

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.

The tools

country: ISO 3166 alpha-2 country code, e.g. 'de'. Omit for every country.
limit: 1 to 200, default 25. How many to return. The full list is thousands; ask for what you need.
protocol: one of http, https, socks4, socks5. Only proxies speaking this protocol. | | proxy_check | Run a real live test on one or more proxies: is it alive, which protocols it speaks, its anonymity grade, latency and location. No key. Each check opens a real connection, so a dead proxy can take a few seconds. Up to 25 per call. | proxies (required): Proxies as ip:port, e.g. ['203.0.113.7:1080']. Up to 25. | | ip_lookup | Look up any public IP address: country, region, city, coordinates, timezone, ASN and the network that runs it. No key. Up to 50 per call. | ips (required): IPv4 or IPv6 addresses. One is the common case. |

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 takes 120 requests in a burst, then 5 a second, and 300,000 proxies a day, 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, one file for macOS, Linux and Windows, built in public from source (the release). Install it in one line on macOS and Linux:

curl -fsSL https://hproxy.com/install.sh | sh

On Windows, in PowerShell:

irm https://hproxy.com/install.ps1 | iex

Then:

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

hproxy mcp serves the same three tools as a local MCP server, for an assistant that starts programs on your computer.

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.