How to add DeepWiki MCP to Windsurf

Cognition's official remote MCP: AI-grounded docs and Q&A for any public GitHub repo — free, no auth. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 0★ · http · no auth · official

Windsurf config for DeepWiki MCP

npx -y mcp-remote https://mcp.deepwiki.com/mcp

{
  "mcpServers": {
    "deepwiki-mcp": {
      "serverUrl": "https://mcp.deepwiki.com/mcp"
    }
  }
}

Remote server — no local install needed. Restart the client after saving the config.

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the DeepWiki MCP config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5DeepWiki MCP's tools become available to Cascade.

Before you start

An MCP client that supports remote servers (Cursor/Windsurf natively; Claude Desktop via the mcp-remote bridge)
Nothing else — no account, no API key

What DeepWiki MCP can do in Windsurf

read_wiki_structure

List the documentation topics DeepWiki generated for a GitHub repository.

read_wiki_contents

Read the generated documentation for a repository.

ask_question

Ask a free-form question about a repository and get an AI answer grounded in its docs and code.

Security

Hosted by Cognition; queries you send (repo names, questions) go to their service. It only covers public repositories, so there's no way to leak private code through it — but don't paste secrets into questions. No account or key means nothing to revoke or rotate.

DeepWiki MCP + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the DeepWiki MCP config there under the "mcpServers" key and restart the client.

Is DeepWiki MCP safe to use with Windsurf?

Is the DeepWiki MCP server free?

Yes — the official endpoint (https://mcp.deepwiki.com/mcp) is free and needs no account or API key. You just add the URL to your client. It only works with public GitHub repositories.

Why did my mcp-deepwiki npx setup stop working?

The community package scraped deepwiki.com, and DeepWiki blocked scraping — the package is defunct and its own README says so. Switch to the official hosted endpoint: https://mcp.deepwiki.com/mcp (use mcp-remote to bridge it into Claude Desktop).

Does DeepWiki MCP work with private repos?

No. It covers the public repositories DeepWiki has indexed. For private-repo context you'd run a local server (filesystem/git) or Devin's own tooling instead.

View repo Full DeepWiki MCP page