# UnblockingAPI

> UnblockingAPI is an MCP server for web search and scraping. Fetch bot-protected and JavaScript-heavy pages as Markdown or template-parsed JSON. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** API, CLI
- **Website:** https://unblockingapi.com
- **Repository:** https://github.com/unblockingapi/mcp
- **MCP Registry name:** io.github.unblockingapi/mcp
- **Categories:** web search and scraping, browser automation
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.unblockingapi.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.unblockingapi.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Mantis](https://ai-powered.com/mcp/mantis-2): Mantis is an open-source MCP server for browser automation.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [AI-Powered directory](https://ai-powered.com/mcp/ai-powered-directory): AI-Powered directory is a free MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/unblockingapi
