> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getunblocked.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install: Windsurf

## Quick install (macOS)

Run the following command to install Unblocked MCP:

```bash theme={null}
curl -fsSL https://getunblocked.com/install-mcp.sh | bash
```

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

<Note>
  The install script is currently supported on macOS only. Windows and Linux users should use the manual install instructions below.
</Note>

## 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`

```json theme={null}
{
  "mcpServers": {
    "unblocked": {
      "serverUrl": "https://getunblocked.com/api/mcpsse"
    }
  }
}
```

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

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