How do I reload MCP servers in Windsurf?

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.

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

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.

How do I reload MCP servers in Windsurf?

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.

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

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.

AI EditorBrowse Windsurf Servers Directory

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.

Configuring Windsurf

Config file: mcp_config.json

All platforms path~/.codeium/windsurf/mcp_config.json

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

Step-by-step Installation Guide

1
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.
2
Add the server under mcpServers
Add a named entry with "command", "args", and an optional "env" object for secrets, using the standard stdio shape.
3
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.

Popular MCP servers to try in Windsurf

View All Compatible Servers →

@agentfund MCP@agentfund
Fundraising infrastructure for AI agents on Solana — campaigns, x402 donations, and on-chain reputation. MCP tools for registering agents, creating campaigns, and donating via the x402 pay-to-call flow, backed by Anchor programs (agentregistry, escrow, reputation). npx -y @agentfund/mcp
0 0
MCP Server@arbitova
Non-custodial on-chain escrow + AI dispute arbitration for agent-to-agent USDC payments on Base. Seven tools covering the full EscrowV1 contract surface: create escrow, mark delivered with on-chain content hash, confirm or dispute, arbiter resolves with signed verdict, cancel/escalate on timeout. npx @arbitova/mcp-server
0 0
MCP Server@asterpay
EUR settlement for AI agents via x402 protocol. Market data, AI tools, crypto analytics — pay-per-call in USDC on Base. SEPA Instant EUR off-ramp.
0 0
Cnb@czagents
Czech National Bank (ČNB) daily FX rates: fetch official CZK exchange rates, convert between currencies, fetch historical rates. Cached 10 min to ease upstream load. npm @czagents/cnb or HTTP at cnb.cz-agents.dev/mcp.
0 0
MCP Server@frihet
AI-native business management — invoices, expenses, clients, products, and quotes. 31 tools for Claude, Cursor, Windsurf, and Cline.
0 0
Hledger MCP@iiatlas
Double entry plain text accounting, right in your LLM! This MCP enables comprehensive read, and (optional) write access to your local HLedger accounting journals.
0 0
MCP Server@openpulsechain
PulseChain on-chain analytics: token safety scores (0-100), honeypot detection, whale tracking, smart money feed, scam alerts, DEX volume, bridge stats, holder leagues. 11 free + 9 pro tools. npx @openpulsechain/mcp-server
0 0
Slideshot06ketan
Convert HTML to PDF/PNG/WebP/PPTX slide carousels with 11 themes (LinkedIn, Instagram, pitch decks, infographics). Pixel-perfect Puppeteer rendering, dimension-aware reflow for portrait/landscape, token-efficient JSON mode. npx slideshot-mcp.
0 0
Substack Ops06ketan
Substack with zero AI API keys. 26 tools (posts, notes, comments, replies, reactions, restacks). Host LLM drafts via proposereply → confirmreply tokens. SQLite dedup, JSONL audit, dry-run default. Install: uvx substack-ops mcp install cursor.
0 0
Byte MCP Server0rkz
PayPerByte — per-byte data marketplace for AI agents on Arbitrum. Discover publishers, evaluate on-chain Proof-of-Quality Score (PQS), subscribe + pay per request in USDC via x402 gateway. 15 tools, zero API keys.
0 0
Novai MCP Server0x-devc
Read-only access to the live NOVAI blockchain (AI-native L1). Query blocks, transactions, AI entities, on-chain signals, oracle anchors, and memory objects over public JSON-RPC. No keys, no write paths.
0 0
Matter Controller MCP0x1abin
An MCP server for Matter Controller, enabling AI agents to control and interact with Matter devices.
0 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.

Install MCP servers in other clients

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.

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.