Windsurf

Connect Scrubby to Windsurf's Cascade agent through the MCP server.

Setup

1

Add the MCP server

Open Windsurf's MCP config file — ~/.codeium/windsurf/mcp_config.json on macOS/Linux, or %USERPROFILE%\.codeium\windsurf\mcp_config.json on Windows, creating it if it doesn't exist, and add:

{
  "mcpServers": {
    "scrubby": {
      "serverUrl": "https://mcp.scrubby.ai/mcp"
    }
  }
}

You can also add Scrubby through Windsurf Settings › Cascade › MCP Servers, which writes to the same file.

2

Reload Cascade

Cascade picks up new MCP servers on the next chat session. Start a new conversation or restart Windsurf.

3

Authenticate

The first time Cascade calls a Scrubby tool, you're prompted to authenticate via GitHub OAuth. Sign in with your GitHub account.

4

Index a repository

Ask Cascade to run scrubby_index with your repository in owner/repo form. See Your First Index.

Using Scrubby

Cascade reads Scrubby's tool descriptions and decides when to call them. You can also prompt for a tool directly (for example, "Run scrubby_review_changeset on my staged changes"). The Windsurf MCP config is global, so Scrubby is available across every project you open, but indexing is per-repository, so each project still needs its own initial scrubby_index call. The full tool list is in the MCP Tools reference.

Troubleshooting