topmcps
Browse MCPs
Windsurf

MCP Servers for Windsurf

Windsurf (Codeium) wires MCP servers into its Cascade agent. Point it at mcp_config.json and every server becomes a tool that Cascade can call autonomously during multi-step work.

15 compatible MCPsVerified setup for 2026

Set up MCP in Windsurf

Four steps to connect your first MCP server.

  1. 1

    Open the Cascade MCP panel

    Cascade → hammer icon → "Configure". This opens (or creates) ~/.codeium/windsurf/mcp_config.json.

  2. 2

    Add servers under mcpServers

    Same JSON shape as Claude Desktop. Paste install snippets from top-mcps.com detail pages directly.

  3. 3

    Secure tokens via env

    Set tokens in the env block. Windsurf will pass them to the server process but not echo them in the chat transcript.

  4. 4

    Refresh Cascade

    Click "Refresh" in the MCP panel (no full restart needed). Connected servers show a green dot.

Config file locations
  • Global~/.codeium/windsurf/mcp_config.jsonApplies to every Windsurf workspace.
Example configjson
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/you/code"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@github/github-mcp-server"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..."
      }
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Top MCPs for Windsurf

The curated starting stack — install these first.

1
Popular

Read and write local files with configurable access controls.

filesystemfilesreadwrite
2 minLow
2
Popular

Full GitHub API access: repos, PRs, issues, and code search.

gitgithubreposprs
5 minLow
3
Trending

Up-to-date library docs pulled directly into your AI context.

codingdocumentationlibrariesaccuracy
3 minLow
4
Trending

Full Supabase access: database, auth, storage, and edge functions.

supabasedatabasebackendpostgres
5 minLow
5
Powerful

Full browser automation: navigate, click, screenshot, and scrape.

browserautomationscrapingpuppeteer
5 minMedium
6
Popular

Query and inspect PostgreSQL databases via natural language.

databasesqlpostgresqueries
3 minLow

All MCPs compatible with Windsurf

15 servers verified to work with Windsurf, ranked by popularity.

1
Popular

Read and write local files with configurable access controls.

filesystemfilesreadwrite
2 minLow
2
Popular

Full GitHub API access: repos, PRs, issues, and code search.

gitgithubreposprs
5 minLow
3
Popular

Query and inspect PostgreSQL databases via natural language.

databasesqlpostgresqueries
3 minLow
5
Agent-Friendly

Persistent knowledge graph memory across AI conversations.

memorypersistenceknowledge-graphagents
2 minLow
6
Fast Setup

Local Git operations: commit, diff, log, branch, and more.

gitlocalcommitsdiff
2 minLow
7
Trending

Up-to-date library docs pulled directly into your AI context.

codingdocumentationlibrariesaccuracy
3 minLow
8
Trending

Full Supabase access: database, auth, storage, and edge functions.

supabasedatabasebackendpostgres
5 minLow
9
Fast Setup

Local SQLite database access with full read/write support.

databasesqlitelocalstorage
2 minLow
10
Fast Setup

Retrieve web pages and convert them to clean markdown.

webfetchmarkdownscraping
1 minLow
11
Powerful

Full browser automation: navigate, click, screenshot, and scrape.

browserautomationscrapingpuppeteer
5 minMedium
12
Agent-Friendly

Structured step-by-step reasoning for complex problem solving.

reasoningthinkingagentsplanning
2 minLow
13
Popular

Read and send Slack messages, manage channels and threads.

slackmessagingcommunicationautomation
10 minMedium
14
Trending

Secure cloud sandboxes for executing AI-generated code.

codingexecutionsandboxcloud
5 minLow
15
Trending

Manage Linear issues, projects, and cycles from AI context.

linearproject-managementissuesproductivity
5 minMedium

FAQ: MCP in Windsurf

Where is Windsurf's MCP config stored?

At ~/.codeium/windsurf/mcp_config.json. The Cascade "Configure" button opens it directly, or you can edit it with any text editor.

Do I need to restart Windsurf after editing mcp_config.json?

No. Click the Refresh button in the Cascade MCP panel and Windsurf re-reads the config. A full restart is only needed if a server is wedged.

Will my existing Claude Desktop MCP config work in Windsurf?

Yes. The mcpServers JSON shape is the same, so copy the mcpServers block from claude_desktop_config.json into mcp_config.json and it will work unchanged.

Which MCPs work best with Cascade?

Cascade thrives on multi-step agent work, so pair it with tool-rich MCPs: Filesystem, GitHub, Puppeteer for browser work, and a database MCP (Postgres or Supabase) if you are building an app.

Browse every MCP server → top-mcps.com