Skip to content
MCP server

UnblockingAPI

Fetch bot-protected and JavaScript-heavy pages as Markdown or template-parsed JSON

Pricing
Free trial
Platforms
API, CLI
Runs
Locally or Remotely
Version
0.8.4
Listing updated
3 days ago

About UnblockingAPI

UnblockingAPI is an MCP server for web search and scraping. It can run locally on your machine or as a hosted remote server.

UnblockingAPI's server hands an agent a real browser behind rotating residential proxies. It first tries a plain HTTP fetch and moves to a browser when the site needs one, so the agent gets page content instead of a 403. Requests can exit from a chosen country for local prices and language. Failed requests are free, and one successful request costs one credit regardless of rendering, proxy or retries.

The README documents three tools. unblock_fetch returns clean Markdown or HTML, optionally narrowed by a CSS selector, or structured JSON when you pass a template; find_templates searches the open catalogue of site templates by URL, keyword or category; get_build_guide serves guides for building price monitors, listings aggregators and rank trackers on the REST API. If a template parser breaks because a site changed, you get raw HTML back flagged parse_error.

Use the hosted endpoint with OAuth sign-in or run the npm package with an API key. New accounts get 500 free credits with no card; after that, one-time packs start at 5 euro for 5,000 credits and never expire. The company says use must be of public data and comply with its Acceptable Use Policy.

Install

Run in a terminal

claude mcp add --transport http mcp https://mcp.unblockingapi.com/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.unblockingapi.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.unblockingapi.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.unblockingapi.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.unblockingapi.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.unblockingapi.com/mcp"
    }
  }
}

Configuration

  • UNBLOCKINGAPI_KEYYour UnblockingAPI key from https://unblockingapi.com (500 free credits, no card).Required
  • UNBLOCKINGAPI_TIMEOUT_MSPer-request timeout in milliseconds. Default 180000.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

unblock_fetch
Fetch a public page as Markdown, HTML or template-parsed JSON.
find_templates
Find a template that parses a site into JSON.
get_build_guide
Guides for building apps on the REST API.

What it does

Browser fallback
Plain fetch first, a real rendered browser when a site requires it.
Country routing
Send the request through a connection in a chosen country.
Template parsing
Return named JSON fields for sites a published template covers.
Template search
Find a matching template by URL, keyword or category.
Build guides
Recipes for price monitors, aggregators and rank trackers.
Flat credit cost
One credit per successful request; failures are free.

Good for

  • Read a competitor's pricing page that blocks simple requests
  • Pull property listings as JSON from a portal
  • Compare local prices from another country
  • Read a JavaScript-only careers page
  • Build a scheduled price monitor with an agent

Pricing

Free trial

500 free credits, then one-time packs from 5 euro per 5,000 credits; no subscription

Prices change. Check unblockingapi.com before you buy.

UnblockingAPI FAQ

How is it billed?

In one-time credit packs from 5 euro, with 1 credit per successful request and no subscription.

Is there a free trial?

Yes. New accounts get 500 credits with no card.

Are failed requests charged?

No. Blocked and failed requests cost nothing.

How do I sign in?

OAuth on the hosted endpoint, or set UNBLOCKINGAPI_KEY for the npm package.

Is UnblockingAPI free?

UnblockingAPI is a paid product with a free trial.

How do I add UnblockingAPI to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.unblockingapi.com/mcp

What are the best alternatives to UnblockingAPI?

The closest alternatives to UnblockingAPI are Browser Use, Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search and Oya Browser.

Alternatives to UnblockingAPI

  1. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  2. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  3. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  4. SearXNG Search

    MCP server

    MCP server for web search and page reading through a SearXNG instance

    Runs locally
    • 3 tools
    • Open source
    • 1.4K GitHub stars
    • Web search and scraping
  5. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  6. Mantis

    MCP server

    Browser MCP server that gives agents numbered text pages instead of screenshots

    Runs locally
    • 1 tool
    • Open source
    • 5 Hacker News points
    • Browser automation