U
unblockingapi/mcp
Official MCP server for UnblockingAPI — read any web page (bot-protected, JavaScript-heavy, geo-blocked) and parse it to JSON with templates. Hosted at mcp.unblockingapi.com or run locally with npx.
SECURITY.md ✓
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
Remote endpoint (mcpServers - Claude Desktop / Cursor / Windsurf)
{
"mcpServers": {
"unblockingapi-mcp": {
"url": "https://mcp.unblockingapi.com/mcp"
}
}
}Paste this into the mcpServers config of Claude Desktop or Cursor. The endpoint comes from public evidence; we do not install or host it. Official Registry record: this endpoint declares a required request header Authorization (Bearer followed by your UnblockingAPI key from https://unblockingapi.com (500 free credits, no card), e.g. 'Bearer sk_...'.). Using it means bringing your own credentials.
VS Code (.vscode/mcp.json - the key is servers, remote needs type: http)
{
"servers": {
"unblockingapi-mcp": {
"type": "http",
"url": "https://mcp.unblockingapi.com/mcp"
}
}
}VS Code differs from the other three: the top-level key is <code>servers</code> and a remote endpoint also needs <code>"type": "http"</code>. Paste into .vscode/mcp.json.
Claude Code (command line)
claude mcp add --transport http unblockingapi-mcp https://mcp.unblockingapi.com/mcp
Claude Code does not read a config file; add the server with this command.
Client config (built from the install command this repo gives)
{
"mcpServers": {
"unblockingapi-mcp": {
"command": "npx",
"args": ["-y", "@unblockingapi/mcp."]
}
}
}Parsed from the README we fetched on 2026-10-26; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"unblockingapi-mcp": {
"command": "npx",
"args": ["-y", "@unblockingapi/mcp."]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio unblockingapi-mcp -- npx -y @unblockingapi/mcp.
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Star count
- 2 ★ · unblockingapi/mcp · read from the GitHub search API · (checked 2026-11-13 20:00:50)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-10-23 · last seen 2026-11-14 · seen 26× · listed by 23 sources
- Score
- score 2,300 · 2 ★ · 23 sources · mcp
- Install
npx -y @unblockingapi/mcp.
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx -y @unblockingapi/mcp.. It comes from the repository itself; we cannot guarantee it runs as-is in your client.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
unblockingapi/mcp；first catalogued 2026-10-23；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.# @unblockingapi/mcp
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
Official Model Context Protocol server and
Claude Code plugin for UnblockingAPI. Gives AI
apps (Claude, Cursor, VS Code, Lovable, Replit, …) a real browser behind
rotating residential proxies: fetch bot-protected and JavaScript-heavy pages,
and parse any site a published template covers into structured JSON.
Hosted at https://mcp.unblockingapi.com/mcp — add it as a connector and
sign in, no install. Or run it locally with npx -y @unblockingapi/mcp.
## Tools
| Tool | What it does | Cost |
| unblockfetch | Fetch public web pages that block simple requests, and get clean Markdown or HTML back. Picks plain HTTP or a real browser per site by itself; pass template to get structured JSON instead. Optionally narrowed with a CSS select. | 1 credit per success; re-reading the same fetch is free |
| findtemplates | Find a template that parses a site into JSON — by the URL you are about to fetch, by keyword, or by category — with its output shape. | free |
| getbuildguide | Guides for building apps on the REST API with plain HTTP: API reference, getting complete pages, templates, and recipes (rank tracker, listings aggregator, price monitor). | free |
Failed requests are free. The server's instructions, tool descriptions and the
notes in each response steer the agent: let the API choose plain fetch or
browser, check for a template before parsing a known site, scroll or wait when
content is missing, and read the build guide before writing code that calls the API.
### Templates
A template turns a page into named fields instead of markup. The catalogue is
open-ended — search engines, marketplaces, property portals, company registries
— and anyone can publish one from the editor.
There is no special handling for any particular site: every template, official
or community, is reached the same way.
findtemplates(url: "https://www.google.com/search?q=…") → kjellberg/google-search
unblockfetch(url: "…", template: "kjellberg/google-search") → { query, results, relatedsearches }
findtemplates asks the API, which matches the URL against every published
template's host, path and required query parameters the same way the template
library does ( is one path segment, any deeper path, hosts exact unless
the pattern says . or .), so a match is found however large the
catalogue grows. More results than fit come back with a page to ask for next.
If a parser fails because the site changed, you get raw HTML back with
parseerror: true rather than an error.
### API endpoints behind the tools
| Tool | Calls | Key |
| unblockfetch | POST https://api.unblockingapi.com/unblock (JSON body; template selects a template) | X-Api-Key |
| findtemplates | GET https://api.unblockingapi.com/templates.json?url=…&q=…&category=…&limit=…&page=… (the public catalogue, searched server-side; answers cached for 5 minutes), plus GET https://app.unblockingapi.com/public/v1/templates/ / for the output shape when three or fewer match | none |
| getbuildguide | nothing: the guides ship in the package (guides/) | none |
Templates are not endpoints of their own: there is no /api/google-search or
/api/ , only /unblock with template set.
### Removed tools
Older versions, and listings copied from them, mention tools that no longer
Claude Code plugin for UnblockingAPI. Gives AI
apps (Claude, Cursor, VS Code, Lovable, Replit, …) a real browser behind
rotating residential proxies: fetch bot-protected and JavaScript-heavy pages,
and parse any site a published template covers into structured JSON.
Hosted at https://mcp.unblockingapi.com/mcp — add it as a connector and
sign in, no install. Or run it locally with npx -y @unblockingapi/mcp.
## Tools
| Tool | What it does | Cost |
| unblockfetch | Fetch public web pages that block simple requests, and get clean Markdown or HTML back. Picks plain HTTP or a real browser per site by itself; pass template to get structured JSON instead. Optionally narrowed with a CSS select. | 1 credit per success; re-reading the same fetch is free |
| findtemplates | Find a template that parses a site into JSON — by the URL you are about to fetch, by keyword, or by category — with its output shape. | free |
| getbuildguide | Guides for building apps on the REST API with plain HTTP: API reference, getting complete pages, templates, and recipes (rank tracker, listings aggregator, price monitor). | free |
Failed requests are free. The server's instructions, tool descriptions and the
notes in each response steer the agent: let the API choose plain fetch or
browser, check for a template before parsing a known site, scroll or wait when
content is missing, and read the build guide before writing code that calls the API.
### Templates
A template turns a page into named fields instead of markup. The catalogue is
open-ended — search engines, marketplaces, property portals, company registries
— and anyone can publish one from the editor.
There is no special handling for any particular site: every template, official
or community, is reached the same way.
findtemplates(url: "https://www.google.com/search?q=…") → kjellberg/google-search
unblockfetch(url: "…", template: "kjellberg/google-search") → { query, results, relatedsearches }
findtemplates asks the API, which matches the URL against every published
template's host, path and required query parameters the same way the template
library does ( is one path segment, any deeper path, hosts exact unless
the pattern says . or .), so a match is found however large the
catalogue grows. More results than fit come back with a page to ask for next.
If a parser fails because the site changed, you get raw HTML back with
parseerror: true rather than an error.
### API endpoints behind the tools
| Tool | Calls | Key |
| unblockfetch | POST https://api.unblockingapi.com/unblock (JSON body; template selects a template) | X-Api-Key |
| findtemplates | GET https://api.unblockingapi.com/templates.json?url=…&q=…&category=…&limit=…&page=… (the public catalogue, searched server-side; answers cached for 5 minutes), plus GET https://app.unblockingapi.com/public/v1/templates/ / for the output shape when three or fewer match | none |
| getbuildguide | nothing: the guides ship in the package (guides/) | none |
Templates are not endpoints of their own: there is no /api/google-search or
/api/ , only /unblock with template set.
### Removed tools
Older versions, and listings copied from them, mention tools that no longer
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/unblockingapi-mcp/)
- Source
- awesome · https://github.com/unblockingapi/mcp
- Browse by field
- MCP servers
- Traction
- 2 ★
- Listed by
- 23 independent sources
- added
- today
- Security policy
- the repository has
SECURITY.mdat its root (we checked that the file exists, not what it says)
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.