How to add MCP servers to Windsurf
Windsurf (Cascade) reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Remote servers use the "serverUrl" field.
~/.codeium/windsurf/mcp_config.jsonSetup in 4 steps
- 1
Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
- 2
Paste the Windsurf config from any server page on this site.
- 3
Fill in placeholder secrets, then save.
- 4
Click Refresh in the MCP panel. The server's tools become available to Cascade.
Recommended servers for Windsurf
GitHub's official server for repos, issues, PRs, and Actions — local Docker or hosted remote.
Microsoft's official browser-automation MCP using Playwright's accessibility tree (no vision model).
Official Stripe server for payments, customers, subscriptions, invoices, and billing via natural language.
Official MCP reference server that fetches a URL and returns its content as clean Markdown, with chunking.
Official MCP reference server for secure local filesystem read/write within allowed directories.
Official MCP server providing persistent, file-backed knowledge-graph memory across sessions.
Official MCP server for reading, searching, and manipulating a local Git repository's files and history.
Structured step-by-step reasoning tool for breaking problems into revisable thought sequences.
Up-to-date, version-specific library documentation injected into your coding agent.
Every server page has a one-click Windsurf config tab.
Browse all servers →