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": {
    "yt-text": {
      "command": "yt-text",
      "args": []
    }
  }
}

If yt-text is not on PATH, use an absolute path for command.

Verify¶

Open the MCPs panel in Cascade and confirm that yt-text 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.