MCP Servers for Windsurf

Windsurf reads its servers from ~/.codeium/windsurf/mcp_config.json. Of the 31 603 we track, 9 861 answer right now without any credentials, 3 191 sign you in through the browser and 1 297 want an API key you paste into the config. The blocks below are ready to paste — each is built from the address we actually reached, in the format this client expects.

What 31 603 servers look like from Windsurf

Work as is answering now, no credentials asked 9 861 31.2%

Browser sign-in you authorise once, the client keeps the session 3 191 10.1%

Need a key you paste a key from the vendor into the config 1 297 4.1%

Run locally installed from a package, nothing to reach over the network 10 286 32.5%

Not responding listed as active, answer nothing 6 972 22.1%

Availability, last 24 hours share of the 21 317 remote servers answering, hour by hour

24 hours agonow

9 861

work with no key

answering now and open to anonymous clients

3 191

you authorise once, the client keeps the session

1 297

need an API key

you paste a key from the vendor into the config

10 286

run on your machine

installed from npm or PyPI, no uptime to measure

6 972

listed but dead

skip these — the registry still calls them active

How to add a server to Windsurf

one file for the whole editor — servers are available in every project

Open the config

Cascade has a button for it, or edit the file directly. It is plain JSON with one object per server.

~/.codeium/windsurf/mcp_config.json

Describe the server

A local one needs the command that launches it. A remote one needs only its address, under serverUrl.

Reload and check the tool list

Cascade reads the file on reload. If the server answers, its tools appear; if it asks for credentials, that means it runs and wants a key.

Servers to start with

all 31 603 in the catalogue →

Playwright MCP

by microsoft

Playwright Tools for MCP

5 247 752 installs/wk local only

Firebase MCP

by firebase

Gives AI development tools Firebase-specific capabilities and expertise.

2 171 835 installs/wk local only

Context7

by upstash

Up-to-date code docs for any prompt

536 148 installs/wk 2 tools answering

Browser Use

by browser-use

Control a real Chrome browser to complete any task: fill forms, extract data, book flights.

1 689 793 installs/wk local only

Storybook MCP Addon

by storybookjs

Help agents automatically write and test stories for your UI components.

1 463 451 installs/wk local only

Chrome DevTools MCP

by chromedevtools

MCP server for Chrome DevTools

1 000 705 installs/wk local only

Snyk

by snyk

Easily find and fix security issues in your applications leveraging Snyk platform capabilities.

501 714 installs/wk local only

Terradev

by theoddden

Cross-cloud GPU orchestration CLI.

4 391 installs/wk 245 tools answering

AWS MCP Server

by aws

AWS MCP Server lets AI securely access AWS using docs, API calls, and SOP workflows.

278 552 installs/wk local only

Hermoso

by hermoso-ai

Marketing on autopilot from your agent. 847 tools, usable alone. Publishing and ads cost no credits.

3 174 installs/wk 180 tools answering

Telnyx

by team-telnyx

Official TypeScript library for the Telnyx API

219 358 installs/wk local only

EdgarTools

by dgunning

Open-source SEC EDGAR toolkit — 11 tools, 7 prompts, every filing type. No API key required.

194 202 installs/wk local only

Browse all 31 603 servers the list is the same for every client — only the config differs

Things that trip people up with Windsurf

Written from how Windsurf reads its config, not from its release notes.

The file is one for the whole editor

There is no per-project config here. Everything added is available everywhere, which is convenient until two projects need different credentials for the same service.

Remote servers use a different key

A local server is described by a command, a remote one by serverUrl. Copying a local example and pasting an address into it is the usual reason nothing connects.

Tools did not appear after editing

The file is read on reload, not on save. And a server that never answers our handshake will not answer Cascade either — 1 735 endpoints in the registry are listed as active and stay silent.

Same servers, other clients

the servers are the same — the config format is not

Cline

Autonomous agent living inside VS Code. Handles local processes and remote endpoints over streamable HTTP or SSE, but authorisation is on you — through headers or environment variables.

~/.cline/mcp.json

Gemini CLI

Google's command-line agent. Takes all three transports and carries a full OAuth flow for remote servers, including service-account impersonation.

~/.gemini/settings.json

JetBrains AI Assistant

Built into the JetBrains IDEs. Configured through the settings dialog rather than a file, and it can import a config you already wrote for another client.

Settings | Tools | AI Assistant | Model Context Protocol

OpenCode

Open-source terminal agent. Local and remote servers sit in the same mcp object, told apart by a type field, and tokens are kept outside the config.

opencode.json in the project, or ~/.config/opencode/opencode.json

Claude Code

Adds servers by command, so nothing to edit by hand. Handles both local processes and remote endpoints, including OAuth logins.

run in your terminal

Cursor

Config sits in the project folder, so servers can differ per repository — useful when one project needs database access and another must not have it.

.cursor/mcp.json

VS Code

Works through GitHub Copilot's agent mode. Like Cursor, the config is per workspace rather than global.

.vscode/mcp.json

Codex

The only client here that uses TOML rather than JSON, so a config copied from elsewhere will not work as is.

~/.codex/config.toml

Claude Desktop

One global config for everything, so a server added here is available in every conversation.

~/Library/Application Support/Claude/claude_desktop_config.json