Skip to content

Agents

Excellent in Windsurf, as one entry in its own config

The installer writes one excellent entry into ~/.codeium/windsurf/mcp_config.json, in JSON, under mcpServers, and leaves the rest of the file alone. Restart Windsurf afterwards: it only sees the new server after a restart.

curl -fsSL https://excellent.so/install.sh | sh

It runs excellent install-agent-mcps, which writes the entry and prints Windsurf Cascade: linked.

The entry and the setup prompt

~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"excellent": {
"type": "stdio",
"command": "/absolute/path/to/node",
"args": [
"/absolute/path/to/@excellent-so/cli/dist/server.js"
],
"cwd": "/absolute/path/to/@excellent-so/cli/dist",
"env": {}
}
}
}
Setup prompt · paste it into Windsurf
Set up Excellent (excellent.so) in Windsurf for me. First run: curl -fsSL https://excellent.so/install.sh | sh
If its output has a line starting "Windsurf Cascade: linked" or "Windsurf Cascade: already-linked", skip to the last step.
Otherwise open ~/.codeium/windsurf/mcp_config.json (create it as {} if it is missing) and add this under the top-level "mcpServers" object, creating that object if needed and keeping everything else in the file unchanged:
"excellent": {"type":"stdio","command":"/absolute/path/to/node","args":["/absolute/path/to/@excellent-so/cli/dist/server.js"],"cwd":"/absolute/path/to/@excellent-so/cli/dist","env":{}}
Replace /absolute/path/to/node with the output of `node -p process.execPath`, and /absolute/path/to/@excellent-so/cli/dist with the output of `echo "$(npm root -g)/@excellent-so/cli/dist"`.
Last step: tell me to restart Windsurf, because it only sees the new server after a restart.

It runs the installer and looks for Windsurf Cascade: linked; if that line is missing it adds the entry by hand, then asks you to restart.

Agent
WindsurfWindsurf
Config file
~/.codeium/windsurf/mcp_config.jsonmacOS
Linux, Windows
Linux: the same path. Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.jsonNot supported yet
Format
JSON, under mcpServersmcpServers, with type: "stdio"
Detected by
the windsurf binary or Windsurf.app
The installer prints
Windsurf Cascade: linked
Restart
Restart Windsurf afterwards: it only sees the new server after a restart.
Undo
Delete the "excellent" entry under "mcpServers" in ~/.codeium/windsurf/mcp_config.json, then restart Windsurf.
Source
micro packages/core/src/agent-clis.ts:1281
Windsurf docs

The CLI on npm today, 0.1.0 (checked October 23, 2026), predates install-agent-mcps: the installer skips this step, says so, and changes no agent config. Paste the setup prompt, or add the entry by hand as the setup doc shows.

Put Excellent in your agent: install it, restart the agent, run one task

Names and marks belong to their owners. Shown to say Excellent works with these agents, with no endorsement implied.