Setup guide
MCP servers for Windsurf
Windsurf's Cascade agent reads MCP servers from one config file in your home folder, with the same mcpServers shape as most clients.
Where Windsurf keeps MCP servers
- Config file
~/.codeium/windsurf/mcp_config.json- In the app
Windsurf Settings, Cascade, MCP servers
How to add an MCP server to Windsurf
- Open the server's listing here and copy its Cursor snippet: Windsurf uses the same mcpServers shape.
- Paste it into ~/.codeium/windsurf/mcp_config.json. For a remote server use serverUrl as the key instead of url.
- Refresh the MCP servers list in Cascade's settings and check the server's tools appear.
mcp_config.json, a local server
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/path/to/folder"
]
}
}
}mcp_config.json, a remote server
{
"mcpServers": {
"example": {
"serverUrl": "https://mcp.example.com/mcp"
}
}
}Graded MCP servers to start with
The most used servers graded A or B by the safety scan, one per publisher. Each listing has the exact Windsurf setup.
- Browser UseBrowser agents and stealth cloud browsers for AI: run web tasks, fill forms, extract data.not reviewedWidely usedA
- REAReverse engineer anything from your terminal or agent with one CLI and MCP server.not reviewedWidely usedA
Context7Up-to-date docs for AI agentsnot reviewedWidely usedA- PlaywrightPlaywright Tools for MCPnot reviewedWidely usedA
Scrapling MCP ServerWeb scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.not reviewedWidely usedA- Chrome DevTools MCPMCP server for Chrome DevToolsnot reviewedWidely usedB
- RepomixPack local or remote codebases into AI-friendly files that LLMs and coding agents can read or searchnot reviewedWidely usedA
- SeleniumBase MCPStealthy browser automation, testing, and web-scraping via CDP Mode.not reviewedWidely usedA
- e2eOpen live web and mobile app sessions from an e2e project to inspect the app and try locators.not reviewedWidely usedA
SupabaseMCP server for interacting with the Supabase platformnot reviewedWidely usedA- Next AI Draw.iodraw.io diagrams your AI agent draws on a live browser canvas that you can also edit by handnot reviewedWidely usedA
- Firecrawl MCP ServerFirecrawl, the context API for AI agents: search, scrape, interact with the web, plus paper search.not reviewedWidely usedA
- Claude FlowAI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.not reviewedWidely usedB
- Figma ContextGive your coding agent access to your Figma data. Implement designs in any framework in one-shot.not reviewedWidely usedB
- agent-deviceLet AI agents inspect, control, and debug real iOS, Android, desktop, and TV appsnot reviewedWidely usedA
Before you connect one
- Cascade has a cap on how many tools it loads across all servers. Disable tools and servers you do not need.
- Check the server's safety report first: which tools write, whether a remote endpoint needs auth, and what a package runs when it installs. What the scan checks.
Or add one server that reaches all of them
The mcp.market gateway (gw.mcp.market/mcp) lets Windsurf search graded servers and call them through one connection, and refuses F-graded ones. Gateway setup.
Questions people ask
- Where is the Windsurf MCP config?
- ~/.codeium/windsurf/mcp_config.json. Cascade's settings in Windsurf also open it.
- How do I add a remote MCP server to Windsurf?
- Add an entry under mcpServers with serverUrl set to the server's URL, then refresh the server list in Cascade's settings.