Windsurf¶

Official docs:

• https://docs.windsurf.com/windsurf/cascade/mcp

Config File¶

Windsurf's current docs point to the user-level config file:

• ~/.codeium/windsurf/mcp_config.json

You can also add MCP servers from the MCPs panel in Cascade or from Windsurf Settings > Cascade > MCP Servers.

Example Config¶

{
  "mcpServers": {
    "tubebrain": {
      "command": "tubebrain",
      "args": []
    }
  }
}

If tubebrain is not on PATH, use an absolute path for command.

Verify¶

Open the MCPs panel in Cascade and confirm that tubebrain is installed and connected. Then ask Cascade to call get_metadata.

Notes¶

• Windsurf supports stdio, HTTP, and SSE MCP transports.
• The current docs emphasize user-level config plus the MCP Marketplace UI, rather than a project-checked mcp.json pattern.
• Cascade enforces a limit of 100 total tools available at once, so keep MCP sprawl under control if you add many servers.