How to Install MCP Servers in Windsurf

How to configure MCP servers in Windsurf (Codeium) — the mcp_config.json location, the JSON shape, and how to load the servers into Cascade.

Browse Windsurf servers directory

Step-by-step installation guide

Open the MCP config
In Windsurf, open Cascade and go to the MCP / plugins settings, then choose to edit the raw config — or open ~/.codeium/windsurf/mcp_config.json directly.
Add the server under mcpServers
Add a named entry with "command", "args", and an optional "env" object for secrets, using the standard stdio shape.
Refresh and use it in Cascade
Save the file and refresh the MCP servers from the Windsurf MCP panel (or restart Windsurf). The tools then become available to Cascade.

Configuration

mcp_config.json

LocationAll platforms

~/.codeium/windsurf/mcp_config.json

Snippet

JSON

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"],
      "env": {}
    }
  }
}

Popular MCP servers to try in Windsurf

View all compatible servers

AllMCPs Server
The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.
83 20
Avo
Define, ship & query your analytics tracking from one source of truth, trusted by humans and agents.
65 0
Git
Tools to read, search, and manipulate Git repositories.
60 0
Influxdb3 MCP ServerInfluxData
Official MCP server for InfluxDB 3 Core/Enterprise/Cloud Dedicated
58 0
Line Bot MCP Serverline
MCP Server for Integrating LINE Official Account
55 0
Feranor Resilience
Scan/purge hidden text & score web domains: TLS, DNS, headers, speed. Free scans, $0.01 actions. The Tools:
- text_scan_v1 — free Scans a text string for invisible Unicode characters, homoglyphs, and normalization issues. Returns a risk score, a list of flagged characters, and detected homoglyphs. Never modifies the input text.
- text_purge_v1 — $0.01 per call Removes invisible Unicode characters and replaces homoglyphs in a text string, then normalizes the result. Returns the cleaned text plus a before-and-after risk comparison.
- domain_check_score_v1 — free Overall score, per-category scores, and how many findings each category raised. Use it to triage: rank a list of domains, confirm one is healthy, or decide whether the full report is worth pulling. It tells you which categories are weak and how many issues they hold, but not what the issues are.
- domain_check_score_batch_v1 — free The same triage scores for up to 100 domains in a single call. One score summary per distinct domain: overall score, per-category scores, and how many findings each category raised. Never the findings themselves.
- domain_check_v1 — $0.01 per call Full report for one domain: weighted score out of 100, per-category breakdown, and every individual finding with a prioritised remediation order.
- domain_check_batch_v1 — from $0.005 per domain The same full report for up to 100 domains in a single call, with one payment for the whole batch instead of one per domain. Both cheaper per domain and much faster than calling domain_check_v1 in a loop.
54 0
Hub MCPdocker
Official MCP server to interact with Docker Hub, providing access to repositories, hub search and Docker Hardened Images
54 0
Vocuno
Official Vocuno plugin for Claude that connects to Vocuno's remote MCP server for AI song generation, covers, remixes, stem separation, voice conversion, audio editing, mixing, mastering, and music analysis.
52 0
S2 Sdk Typescripts2-streamstore
Official MCP server for the S2.dev serverless stream platform.
51 0
Moxie Docs MCP
MCP & Agent Skills for Automated Documentation, and codebase conventions + context
47 25
Infobip MCPInfobip
Official Infobip MCP server for integrating Infobip global cloud communication platform. It equips AI agents with communication superpowers, allowing them to send and receive SMS and RCS messages, interact with WhatsApp and Viber, automate communication workflows, and manage customer data, all in a production-ready environment.
46 0
BlockVectra: multi Chain RPC & Data API
Keyless docs/discovery. RPC follows chain policy; indexed data and account tools need an API key.
32 0

Frequently Asked Questions

Windsurf reads ~/.codeium/windsurf/mcp_config.json. You can edit it from the MCP settings inside Cascade or open the file directly. It uses the same "mcpServers" shape as other MCP clients.

After editing mcp_config.json, use the refresh action in the Windsurf MCP panel, or restart Windsurf. New or changed servers are not picked up until you refresh or relaunch.

Yes. MCP is a shared protocol, so any stdio MCP server works across Windsurf, Cursor, Claude Desktop, and Claude Code — only the config file location and, for VS Code, the JSON key differ.

Step-by-step installation guide

Open the MCP config

Add the server under mcpServers

Refresh and use it in Cascade

Configuration

Popular MCP servers to try in Windsurf

Frequently Asked Questions

Where is the Windsurf MCP config file?

How do I reload MCP servers in Windsurf?

Does Windsurf support the same MCP servers as Cursor and Claude?

Install MCP servers in other clients