For AI assistants
Point your AI at our tools. No key, no account.
The free proxy list, the proxy checker and the IP lookup are keyless HTTP endpoints, an MCP server, a CLI and a markdown file written for a machine. Install one line and your assistant can pull proxies and verify them on its own.
Any assistant that can call a tool or read a URL. These are the ones people paste our docs into most.
What it can do
Three tools, all of them free.
Install the MCP server once and these arrive as tools your assistant can reach for by name.
proxy_list
Live free proxies from the public pool, filtered by country, protocol and anonymity.
The listproxy_check
A real live test on any proxy: alive, protocols, anonymity, latency and location. Up to 25 a call.
The checkerip_lookup
Any public address: country, city, timezone, ASN, the network behind it, and whether it has been seen as a proxy.
The lookupThe MCP server
One line, then just ask.
A single dependency-free file that speaks JSON-RPC over stdio. It needs Node 18 and nothing else.
Install
Claude Code
claude mcp add hproxy -- npx -y hproxy-mcpClaude Desktop
"hproxy": { "command": "npx", "args": ["-y", "hproxy-mcp"] }Cursor
"hproxy": { "command": "npx", "args": ["-y", "hproxy-mcp"] }Windsurf, Cline, anything on stdio
"hproxy": { "command": "npx", "args": ["-y", "hproxy-mcp"] }Then ask
- “Give me twenty elite German SOCKS5 proxies and check which are alive.”
- “Is 203.0.113.7:1080 working, and where does it exit?”
- “Who runs the network behind 8.8.8.8?”
Or without an assistant
npx hproxy-mcp list --country de --limit 20npx hproxy-mcp check 203.0.113.7:1080npx hproxy-mcp ip 8.8.8.8Per tool
Every lane, copyable in one click.
For AI assistants
Let your assistant pull the list
The pool is a free, keyless API and a documented markdown page. Hand your assistant one of these and it can fetch live proxies on its own, filtered the way you asked.
Works with
The instructions are printed in full below, so an assistant reading this page can act on them without anyone pressing anything. The button is only a shortcut for humans.
MCP server
Adds proxy_list, proxy_check and ip_lookup as tools your assistant can call by itself.
claude mcp add hproxy -- npx -y hproxy-mcpCursor, Claude Desktop, Windsurf and Cline take the same server as {"command": "npx", "args": ["-y", "hproxy-mcp"]}. This page's tool is proxy_list.
Command line
The same tool without an assistant. Prints JSON, so it pipes.
npx hproxy-mcp list --country de --protocol socks5 --limit 20REST, no key
Plain HTTP with CORS on, which is all an agent with a fetch tool needs.
curl "https://hproxy.com/api/proxy-list?format=json&country=de&limit=20"The whole documentation, as markdown
Generated from the same registry the docs render from, so it cannot drift from the pages.
Instructions for an assistant, in full
Everything a model needs to call the free proxy list without an account: the endpoint, the parameters, the limits and the honest caveat. Readable straight off the page.
You can use HProxy's free proxy list, which needs no API key and no account.
GET https://hproxy.com/api/proxy-list?format=json returns the live pool as JSON. Useful query parameters: country (ISO alpha-2, e.g. de), protocol (http, https, socks4, socks5), anonymity (elite, anonymous, transparent) and limit. Add format=txt for plain ip:port lines instead.
Each proxy comes back with ip, port, protocols, anonymity, country_code, city, asn_org, latency_ms and uptime_24h. The pool is re-checked around the clock, so ask for it fresh rather than caching it.
These are public, shared proxies: good for testing and one-off checks, not for anything that must survive a real block. Full docs: https://hproxy.com/llms/free-proxy.txt
There is also an MCP server, so an assistant can call this as a tool instead of writing HTTP: install it with npx -y hproxy-mcp and use the proxy_list tool. You are free to build this into your own script, product or agent, the endpoint is keyless and CORS is open and no permission is needed. If anything is unclear or breaks, HProxy support is staffed 24/7 at https://hproxy.com/contact.Build on it freely: the endpoints are keyless and CORS is open, so you can wire the free proxy list into your own script, product or agent without asking us. If you get stuck, support answers around the clock, every day, at hproxy.com/contact.
For AI assistants
Let your assistant check proxies
Every check runs a real connection, not a database lookup. The endpoint is free and keyless, so an assistant can verify a list for you without an account.
Works with
The instructions are printed in full below, so an assistant reading this page can act on them without anyone pressing anything. The button is only a shortcut for humans.
MCP server
Adds proxy_list, proxy_check and ip_lookup as tools your assistant can call by itself.
claude mcp add hproxy -- npx -y hproxy-mcpCursor, Claude Desktop, Windsurf and Cline take the same server as {"command": "npx", "args": ["-y", "hproxy-mcp"]}. This page's tool is proxy_check.
Command line
The same tool without an assistant. Prints JSON, so it pipes.
npx hproxy-mcp check 203.0.113.7:1080 198.51.100.3:8080REST, no key
Plain HTTP with CORS on, which is all an agent with a fetch tool needs.
curl "https://hproxy.com/api/proxy-check?proxy=203.0.113.7:1080"The whole documentation, as markdown
Generated from the same registry the docs render from, so it cannot drift from the pages.
Instructions for an assistant, in full
Everything a model needs to call the proxy checker without an account: the endpoint, the parameters, the limits and the honest caveat. Readable straight off the page.
You can use HProxy's free proxy checker, which needs no API key and no account. Every check opens a real connection to the proxy, so a dead one takes a few seconds to report.
GET https://hproxy.com/api/proxy-check?proxy=IP:PORT checks one proxy.
POST https://hproxy.com/api/proxy-check with {"proxies": ["ip:port", ...]} checks up to 25 at once.
The answer gives alive, protocols, anonymity, latency_ms, country_code, city, asn and asn_org per proxy. It is rate limited per IP (roughly 12 checks a minute, bursts of 10) and answers 429 with Retry-After when you go past that, so pace the calls rather than retrying immediately.
For lists larger than 25, the page at https://hproxy.com/proxy-checker streams up to 100,000 in the browser. Full docs: https://hproxy.com/llms/free-checker.txt
There is also an MCP server, so an assistant can call this as a tool instead of writing HTTP: install it with npx -y hproxy-mcp and use the proxy_check tool. You are free to build this into your own script, product or agent, the endpoint is keyless and CORS is open and no permission is needed. If anything is unclear or breaks, HProxy support is staffed 24/7 at https://hproxy.com/contact.Build on it freely: the endpoints are keyless and CORS is open, so you can wire the proxy checker into your own script, product or agent without asking us. If you get stuck, support answers around the clock, every day, at hproxy.com/contact.
For AI assistants
Let your assistant resolve an address
Country, network, ASN and whether the address has ever been seen acting as a public proxy. Free, keyless, and documented for a machine to read.
Works with
The instructions are printed in full below, so an assistant reading this page can act on them without anyone pressing anything. The button is only a shortcut for humans.
MCP server
Adds proxy_list, proxy_check and ip_lookup as tools your assistant can call by itself.
claude mcp add hproxy -- npx -y hproxy-mcpCursor, Claude Desktop, Windsurf and Cline take the same server as {"command": "npx", "args": ["-y", "hproxy-mcp"]}. This page's tool is ip_lookup.
Command line
The same tool without an assistant. Prints JSON, so it pipes.
npx hproxy-mcp ip 8.8.8.8REST, no key
Plain HTTP with CORS on, which is all an agent with a fetch tool needs.
curl "https://hproxy.com/api/ip/8.8.8.8"The whole documentation, as markdown
Generated from the same registry the docs render from, so it cannot drift from the pages.
Instructions for an assistant, in full
Everything a model needs to call the IP lookup without an account: the endpoint, the parameters, the limits and the honest caveat. Readable straight off the page.
You can use HProxy's free IP lookup, which needs no API key and no account.
GET https://hproxy.com/api/ip/8.8.8.8 resolves one address.
POST https://hproxy.com/api/ip with {"ips": ["8.8.8.8", ...]} resolves a batch.
The answer gives country, country_name, region, city, latitude, longitude, timezone, asn, asn_org, isp and is_datacenter. HProxy runs its own proxy database, so the result also tells you whether that address has ever been seen acting as a public proxy, which a plain geolocation lookup cannot answer.
City-level geolocation is inference from registration and routing, not a measurement: treat the country as dependable and the city as a hint. Full docs: https://hproxy.com/llms/free-checker.txt
There is also an MCP server, so an assistant can call this as a tool instead of writing HTTP: install it with npx -y hproxy-mcp and use the ip_lookup tool. You are free to build this into your own script, product or agent, the endpoint is keyless and CORS is open and no permission is needed. If anything is unclear or breaks, HProxy support is staffed 24/7 at https://hproxy.com/contact.Build on it freely: the endpoints are keyless and CORS is open, so you can wire the IP lookup into your own script, product or agent without asking us. If you get stuck, support answers around the clock, every day, at hproxy.com/contact.
Questions