Install: Windsurf

Quick install (macOS and Linux)

Run the following command to install Unblocked MCP:

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

This will download the Unblocked CLI and configure your supported tools and agents automatically.

The install script supports macOS and Linux. Windows users should use the manual install instructions below.

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)