Install: Windsurf

Quick install (macOS and Linux)

Run the following command to install Unblocked MCP:

curl -fsSL https://getunblocked.com/install-mcp.sh | bash

The script downloads the Unblocked CLI and sets up your supported agents.

The install script supports macOS and Linux. On Windows, follow the install guide for your app.

Manual install (macOS, Windows, Linux)

You can install the tools into Windsurf by selecting Windsurf: MCP Marketplace in the command palette, and clicking on the cog icon, or by editing the MCP config file:

macOS / Linux: ~/.codeium/windsurf/mcp_config.json
Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

{
  "mcpServers": {
    "unblocked": {
      "serverUrl": "https://getunblocked.com/api/mcpsse"
    }
  }
}

After saving the file Windsurf will prompt you to authenticate with Unblocked via OAuth.

Windsurf added support for OAuth authentication in version 1.12.35 on November 21, 2025. Older versions may not work correctly.

Getting Started with Unblocked

Product Guides

Using Unblocked

Personal Settings

Team Settings

Billing

Data Sources

Quick install (macOS and Linux)

Manual install (macOS, Windows, Linux)

​Quick install (macOS and Linux)

​Manual install (macOS, Windows, Linux)

Quick install (macOS and Linux)

Manual install (macOS, Windows, Linux)