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 list

proxy_check

A real live test on any proxy: alive, protocols, anonymity, latency and location. Up to 25 a call.

The checker

ip_lookup

Any public address: country, city, timezone, ASN, the network behind it, and whether it has been seen as a proxy.

The lookup

The 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-mcp

Claude 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 20
npx hproxy-mcp check 203.0.113.7:1080
npx hproxy-mcp ip 8.8.8.8

Per 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

All the machine lanes

The button copies a paragraph written for an assistant: the endpoint, the parameters and the limits. Paste it into any chat and ask for what you want.

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-mcp

Cursor, 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 20

REST, 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.

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

All the machine lanes

The button copies a paragraph written for an assistant: the endpoint, the parameters and the limits. Paste it into any chat and ask for what you want.

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-mcp

Cursor, 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:8080

REST, 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.

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

All the machine lanes

The button copies a paragraph written for an assistant: the endpoint, the parameters and the limits. Paste it into any chat and ask for what you want.

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-mcp

Cursor, 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.8

REST, 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.

Questions

What an agentneeds to know.

Do I need an API key or an account?+
No. The proxy list, the proxy checker and the IP lookup are free and keyless, with CORS enabled, so a browser agent can call them directly. Only the paid proxy and scraper APIs need a key.
What are the rate limits?+
They are per IP rather than per key. The list is generous; the checker is tighter because every check opens a real connection, roughly twelve a minute with bursts of ten. Going past that answers 429 with a Retry-After header, and the MCP server turns that into a plain message so a model waits instead of retrying in a loop.
What is llms.txt?+
A markdown file written for a language model rather than a browser. Ours is generated from the same registry the documentation renders from, so it cannot quote a price or an endpoint the pages do not. Read /llms.txt for the index and /llms-full.txt for everything.
Can an assistant use these proxies for scraping?+
It can use the free pool for testing and one-off checks. Public proxies are shared and unpredictable, so anything that must survive a real block belongs on a paid pool. The paid side has its own keyed API documented in the same files.
Is the MCP server open source?+
Yes, MIT. It is a single dependency-free file that speaks JSON-RPC over stdio and doubles as a CLI, so you can read the whole thing before you run it.