fusionproxy-mcp
OfficialFetches public web pages through residential proxy IPs in a chosen country.
Fetch a public http(s) URL and return it as Markdown, plain text, or raw HTML.
Choose an exit country by two-letter code, or use the configured default.
Reuse a sticky session name to keep the same IP for 10 minutes across requests.
Limit returned content with
max_chars(default 20,000 characters).Check the exit IP, city, country, and network websites see through the proxy.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@fusionproxy-mcp Fetch example.com as if I'm browsing from Japan."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Fusion Proxy MCP server: web access for AI agents through residential proxies
An MCP server that lets Claude, Cursor, VS Code Copilot and any other MCP client fetch web pages through residential IPs in the country you choose. Useful when an agent gets blocked, rate-limited, or needs to see a page the way a visitor from another country sees it.
Tools
Tool | What it does |
| Downloads a public page through a residential IP and returns it as Markdown (default), plain text or HTML |
| Shows the IP, city, country and network that websites see |
country: two-letter code (us,de,jp, ...). Leave it out for any country.session: any name. Calls with the same name keep the same IP for 10 minutes, so an agent can browse several pages of one site as one visitor.
Example conversation:
You: What does the pricing page of example.com show to visitors from Japan?
The agent calls
fetch_page(url="https://example.com/pricing", country="jp")and reads the Markdown.
What the calls return (IP addresses and networks are placeholders; yours will differ):
check_exit_ip {'country': 'jp'} -> IP 198.51.100.7, Tokyo, Tokyo, JP (AS64500 Example ISP)
check_exit_ip {'country': 'us', 'session': 'a'} -> IP 203.0.113.42, Austin, Texas, US (AS64501 Example Broadband)
check_exit_ip {'country': 'us', 'session': 'a'} -> IP 203.0.113.42, Austin, Texas, US (AS64501 Example Broadband)
fetch_page(https://quotes.toscrape.com/, country=gb) -> Status: 200 ... # [Quotes to Scrape](/) ...The same session gives the same IP; a new session or no session gives a new one.
Related MCP server: GeoRanker Web Scraping MCP
Setup
You need Fusion Proxy credentials (username and password from the dashboard; there is a free trial) and uv (or pip).
Claude Code
claude mcp add fusionproxy -e FUSION_USER=your_username -e FUSION_PASS=your_password \
-- uvx --from git+https://github.com/FusionProxies/fusionproxy-mcp fusionproxy-mcpClaude Desktop
claude_desktop_config.json (Settings, Developer, Edit Config):
{
"mcpServers": {
"fusionproxy": {
"command": "uvx",
"args": ["--from", "git+https://github.com/FusionProxies/fusionproxy-mcp", "fusionproxy-mcp"],
"env": { "FUSION_USER": "your_username", "FUSION_PASS": "your_password" }
}
}
}Cursor
~/.cursor/mcp.json: the same mcpServers block as for Claude Desktop.
VS Code
.vscode/mcp.json:
{
"servers": {
"fusionproxy": {
"type": "stdio",
"command": "uvx",
"args": ["--from", "git+https://github.com/FusionProxies/fusionproxy-mcp", "fusionproxy-mcp"],
"env": { "FUSION_USER": "your_username", "FUSION_PASS": "your_password" }
}
}
}Without uv
pip install git+https://github.com/FusionProxies/fusionproxy-mcp
fusionproxy-mcp # speaks MCP over stdio; point your client's "command" at itSettings
Variable | Required | Meaning |
| yes | Proxy username (main user or a sub-user) |
| yes | Proxy password |
| no | Default country when a call does not pass one |
| no | Gateway |
Traffic through the server counts against your residential plan like any other request. A typical HTML page is 50 KB to 2 MB.
How it works
Each call opens a connection to the Fusion Proxy gateway with the options in the username (-country-jp, -sessid-...-sessTime-600s), downloads the page with a normal browser User-Agent, follows redirects and converts HTML to Markdown with html2text. If a residential connection drops, the call retries once on a new connection. Only public http and https URLs are accepted: localhost, .local names and private, loopback or reserved IP addresses are refused.
The server does not run JavaScript. For pages that render in the browser, see playwright-proxy.
Works with the MCP Python SDK 1.x and 2.x.
Development
pip install -e ".[test]"
pytest # no network and no credentials neededChanges are listed in CHANGELOG.md.
Use responsibly
Fetch public pages only, respect the sites' terms and robots.txt, and keep the request rate reasonable.
Related
fusionproxy: code examples in 8 languages
python-web-scraping: a requests + BeautifulSoup scraper
Residential proxies from $2.95/GB
License
MIT, see LICENSE.
Available Tools
2 toolscheck_exit_ipB
Show the IP address, location and network that websites see through the proxy.
Args: country: two-letter country code of the exit IP. Optional. session: session name to check a sticky IP. Optional.
Inputs: country, session. Returns: result
fetch_pageA
Fetch a public web page through a residential IP and return its content.
Args: url: http(s) URL of the page. country: two-letter country code of the exit IP (for example "us", "de", "jp"). Optional. session: any name; calls with the same name keep the same IP for 10 minutes. Optional. output: "markdown" (default, readable), "text" or "html" (raw). max_chars: cut the result to this many characters (default 20000).
Inputs: url (required), output, country, session, +1 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
fetch_page retrieves page content while check_exit_ip is a pure diagnostic that reports the exit IP/geo; their purposes are unmistakably distinct despite sharing the optional country/session parameters. An agent would never confuse the two.
Both tools follow the same snake_case verb_noun convention (fetch_page, check_exit_ip), with verbs that accurately describe the action. No mixing of styles or vague names.
Two tools is on the thin side; fetch plus a single diagnostic leaves little room for related operations. The scope is coherent, but the surface is closer to a minimal wrapper than a well-rounded toolset.
The core operation (proxied page fetch) and the key verification step (exit IP check) are both present, covering the main workflow. Minor gaps exist: no non-GET requests, no session management (list/clear/expire), and the sticky-IP duration is fixed.
Maintenance
Related MCP Connectors
Web search, browser automation, scraping, crawling and CAPTCHA solving for AI agents.
Reliable web access for AI agents: smart HTTP, rotating proxies, and full-browser rendering.
Web data for agents. Extract web pages, crawl websites, discover URLs, and search the web.
Web scraping, search, crawling, structured extraction and research for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to fetch and extract clean, readable content from web pages, and search within pages for specific queries, without needing a full browser.1MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to fetch public web pages as readable text or HTML, with caching, live refresh, and parallel job handling.317 npmMIT

JsonLink MCP Serverofficial
AlicenseAqualityCmaintenanceEnables AI agents to read any web page as clean Markdown, pull title/description/preview metadata, capture desktop, mobile, or full-page screenshots, and list every link or image on a URL. JavaScript-heavy pages are rendered in a real browser and blocked requests retried through a proxy, so agents can reach content they'd otherwise miss.561 npmMIT- AlicenseAqualityCmaintenanceEnables AI agents to fetch any web page and receive clean, token-efficient Markdown, escalating only as needed from direct HTTP with browser TLS fingerprints to headless-browser rendering and residential proxies when a site blocks access. Supports question-focused passage retrieval with BM25 ranking, pagination, caching, JS rendering control, and safe-by-default restrictions on local and private-network URLs.1AGPL 3.0