Free Proxy Mcp

io.github.litportnetPublished by GitHub account litportnetv0.1.0Updated Oct 24, 2026

MCP server exposing Litport's verified free HTTP, SOCKS4 and SOCKS5 proxy snapshot.

VerifiedSTDIODesktop onlyWeb Search & Scraping Developer Tools

Server details

Identifier: io.github.litportnet/free-proxy-mcp
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 17, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account litportnet for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.litportnet%2Ffree-proxy-mcp.svg)](https://sourceweft.com/mcp/io.github.litportnet%2Ffree-proxy-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

A local stdio MCP server that lets an assistant list, rank and summarize Litport's verified free HTTP, SOCKS4 and SOCKS5 proxy snapshot.

What you can do: List verified free proxies filtered by protocol, country, anonymity, HTTPS support, latency, uptime, check count and recency, with a result limit of 1 to 50 (default 10). Pick the highest-ranked proxies matching the same filters, returning 1 to 25 results (default 5). Summarize the current snapshot: total matches, counts by protocol and anonymity, top 10 countries, HTTPS share, latency min/median/p90/max, known seven-day uptime coverage, and newest and oldest last-checked timestamps. Every response carries a disclaimer field, and SDK errors come back as error results rather than thrown exceptions.
When to use it: Useful when you need candidate free proxies for testing or research and want an assistant to filter and rank them by protocol, country, latency or uptime without browsing a list by hand. It is a read-only lookup layer, not a proxy client, so it does not route any traffic.
Requirements: Runs locally over stdio; Node.js 20 or newer is required, and npx can fetch and run the package on demand. Network access to the snapshot endpoint is needed. Optional environment variables LITPORT_FREE_PROXY_API_URL (must be an absolute http or https URL) and LITPORT_FREE_PROXY_TIMEOUT_MS (default 10000) adjust the endpoint and timeout. No authentication is declared.

Before you install

Free proxies are intended for testing only; never route credentials, cookies, payment data or private data through them. The server itself is read-only and does not forward traffic, but the proxy records it returns point to third-party hosts of unknown trust. Setting LITPORT_FREE_PROXY_API_URL redirects snapshot fetching to another endpoint, so only point it at a source you trust.

Installation

In SourceWeft

Open Free Proxy Mcp in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[Litport free proxies: live lists, API and SDKs]

Litport Free Proxy MCP Server

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

json

{  "mcpServers": {    "free-proxy": {      "command": "npx",      "args": ["-y", "@litportnet/free-proxy-mcp"]    }  }}

{  "mcpServers": {    "free-proxy": {      "command": "npx",      "args": ["-y", "@litportnet/free-proxy-mcp"]    }  }}

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.
`LITPORT_FREE_PROXY_TIMEOUT_MS`	`10000`	Per-request timeout in milliseconds passed to the SDK client.

Test

npm test runs node --test over test/*.test.mjs: in-process unit tests that drive the server through the MCP SDK's in-memory transport with an injected @litportnet/free-proxy-sdk client, and an end-to-end test that spawns the server over stdio against a local HTTP fixture server, plus a regression test that launches the server through a bin symlink the way npx does.

Resources

Free proxies are for testing only. Never route credentials, cookies, payment data, or private data through them.

Source: README.md at commit 2e5cd5c

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.1.0LatestSep 17, 2026

Score

50% 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 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts