HProxy MCP server
Commit Nov 8, 2026Provides free proxy lists, live proxy checking, and IP lookup capabilities for AI assistants.
Also known as hproxy-com/hproxy-mcp, hproxy-mcp
- Stars
- 0
- Tools
- 3
- Downloads, 30 days
- —
- Latest version
- 1.0.1
- Last commit
- Nov 8, 2026
- License
- MIT
What is HProxy MCP?
HProxy provides free proxy lists, live proxy checking, and IP lookup capabilities for AI assistants. It exposes 3 tools, such as proxy_list, proxy_check, ip_lookup.
Summary generated from the project's README
About HProxy MCP server
HProxy provides a remote MCP server that gives AI assistants access to free proxy lists, live proxy testing, and IP lookup data. It operates over Streamable HTTP and requires no API keys, accounts, or local installations to function. Developers can connect it to various clients including Claude Desktop, ChatGPT, Cursor, VS Code, Windsurf, and Gemini CLI by providing the remote URL.
The server includes three specific tools for managing network data. The proxy_list tool retrieves public proxies filtered by anonymity grade, country, protocol, and quantity. The proxy_check tool performs live connection tests on up to 25 IP addresses to verify latency and status. Finally, the ip_lookup tool identifies geographic and network details for up to 50 IP addresses at a time. Because these are public proxies, the server is designed for testing and research rather than handling sensitive personal information.
What you can do with it
- 1Retrieve filtered proxy listsRequest a specific number of elite SOCKS5 proxies from a particular country.
- 2Verify proxy connectivityTest a list of IP addresses to see which ones are currently active and their latency.
- 3Perform IP intelligence lookupsIdentify the network provider and geographic location of a specific IP address.
Written from the project's README. Every use case is checked against a quote from it.
How to install HProxy MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall HProxy MCP in Claude Code
$ claude mcp add --transport http hproxy-mcp https://mcp.hproxy.com/mcpInstall HProxy MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"hproxy-mcp": {
"url": "https://mcp.hproxy.com/mcp"
}
}
}Install HProxy MCP in VS Code
.vscode/mcp.json
{
"servers": {
"hproxy-mcp": {
"type": "http",
"url": "https://mcp.hproxy.com/mcp"
}
}
}Install HProxy MCP in VS Code CLI
$ code --add-mcp '{"name":"hproxy-mcp","type":"http","url":"https://mcp.hproxy.com/mcp"}'Install HProxy MCP in Codex
$ codex mcp add hproxy-mcp --url https://mcp.hproxy.com/mcpInstall HProxy MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.hproxy-mcp] url = "https://mcp.hproxy.com/mcp"
Install HProxy MCP in Gemini CLI
$ gemini mcp add -s user --transport http hproxy-mcp https://mcp.hproxy.com/mcpInstall HProxy MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"hproxy-mcp": {
"url": "https://mcp.hproxy.com/mcp",
"type": "http"
}
}
}HProxy MCP tools 3
Detected from the READMEproxy_listproxy_checkip_lookup
| proxy_list | — | |
| proxy_check | — | |
| ip_lookup | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablehproxy-com/hproxy-mcp is public and reachablegithub.com/hproxy-com/hproxy-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-08github.com/hproxy-com/hproxy-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model3 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 handshakeinitialize answered with protocol 2025-06-18 in 97 msPass
README
View on GitHubHProxy 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
| Tool | What it does | Arguments |
|---|---|---|
proxy_list |
Fetch live free proxies from HProxy's public pool, re-checked around the clock. No key. Returns ip, port, protocols, anonymity, country, city, network, latency and 24h uptime per proxy. Use this when the user wants free proxies to test with. Free proxies are public and come and go, so check them before relying on one. | anonymity: one of elite, anonymous, transparent. Only proxies of exactly this anonymity grade: elite hides both your address and the fact that a proxy is used, anonymous hides your address, transparent passes it on.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 sells residential proxies.
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.
HProxy MCP questions
How do I add HProxy MCP to Claude Code?
Run claude mcp add --transport http hproxy-mcp https://mcp.hproxy.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add HProxy 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 HProxy MCP provide?
It exposes 3 tools, including proxy_list, proxy_check, ip_lookup.
Do I need an API key to use HProxy?
No, the server requires no key, no account, and nothing to install.
What information is included in the proxy list?
The list returns IP, port, protocols, anonymity, country, city, network, latency, and 24h uptime per proxy.
Are these proxies reliable for sensitive data?
No, these are public free proxies; you should set short timeouts and never send passwords or personal data through them.
How many proxies can I check at once?
You can check up to 25 proxies per call.