Skip to content
selvedge

Windsurf MCP setup

Selvedge works with any compatible agent. This page covers one optional client integration; see general MCP and CLI setup for other agents.

Windsurf’s Cascade agent loads MCP servers from a single JSON config. Add Selvedge there and Cascade gains the log_change / prior_attempts tools.

Before you start

Section titled “Before you start”

Install uv, then install the Selvedge CLI and MCP server:

Terminal window
uv tool install --upgrade selvedge

The MCP config below launches the server with uvx instead of a bare selvedge-server, so the package can be fetched on demand — the editor still needs to find uv installed. Prefer the global binary? Swap uvx --from selvedge selvedge-server for selvedge-server.

Add the MCP server

Section titled “Add the MCP server”

Add this to ~/.codeium/windsurf/mcp_config.json — or open it from the MCPs icon in the Cascade panel → Configure:

{
  "mcpServers": {
    "selvedge": {
      "command": "uvx",
      "args": ["--from", "selvedge", "selvedge-server"]
    }
  }
}

Prefer not to touch config files? selvedge setup detects Windsurf and writes this for you (with a .bak first).

Tell your agent when to call it

Section titled “Tell your agent when to call it”

Selvedge captures decisions when your agent calls it. Install the instruction block into your project’s .windsurfrules:

Terminal window
selvedge prompt --install .windsurfrules

It’s also a copy-paste block on the site: the Selvedge agent prompt block.

Verify

Section titled “Verify”

Back in the Cascade MCPs panel, refresh the server list — selvedge should connect and expose its 8 tools.

If it doesn’t connect

Section titled “If it doesn’t connect”

After editing mcp_config.json, fully quit and reopen Windsurf — closing the window alone doesn’t reload MCP servers. The config calls uvx, so make sure uv is installed (or pip install selvedge and use command: selvedge-server).

Next

Section titled “Next”