Windsurf Docs MCP: what works in Claude, ChatGPT, Cursor, and Grok Bot
Windsurf editor docs remote MCP server. No sign-in needed.
Registry name: (v)
Set it up
URL https://docs.windsurf.com/mcp. No sign-in. Paste the URL and it connects. Copy-paste setup: Claude | Claude Code | Cursor | VS Code | ChatGPT
Status grid
| App | Status | Date tested |
|---|---|---|
| Claude | Untested | Not yet tested |
| ChatGPT | Untested | Not yet tested |
| Cursor | Untested | Not yet tested |
| Grok Bot | Untested | Not yet tested |
| MCP Inspector (reference client) | Untested | Not yet tested |
| MCP TypeScript SDK (reference client) | Partial | Fri Oct 16 2026 |
Hands-on test results
| App | Task | Result | Time | Detail | Date tested |
|---|---|---|---|---|---|
| MCP TypeScript SDK (reference client) | connect (no auth) | Works | 753 ms | Connected without sign-in in 753 ms. | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | list tools | Works | 303 ms | 3 tools: search_windsurf_docs, query_docs_filesystem_windsurf_docs, submit_feedback. | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | search docs ("add an MCP server") | Works | 1306 ms | search_windsurf_docs: about 137 KB returned. "Title: Adding a new MCP Link: https://docs.windsurf.com/windsurf/cascade/mcp#adding-a-new-mcp Page: windsurf/cascade/mcp Content: ## Adding " | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | browse docs filesystem (ls /) | Works | 1003 ms | query_docs_filesystem_windsurf_docs: 152 characters returned. "exit: 0 --- stdout --- autocomplete best-practices chat command context-awareness de es fr ja plugins pt-BR ro security tab troubleshooting " | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | search with nonsense query | Partial | 740 ms | search_windsurf_docs: about 11 KB returned. "Title: Public GPG Key Link: https://docs.windsurf.com/security/reporting#public-gpg-key Page: security/reporting Content: ### Public GPG Key" | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | error handling (number as query) | Works | 200 ms | search_windsurf_docs: tool error, 112 characters returned. "Input validation error: Invalid arguments for tool search_windsurf_docs: query: Expected string, received number" | Oct 16, 2026, 4:45 PM CT |
Oct 16, 2026, 4:45 PM CT, MCP TypeScript SDK (reference client): Scripted client using the official MCP TypeScript SDK v1.32.1 against https://docs.windsurf.com/mcp (Streamable HTTP, protocol 2025-11-25). No sign-in needed. Mintlify-hosted docs server (search plus a read-only docs filesystem). Server Windsurf Docs v1.0.0. Read-only server, so no create task. 5 of 6 tasks passed.
Automated handshake
No public remote endpoint to check (local or package-only server).
Gotchas
- MCP TypeScript SDK (reference client): One search returned about 137 KB. Very heavy on context.
- MCP TypeScript SDK (reference client): A nonsense query still returns unrelated docs instead of an empty result, so an agent cannot tell "nothing found" from a weak match.
Errors and fixes
- MCP tool results too large: context window blown by one call
- MCP search returns results for nonsense queries
FAQ
Does the Windsurf Docs MCP server work?
In our hands-on test on Oct 16, 2026, 5 of 6 tasks passed. Main gotcha: One search returned about 137 KB. Very heavy on context.
What is the Windsurf Docs MCP server URL?
https://docs.windsurf.com/mcp (Streamable HTTP).
Does the Windsurf Docs MCP server need sign-in?
No sign-in. Paste the URL and it connects.
How do I add the Windsurf Docs MCP server to Claude, Cursor, VS Code or ChatGPT?
Follow our copy-paste setup guides: https://connectorreport.com/c/windsurf-docs/setup/claude https://connectorreport.com/c/windsurf-docs/setup/claude-code https://connectorreport.com/c/windsurf-docs/setup/cursor https://connectorreport.com/c/windsurf-docs/setup/vscode https://connectorreport.com/c/windsurf-docs/setup/chatgpt
What errors does the Windsurf Docs MCP server give?
MCP tool results too large: context window blown by one call. MCP search returns results for nonsense queries.
Compare
Best MCP servers for documentation and docs search
Compare with other tested connectors | Connector Weather
Request a hands-on test of Windsurf Docs
Get the badge
Maintain Windsurf Docs or write about it? Show its live ConnectorReport status in your README or docs.
Markdown (README, docs)
[](https://connectorreport.com/c/windsurf-docs?utm_source=badge&utm_medium=embed&utm_campaign=windsurf-docs)
HTML
<a href="https://connectorreport.com/c/windsurf-docs?utm_source=badge&utm_medium=embed&utm_campaign=windsurf-docs"><img src="https://connectorreport.com/badge/windsurf-docs.svg" alt="Windsurf Docs MCP status on ConnectorReport"/></a>
The badge updates on its own after every retest. How badges work