Skip to content
selvedge

Add Selvedge to Cursor

Cursor speaks MCP natively, so wiring in Selvedge takes one config file. Once it’s connected, the agent can call log_change as it works and prior_attempts before it edits.

Before you start

Section titled “Before you start”

pip install selvedge gives you the selvedge CLI (selvedge setup, selvedge blame, and the selvedge prompt helper below):

Terminal window
pip install selvedge

The MCP config below launches the server with uvx instead of a bare selvedge-server, so it starts reliably even when your editor doesn’t share your shell’s PATH — it just needs 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 ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project only):

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

Prefer not to touch config files? selvedge setup detects Cursor 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 only captures the why if your agent knows to call it. Install the one-block instruction set into your project’s CLAUDE.md / .cursorrules:

Terminal window
selvedge prompt --install CLAUDE.md

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

Verify

Section titled “Verify”

Open Cursor Settings → MCP. selvedge should be listed with its 8 tools. Or run selvedge watch in a terminal and make a change — the event prints within a second.

If it doesn’t connect

Section titled “If it doesn’t connect”

These configs run the server with uvx, which ships with uv — so the one prerequisite is uv on the PATH Cursor launches with (curl -LsSf https://astral.sh/uv/install.sh | sh). Prefer a global install instead? pip install selvedge and set command to selvedge-server.

Next

Section titled “Next”