QuantumProxies MCP
An MCP server for the QuantumProxies proxy service that gives an agent scraping, search, site crawling and proxy endpoints
- 779 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Spends your paid QuantumProxies balance on every request, crawl and collector, so a long site crawl can quickly use up purchased traffic
- Scraping through residential IPs and retrying refused requests from another address can violate site terms of use and get your account banned there; the user is responsible for legal compliance
- The `generate_proxies` and `whitelist_ip` tools issue working proxy credentials and change the allowed IP list on your account
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/quantumproxies-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Spends your paid QuantumProxies balance on every request, crawl and collector, so a long site crawl can quickly use up purchased traffic
- Scraping through residential IPs and retrying refused requests from another address can violate site terms of use and get your account banned there; the user is responsible for legal compliance
- The `generate_proxies` and `whitelist_ip` tools issue working proxy credentials and change the allowed IP list on your account
This is third-party code. Review the repository files before installing.
What it does
QuantumProxies MCP connects the paid QuantumProxies service to Claude, Cursor and other MCP clients. The agent gets 28 tools for the live web. `scrape` fetches a page as Markdown, HTML or text, including PDF and Office documents, and can extract data by schema. `search` returns structured Google, Bing and DuckDuckGo results, and `search_and_read` also reads the top pages and builds numbered sources for citation. `map` discovers a site's URLs, `crawl` goes through its pages and `batch` fetches many URLs in one run. The `unlock` tool replays an HTTP request through a residential exit with a real browser TLS fingerprint and tries another IP on a refusal. `seo_audit` compares a page as a no-JavaScript bot and fully rendered, and `ai_visibility` checks whether ChatGPT, Claude and Perplexity can read and cite a page. Ready-made collectors via `run_collector` return Google Maps places, reviews, jobs and site contacts. A separate group of tools manages proxies: `list_proxies` shows your plans with remaining traffic, `generate_proxies` issues ready connection strings with country, state, city, rotation or sticky sessions, and `whitelist_ip` manages allowed IPs.
Who it is for. For SEO specialists, analysts and developers who already have a QuantumProxies account and need an agent to collect data from sites and search results.
Good fit when
- An agent needs site pages as Markdown, PDF and Office documents included: `scrape` does that
- You need Google or Bing results with structure and a visit to the top links: `search_and_read` builds context for a prompt
- An SEO audit: `seo_audit` shows content that appears only after JavaScript runs, and `ai_visibility` estimates whether AI search can cite the page
- You need Google Maps places, reviews or jobs exported by a ready collector without writing a parser
- You want proxy strings for scripts straight from the agent chat: `generate_proxies` issues endpoints for the country you need
Not a fit when
- You have no QuantumProxies account and key: without a key the server only works for sending feedback through `report`
- The site's terms or the law forbid collecting its data: the user bears responsibility for such collection
- You want a local browser with no external service: every request goes through QuantumProxies infrastructure
Example request
Through QuantumProxies find the five cheapest Nintendo Switch OLED offers on Google for the US and show the pricesMCP
- Transport
- stdio, http
- Authentication
- API key
Environment variables
QUANTUMPROXIES_API_KEYrequired, secret- QuantumProxies API key of the form qp_live_..., issued in the service dashboard
QUANTUMPROXIES_TOOLS- Tool names or a preset (lite, web, research, collectors, proxies) to load only some of the 28
Limitations
- The service is paid. Traffic, API requests and ready collectors draw down your account balance, and the key looks like `qp_live_...`.
- All 28 tool definitions take about 14 thousand tokens of context. For local models with a small window set `QUANTUMPROXIES_TOOLS=web` or another preset to load only some tools.
- The repository holds only code examples in eight languages for proxy use. The MCP server ships as a separate npm package, `quantumproxies-mcp`.
- The server does not solve interactive captchas and flags such a response with a separate status.
How to disable. In Claude Code run `claude mcp remove quantumproxies`, and in Cursor or Claude Desktop delete the quantumproxies block from the MCP configuration file. If you connected over OAuth, a key named `MCP · <client>` sits on the API keys page of the dashboard, and deleting it disconnects the client.
FAQ
How do I connect QuantumProxies to Claude Code?
Run `claude mcp add quantumproxies -e QUANTUMPROXIES_API_KEY=qp_live_your_key -- npx -y quantumproxies-mcp`. Node.js 18 or newer is required, and the package needs no prior install. You get the key in the QuantumProxies dashboard.
Can I connect without a key, through OAuth?
Yes, the service has a remote endpoint, `https://api.quantumproxies.io/mcp`. A client that supports MCP authorization opens the QuantumProxies sign-in page, connects after you consent, and a key named `MCP · <client>` appears in the dashboard. Clients without OAuth can use an `Authorization: Bearer` header.
What does the `unlock` tool do?
It replays an HTTP request with its method, headers and body through a residential exit with a real browser TLS fingerprint. On a refusal it tries another IP, and for GET it can escalate to a real browser. It does not solve interactive captchas and returns the flag `blockClass: captcha`.
How do I cut the context spent on tool definitions?
Set the `QUANTUMPROXIES_TOOLS` variable. The `lite` preset keeps one tool, `search_and_read`, `web` adds `search` and `scrape`, and `research` adds `map` and `batch`. On the remote endpoint the `?tools=web` URL parameter does the same.
Which proxy types can I get through the server?
`list_proxies` shows plans of every type: residential Basic, Premium and Private, mobile, datacenter, ISP and IPv6. `generate_proxies` issues strings for an active plan with country, state, city, ISP and ASN targeting, over HTTP or SOCKS5.
Discussion
No questions or reviews yet.
Related
MCP serversHyperbrowser MCP
Hyperbrowser MCP Server
The official MCP server for Hyperbrowser cloud browsers: page scraping and crawling, structured data, Bing search and three browser agents
A browser extension and local proxy that bring MCP tools into web chat UIs like ChatGPT, Perplexity and Grok
Official Oxylabs MCP server: page scraping with JS rendering, Google and Amazon results, an AI crawler
Browserless.io MCP server: a cloud browser for the agent with page reads, site crawls, Lighthouse audits and click-driven sessions
Metasearch for agents: one MCP server and HTTP API merge results from many search providers into unified JSON with deduplication.
Official Apify MCP server: the agent runs ready-made Apify Store scrapers for social media, maps, search and shops
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| QuantumProxies MCP (this card) | yes | API key | 779 | |
| Oxylabs MCP Server | yes | key is optional | 105 | Oxylabs' official MCP server with scraping and Google and Amazon results; QuantumProxies adds proxy string issuing and IP list management |
| Firecrawl MCP Server | yes | API key | 7,809 | Firecrawl's official MCP server for search, scraping and crawling; it does not manage proxy plans or Google Maps collectors |
README in short
The repository README describes the QuantumProxies service: proxy types, the connection string format where country and session go into the username, and examples in eight languages. The web API section lists a scraper, SERP and AI extraction, and one line names the MCP server and the `npx quantumproxies-mcp` command. Example projects built on the service follow.