Tool for Windsurf

Cascade, with a browser of its own.

Add one URL to Windsurf's MCP config and sign in. Cascade then reads live docs and pages that block automated tools - rendered, or as JSON where a template covers the site.
Connect Windsurf

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

Windsurf · hosted MCP server

Server URL

https://mcp.unblockingapi.com/mcp
  1. 1In the Cascade panel, open … → MCPs → Open MCP config file
  2. 2Add unblockingapi with the URL as serverUrl
  3. 3Refresh, switch it on, sign in to UnblockingAPI and allow access

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

Docs as they are today

Cascade reads the current API reference instead of recalling an old one.

Rendered pages

Client-side apps and dashboards come back complete, not as an empty shell.

One file, every project

The MCP config is global, so the tools follow you into every workspace.

Cascade's own web tools stall on pages that render with JavaScript or sit behind bot protection. unblock_fetch takes a plain fetch first and a real browser when needed; find_templates turns known sites into JSON.

Add it to Windsurf

Hosted server, signing in

RecommendedSign in, no key

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

mcp_config.json

{
  "mcpServers": {
    "unblockingapi": { "serverUrl": "https://mcp.unblockingapi.com/mcp" }
  }
}
Save, refresh the MCPs list, switch the server on and complete the sign-in in your browser.

Hosted server with an API key

URL + API key

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

mcp_config.json

{
  "mcpServers": {
    "unblockingapi": {
      "serverUrl": "https://mcp.unblockingapi.com/mcp",
      "headers": { "Authorization": "Bearer your_api_key_here" }
    }
  }
}
Windsurf can read the key from an environment variable instead: Bearer ${env:UNBLOCKINGAPI_KEY}.

Run it locally

Local server

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

mcp_config.json

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

Make it Cascade's default

Add this to your global rules (or a workspace rule) so Cascade reads every page through UnblockingAPI.
When you need the contents of a URL, use the unblock_fetch tool from the
unblockingapi MCP server instead of the built-in web tools. Leave render unset.
Before parsing a recognisable site by hand, call find_templates with the URL and
pass a matching template to unblock_fetch to get JSON.

Try it in Windsurf

Ask this once you're connected. Windsurf should find the Google template with find_templates and come back with parsed results instead of HTML.
Use unblockingapi to get the Google results for "best espresso machine" as structured data, then summarise the top three.
No code

Want structured data instead of raw HTML?

unblock_fetch hands back the full rendered page. For clean fields instead - a price, a title, a whole list - build a template visually in the editor: load the page, tap what you want, done. No CSS selectors to write by hand.

Save it and it's a reusable API endpoint - same account, same key, same as the built-in templates. Build the structure once, then call it from your app - or your AI agent - forever.

Try the editor

No account needed to try it  ·  No credit card  ·  More about the editor

amazon.comSample data

Select one item. Similar items are detected automatically.

Website

Sony WH-1000XM5

4.6

$299.99

Bose QuietComfort

4.5

$249.00

Bang & Olufsen Beoplay

4

$1,714.99

Extracted JSON

{ "products": [
  { "name": "Sony WH-1000XM5", "price": 299.99, "currency": "USD", "rating": 4.6 },
  { "name": "Bose QuietComfort", "price": 249, "currency": "USD", "rating": 4.5 },
  { "name": "Bang & Olufsen Beoplay", "price": 1714.99, "currency": "USD", "rating": 4 }
] }

Tap one item, get every item - as an array.

Windsurf questions

Open it from Cascade: the … menu in the Cascade panel → MCPs → Open MCP config file. The location has changed between versions, so this is the reliable way in. Remote servers use serverUrl.

Save the file and refresh the MCPs list in the Cascade panel, then switch the server on. On team plans with an MCP allowlist, the server id (unblockingapi) has to be allowlisted first.

Not when you sign in. Windsurf gets an access token for the hosted server, and the server uses your key on its behalf, so the key itself never leaves UnblockingAPI. You can disconnect any time under Connected apps. If you connect with an API key header instead, the key is stored in Windsurf's own config.

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 plans make credits cheaper at volume. Looking up templates is free.

Three, all read-only. unblock_fetch reads any URL through rotating residential proxies 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 Windsurf the API reference and recipes 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.

Also works with

One account, every assistant. Connect as many as you like, or see them all.

Cursor

One click, then sign in

VS Code

code --add-mcp, then sign in

Zed

settings.json

Cline

Remote Servers tab + API key

Claude

Connector, plugin or one command

Lovable

Chat connector, then sign in

Give Windsurf a real browser.

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