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.
Context7Up-to-date code docs for any promptnot 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
SupabaseMCP server for interacting with the Supabase platformnot reviewedWidely usedA- 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
- AIHawkAI browser agent: browses, clicks, types, and reads real web pages from plain-English instructions.not reviewedWidely usedA
- ArgentDrive iOS Simulators, Android emulators, TVs and Electron/web apps from your coding agentnot reviewedWidely usedA
- CCXTOfficial CCXT MCP server - Market data and trading across 100+ exchanges and prediction marketsnot reviewedWidely usedA
- agent-deviceMCP server for mobile app automation: verify, control, and debug iOS, Android, TV, and desktop appsnot reviewedWidely usedA
CloudBaseCloudBase MCP: DB, functions, storage, hosting via @cloudbase/cloudbase-mcpnot reviewedWidely usedA- XcodeBuildMCPXcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.not reviewedWidely usedB
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.