Serverdex client guide
MCP servers for Windsurf
Windsurf's Cascade agent (now documented at docs.devin.ai after the Cognition acquisition). Servers are listed under mcpServers in a JSON config file opened from Cascade.
Every setup fact on this page was read from Windsurf's own documentation on 19 November 2026 (sources at the end). Server data comes from the live Serverdex index of the official MCP registry.
What Windsurf supports
- Tools
- ✓ documented
- Resources
- ✓ documented
- Prompts
- ✓ documented
- Elicitation
- – not stated
Transports: stdio, Streamable HTTP, SSE. Remote servers and auth: Yes · HTTP/SSE only. Docs moved to docs.devin.ai after the Cognition acquisition; the tool cap documented earlier is no longer stated there (re-read 19 Nov 2026). Full matrix with every client on /mcp-clients.
Where the configuration lives
- Cascade's "Open MCP config file" action opens ~/.config/devin/mcp_config.json on macOS and Linux ($XDG_CONFIG_HOME/devin/mcp_config.json when that variable is set) and %AppData%/devin/mcp_config.json on Windows.
- The docs note that the editor's MCP discovery uses a separate, build-specific file.
Add a server to Windsurf
Local server (stdio) — mcp_config.json
{
"mcpServers": {
"server-name": {
"command": "npx",
"args": ["-y", "<package>"],
"env": { "API_KEY": "<value>" }
}
}
}Hosted server (HTTP) — mcp_config.json
{
"mcpServers": {
"server-name": {
"serverUrl": "https://<your-server-url>/mcp",
"headers": { "Authorization": "Bearer <token>" }
}
}
}For a specific server, open its Serverdex page: the “Connect this server” block has the config with the real package name, arguments and environment variables from the registry. Any server, any client: MCP config generator.
Hosted (remote) servers in Windsurf
- A remote HTTP server needs a serverUrl (or url) field, with an optional headers object. OAuth is not available for stdio servers.
Hosted servers that answered the Serverdex live check with no credentials at the last pass (most-starred first; full list with check times):
Browser Use
browser-use
Browser agents and stealth cloud browsers for AI: run web tasks, fill forms, extract data.
Labelhead Artist Momentum
paperclipai
Trending hip-hop artist momentum scores across four cultural dimensions.
Front-End Checklist
thedaviddias
Review frontend code and live pages against 386 quality-gated web development rules.
Context7
upstash
Up-to-date docs for AI agents
Tldraw
tldraw
Draw and visually collaborate with your agents on tldraw's canvas.
Oh My Posh Validator
JanDeDobbeleer
Validate oh-my-posh configurations and segment snippets against the official schema.
Compiler Explorer
compiler-explorer
Compile code with thousands of compilers, inspect the assembly, and share godbolt.org links
GitDiagram
ahmedkhaleel2004
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Spree Commerce developer docs for AI agents
spree
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
AIHOT
KKKKhazix
Chinese AI news: search topics, explore hot events, and read daily, weekly and monthly briefs.
Finance Database
JerBouma
Equities, ETFs, indices, currencies and cryptos, categorised.
OneUptime
OneUptime
Manage incidents, alerts, monitors, status pages, on-call and telemetry in OneUptime.
Find servers for Windsurf by job or by product
Every server page carries the config in the Windsurf shape, the repository's last push and licence, and the live-check result.
Best MCP servers by categoryMCP servers by productComparisonsRemote servers answering now
What the docs say to watch for
- Cascade supports tools, resources and prompts.
- Teams: once any server is allowlisted, every non-allowlisted server is blocked for that team.
Server not showing up or stuck on loading tools? The troubleshooting guide goes through the causes in order.
Windsurf and MCP: questions people ask
- Where is the Windsurf MCP config file?
- Cascade's "Open MCP config file" action opens ~/.config/devin/mcp_config.json on macOS and Linux ($XDG_CONFIG_HOME/devin/mcp_config.json when that variable is set) and %AppData%/devin/mcp_config.json on Windows. The docs note that the editor's MCP discovery uses a separate, build-specific file.
- Does Windsurf support remote (hosted) MCP servers?
- Yes. A remote HTTP server needs a serverUrl (or url) field, with an optional headers object. OAuth is not available for stdio servers. Transports per its docs: stdio, Streamable HTTP, SSE; remote and auth: Yes · HTTP/SSE only.
- Which MCP features does Windsurf support?
- Per its own documentation (read https://docs.devin.ai/windsurf/plugins/cascade/mcp): tools documented, resources documented, prompts documented, elicitation not stated, roots not stated, sampling not stated. "Not stated" means the docs are silent, not that the feature is missing.
- Which MCP servers should I add to Windsurf first?
- Pick by the job you need done: the Serverdex guides rank servers by GitHub stars within each category, with last push, licence and live check for each, and the product pages list every server for a given tool (Postgres, Notion, Slack, GitHub…). The hosted servers on this page answered our credential-free MCP handshake at the last check. Then copy the config from the server's page in the Windsurf shape.
Sources
- Windsurf docs: Cascade MCP — read 19 November 2026
Other clients: Claude Desktop · Claude Code · Cursor · VS Code · Cline · Zed · JetBrains AI Assistant · Continue · OpenAI Codex CLI.