Install: Windsurf

Quick install (macOS)

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 is currently supported on macOS only. Windows and Linux 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.

Install: Cursor Install: Other

⌘I

Getting Started with Unblocked

Product Guides

Using Unblocked

Personal Settings

Team Settings

Billing

Data Sources

Quick install (macOS)

Manual install (macOS, Windows, Linux)

​Quick install (macOS)

​Manual install (macOS, Windows, Linux)

Quick install (macOS)

Manual install (macOS, Windows, Linux)