Windsurf

Windsurf (formerly Codeium) ships its agentic IDE around the Cascade agent, with full Model Context Protocol support. Wire Scrubby into Cascade and the agent picks up your repo’s architectural domains, conventions, and co-change patterns automatically.

Setup

1. Add the MCP server

Open Windsurf’s MCP config file:

• macOS / Linux: ~/.codeium/windsurf/mcp_config.json
• Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

Create the file if it doesn’t exist (Windsurf doesn’t create one on first launch). Add the Scrubby entry:

{
  "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. Either start a new conversation or restart Windsurf.

3. Authenticate

The first time Cascade calls a Scrubby tool, you’ll be prompted to authenticate via GitHub OAuth. Sign in with the GitHub account you used for Scrubby.

4. Index your repository

Ask Cascade to run scrubby_index:

"Index this repo with Scrubby — it's owner/repo-name."

Indexing takes 1–3 minutes. After that it stays current incrementally.

How it feels

Cascade reads Scrubby’s MCP tool descriptions and decides when to call them. You don’t need to prompt for specific tools, but you can nudge it:

• “Run scrubby_review on this file before editing it.”
• “Run scrubby_review_changeset on my staged changes.”
• “What’s the blast radius of changing the auth domain?”

The full tool surface is documented in the MCP Tools Reference.

Notes

• One config file, every project. The Windsurf MCP config is global, not per-project. Add Scrubby once and Cascade has access to it across every repo you open. Indexing happens per-repo, so each project still needs its own initial scrubby_index call.
• Settings UI vs file. Either entry point writes to the same mcp_config.json. Pick whichever is faster for you.

Troubleshooting

See Editor Not Connecting. Quick fixes:

• Tools not appearing in Cascade — check that ~/.codeium/windsurf/mcp_config.json exists, is valid JSON, and that you’ve started a new chat session since editing it.
• Authentication never completes — check your default browser is reachable. If OAuth is stuck, open your Scrubby dashboard, log out, and reconnect from Cascade.
• Repository not indexed — ask Cascade to call scrubby_index with your repo name in owner/repo format.