Skip to main content

​
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.