Official description6 sourcesMCP servers7d ago
litportnet/free-proxy-mcp
Context Protocol server that gives an MCP client (Claude Desktop, Claude Code, or any other MCP-compatible agent) three bounded, read-only tools over Litport's public free-proxy snapshot: list verified HTTP, SOCKS4, and SOCKS5 proxies, pick the highest-ranked ones, and summarize the current snapshot.
View on GitHub ↗Direct link · no redirect page
Config template (adjust for your client)
claude mcp add free-proxy-mcp -- npx -y free-proxy-mcp
A pasteable skeleton generated from the repository name. Check the project README for the exact package and arguments.
- Star count
- 0 ★ · litportnet/free-proxy-mcp · read from the repository page · (checked 2026-10-16 20:00:20)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-10-10 · last seen 2026-10-16 · seen 30× · listed by 6 sources
- Score
- score 603 · 6 sources · mcp
FAQ (answers come from our records)
How do I install it?
We did not find an install command for this repository (our install coverage is only about 4%). Check its README or releases page.
Who is it for?
We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
litportnet/free-proxy-mcp；first catalogued 2026-10-10；last seen 2026-10-16。There is no official certification or quality rating here — we record sources and dates only.Third-party quality signals
Litport Free Proxy MCP Server
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
A local, stdio Model Context Protocol server that gives an MCP
client (Claude Desktop, Claude Code, or any other MCP-compatible agent) three bounded, read-only
tools over Litport's public free-proxy snapshot: list verified HTTP, SOCKS4, and SOCKS5 proxies,
pick the highest-ranked ones, and summarize the current snapshot. It never forwards traffic, never
accepts arbitrary URLs from tool callers, and exposes no write or side-effecting tools; it is a thin
wrapper around @litportnet/free-proxy-sdk.
Install / Use with Claude Desktop, Claude Code, and other MCP clients
Add this to your client's MCP server configuration (for Claude Desktop, claude_desktop_config.json;
for Claude Code, .mcp.json or claude mcp add):
No installation step is required beyond having Node.js 20+ available; npx fetches and runs the
package on demand. To install it explicitly instead:
Tools
All three tools are read-only and share the same underlying filters. country is a two-letter ISO
3166-1 alpha-2 code (case-insensitive). checkedWithinMin limits results to proxies checked within
the last 1-1440 minutes.
| Tool | Description | Inputs |
| --- | --- | --- |
| list_proxies | List verified free proxies matching filters. | protocol (http\|socks4\|socks5), country, anonymity (transparent\|anonymous\|elite\|unknown), https (boolean), maxLatencyMs (int ≥ 0), minUptime7d (int 0-100), minChecks7d (int ≥ 0), checkedWithinMin (int 1-1440, default 30), limit (int 1-50, default 10) |
| pick_best_proxies | Return the highest-ranked proxies matching filters. | count (int 1-25, default 5), plus the same filters as list_proxies except limit |
| proxy_snapshot_stats | Summarize the current proxy snapshot. | checkedWithinMin (int 1-1440, default 30), protocol, country |
list_proxies and pick_best_proxies return a count and a proxies array of normalized records
exactly as returned by the SDK. proxy_snapshot_stats returns the total matching count, counts by
protocol and anonymity, the top 10 countries by count, the share of matching proxies that support
HTTPS, latency min/median/p90/max across records that report latency, how many records have a known
seven-day uptime, and the newest and oldest lastChecked timestamps. Every response includes a
disclaimer field. Errors from the underlying SDK (invalid filters, request timeouts, malformed or
stale snapshots) are returned as { isError: true, content: [...] } rather than thrown, and never
include a stack trace.
Environment
| Variable | Default | Purpose |
| --- | --- | --- |
| LITPORT_FREE_PROXY_API_URL | the SDK's built-in snapshot URL | Absolute http:// or https:// URL for the snapshot endpoint. The server validates this and exits with a clear error on startup if it is set to something else. |
client (Claude Desktop, Claude Code, or any other MCP-compatible agent) three bounded, read-only
tools over Litport's public free-proxy snapshot: list verified HTTP, SOCKS4, and SOCKS5 proxies,
pick the highest-ranked ones, and summarize the current snapshot. It never forwards traffic, never
accepts arbitrary URLs from tool callers, and exposes no write or side-effecting tools; it is a thin
wrapper around @litportnet/free-proxy-sdk.
Install / Use with Claude Desktop, Claude Code, and other MCP clients
Add this to your client's MCP server configuration (for Claude Desktop, claude_desktop_config.json;
for Claude Code, .mcp.json or claude mcp add):
No installation step is required beyond having Node.js 20+ available; npx fetches and runs the
package on demand. To install it explicitly instead:
Tools
All three tools are read-only and share the same underlying filters. country is a two-letter ISO
3166-1 alpha-2 code (case-insensitive). checkedWithinMin limits results to proxies checked within
the last 1-1440 minutes.
| Tool | Description | Inputs |
| --- | --- | --- |
| list_proxies | List verified free proxies matching filters. | protocol (http\|socks4\|socks5), country, anonymity (transparent\|anonymous\|elite\|unknown), https (boolean), maxLatencyMs (int ≥ 0), minUptime7d (int 0-100), minChecks7d (int ≥ 0), checkedWithinMin (int 1-1440, default 30), limit (int 1-50, default 10) |
| pick_best_proxies | Return the highest-ranked proxies matching filters. | count (int 1-25, default 5), plus the same filters as list_proxies except limit |
| proxy_snapshot_stats | Summarize the current proxy snapshot. | checkedWithinMin (int 1-1440, default 30), protocol, country |
list_proxies and pick_best_proxies return a count and a proxies array of normalized records
exactly as returned by the SDK. proxy_snapshot_stats returns the total matching count, counts by
protocol and anonymity, the top 10 countries by count, the share of matching proxies that support
HTTPS, latency min/median/p90/max across records that report latency, how many records have a known
seven-day uptime, and the newest and oldest lastChecked timestamps. Every response includes a
disclaimer field. Errors from the underlying SDK (invalid filters, request timeouts, malformed or
stale snapshots) are returned as { isError: true, content: [...] } rather than thrown, and never
include a stack trace.
Environment
| Variable | Default | Purpose |
| --- | --- | --- |
| LITPORT_FREE_PROXY_API_URL | the SDK's built-in snapshot URL | Absolute http:// or https:// URL for the snapshot endpoint. The server validates this and exits with a clear error on startup if it is set to something else. |
- Source
- awesome · https://github.com/litportnet/free-proxy-mcp
- Browse by field
- MCP servers
- added
- yesterday
More in MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.