Zed integration

Zed's agent, with a browser of its own.

Add UnblockingAPI's hosted MCP server to Zed's context_servers and the agent panel reads pages that block automated tools - rendered, or as JSON where a template covers the site.

500 free credits  ·  1 credit per successful fetch  ·  Open-source MCP server

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

The live web

Docs, changelogs and listings as they are now, through our proxy network.

Browser only when needed

A plain fetch first and a real browser when the site needs one, learned per site.

Nothing to run

The hosted server needs no Node and no local process - just a URL in settings.json.

Zed's agent is fast at editing but only as good as what it can read. unblock_fetch gives it pages that render client-side or sit behind bot protection, and find_templates turns known sites into JSON fields.

Add it to Zed

Hosted server with an API key

RecommendedURL + API key

Same hosted URL, authenticated by your key in a header.

settings.json

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

Hosted server, signing in

Sign in, no key

Paste the hosted URL and approve access. No key to copy, nothing to install.

settings.json

"context_servers": {
  "unblockingapi": {
    "url": "https://mcp.unblockingapi.com/mcp"
  }
}
Without an Authorization header, Zed prompts you to sign in to UnblockingAPI.

Run it locally

Local server

Prefer to run the server yourself? It is open source and runs with npx (Node.js 18+).

settings.json

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

Try it in Zed

Ask this once you're connected. Zed should find the idealista template with find_templates and come back with parsed results instead of HTML.
Use unblockingapi to get the listings on https://www.idealista.com/venta-viviendas/estepona-malaga/ as structured data, then summarise the three cheapest.

Zed questions

Into your Zed settings.json under context_servers. Settings → AI → MCP Servers → Add Server → Add Remote Server writes the same entry for you.

Zed signs in with OAuth when a remote server has no Authorization header, and that works with UnblockingAPI. Its token refresh has been reported as unreliable on some versions, though, so the key header is the dependable choice until that settles.

With the key header, the key is stored in Zed's config, so keep that file out of source control. Where sign-in is available it is the safer option: the app then holds only a revocable token, and you can disconnect it under Connected apps.

The MCP server is free and open source. Fetches run on your UnblockingAPI account: every successful fetch costs 1 credit and failed ones are free. New accounts get 500 free credits with no credit card, and bigger credit packs add bonus credits. Looking up templates is free.

Three, all read-only. unblock_fetch reads any URL through our proxy network (residential and mobile connections where a site needs them) and a real browser, picking a plain fetch or a browser per site by itself. It returns the page as Markdown (HTML on request), or JSON with a template. find_templates checks whether a published template covers a site. get_build_guide gives Zed the API reference and app guides when you build an app on the API. Details on the MCP server page.

The hosted server: nothing to install or update, and most apps sign in without a key. Run it locally with npx -y @unblockingapi/mcp if you prefer to keep the process on your machine - the tools and costs are the same.

Give Zed a real browser.

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