Reference

The UnblockingAPI MCP server

One hosted endpoint for every AI app that speaks MCP. Sign in with your account or send your key; your AI gets tools for reading the live web and for building apps on it. Prefer to run it yourself? It's open source.

Setup guides for 12 apps
Hosted MCP server

Server URL

https://mcp.unblockingapi.com/mcp
  1. 1Add a custom connector (or remote MCP server)
  2. 2Paste the URL above
  3. 3Sign in to UnblockingAPI and click Allow

The app never sees your API key. Disconnect it any time under Connected apps.

At a glance

Endpoint
https://mcp.unblockingapi.com/mcp
Transport
Streamable HTTP (stateless). Replies stream, so long renders stay connected.
Sign-in
OAuth 2.1 with PKCE. Clients discover it from /.well-known/oauth-protected-resource and register themselves; the authorization server is app.unblockingapi.com and the scope is mcp.
API key instead
Authorization: Bearer <key> or X-Api-Key: <key>.
Tools
Three: unblock_fetch and find_templates for reading pages, get_build_guide for building apps on the API. All read-only.
Timeouts
A fetch can take up to about three minutes when a plain fetch falls back to a browser. Most return in seconds.
Limits
Your plan's concurrency applies, the same as the REST API.
Listings
MCP Registry (io.github.unblockingapi/mcp), npm, GitHub (MIT).

The tools

Your AI picks them by itself. Leave render unset: the API fetches plainly first and uses a real browser when a site needs one.

unblock_fetch

Fetch a URL through UnblockingAPI

Reads any page through rotating residential proxies and a real browser. Picks a plain fetch or a browser per site by itself. Returns the page as Markdown, or HTML on request; pass a template to get JSON instead.

url
The page to read.
template
A template reference (e.g. kjellberg/google-search) to get structured JSON.
render
Leave unset to let the API decide; true forces a browser, false never uses one.
location
Two-letter country to fetch from (us, gb, de, …).
wait_for, wait_state, settle_ms, scroll_steps, wait_min_ms, wait_rules, detect_ms
Fine-tune a browser render when content is still missing.
format
markdown (the default) or html, for markup and attributes.
select
A CSS selector: return only the matching elements.
fresh
Fetch again instead of reusing the same fetch from the last few minutes (reused copies are free).
max_age
Accept a cached copy up to this many seconds old (0–300).
max_chars
Cap on the body returned to the model (default 80,000).

1 credit per successful fetch; failures are free

find_templates

Find a structured-data template

Checks whether a published template parses a site into JSON — by the URL you're about to fetch, a keyword or a category.

url
The page you intend to fetch; returns templates built for that site.
search
Keyword matched against name, host and description.
category
A category slug, e.g. search-results or real-estate.
limit
How many to return (default 25).

Free

get_build_guide

How to build an app on UnblockingAPI

For writing code on the API: the REST reference, keeping the key server-side, templates, and complete recipes (rank tracker, listings aggregator, price monitor).

topic
api, fetch-tuning or templates, or a recipe: rank-tracker, listings-aggregator, price-monitor.

Free

Generic config with a key

For an app without a guide here: most take a URL and headers in this shape (some call the URL key serverUrl or httpUrl). Leave the headers out if the app supports MCP sign-in.

{
  "mcpServers": {
    "unblockingapi": {
      "url": "https://mcp.unblockingapi.com/mcp",
      "headers": { "Authorization": "Bearer your_api_key_here" }
    }
  }
}

Run it locally

The same server over stdio, for apps that launch local MCP servers. Needs Node.js 18+.

{
  "mcpServers": {
    "unblockingapi": {
      "command": "npx",
      "args": ["-y", "@unblockingapi/mcp"],
      "env": { "UNBLOCKINGAPI_KEY": "your_api_key_here" }
    }
  }
}

Questions

The app's name as it registered itself, the UnblockingAPI account you're signed in as, and the address you'll be sent back to. The app can fetch pages and look up templates on your account - nothing else: no key, password or billing access.

Under Settings → Connected apps on app.unblockingapi.com. It is signed out at once.

That is the server's answer to a request without credentials: a 401 pointing at its sign-in metadata. Apps that support MCP sign-in follow it automatically; for others, add the key header.

Same tools and costs. Hosted needs nothing installed and most apps sign in without a key. Local runs npx -y @unblockingapi/mcp on your machine with UNBLOCKINGAPI_KEY set, which some people prefer for control or offline config management.

Give your AI a real browser.

500 free credits, no credit card. Connect in under a minute.