HProxy

com.hproxyPublished by hproxy.comOfficial publisherv1.0.1Updated Nov 4, 2026

Free proxy list, live proxy checker and IP lookup for AI agents. No key, nothing to install.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingSecurity & Monitoring

Overview

AI-generated overview

Remote, key-free MCP server that gives an assistant a free proxy list, a live proxy checker and public IP lookup.

What you can do
  • Fetch live free proxies from a public pool, filtered by anonymity grade, country, protocol and count
  • Run live checks on up to 25 proxies for liveness, protocols, anonymity, latency and location
  • Look up public IPv4/IPv6 addresses for country, city, coordinates, timezone, ASN and network
When to use it
Useful when you need candidate free proxies to test with, want to verify which of them actually work, or need geolocation and network-owner details for an IP address, without signing up for anything.
Requirements
A remote Streamable HTTP endpoint added to the client with no authentication; no account, key or local install. Network access to the hosted server is required.
Before you install
The proxies returned are public and free: many will be dead, and passwords or personal data should never be sent through them. Rate limits apply per IP address, and the provider advertises paid residential proxies for anything that must withstand real blocking.

Installation

In SourceWeft

  1. Open HProxy in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.hproxy%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

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:

bash
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:

bash
claude plugin marketplace add hproxy-com/hproxy-mcpclaude 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:

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

VS Code. In .vscode/mcp.json:

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

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

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:

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

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

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

ToolWhat it doesArguments
proxy_listFetch 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_checkRun 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_lookupLook 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:

bash
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:

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

On Windows, in PowerShell:

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

Then:

bash
hproxy list --country DE --protocol socks5 --limit 20hproxy check 203.0.113.7:1080 198.51.100.3:8080hproxy 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.

Source: README.md at commit ea89c65

Tools

3

proxy_list

Free 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; for proxies that must survive a real block, HProxy's paid pools are at https://hproxy.com/pricing.

Parameterslimitcountryprotocolanonymity

proxy_check

Proxy checker

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.

Parametersproxiesrequired

ip_lookup

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.

Parametersipsrequired

Version history

2
  1. v1.0.1LatestSep 30, 2026
  2. v1.0.0Sep 30, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts