BreethDocs v0.1
MCP

Cursor

Wire Breeth into Cursor's MCP integration.

Cursor's MCP integration looks for mcpServers in your user-level config.

1. Mint a key

In the dashboard at thebreeth.com/app/api-keys, create a key with write (and optionally admin). Copy the ck_live_… value.

2. Open Cursor's MCP config

In Cursor: Settings → Features → MCP. Click "Add server" and choose the JSON option, or open the raw config file at:

OSPath
macOS~/.cursor/mcp.json
Windows%USERPROFILE%\.cursor\mcp.json

3. Add the Breeth server

{
  "mcpServers": {
    "breeth": {
      "transport": "http",
      "url": "https://mcp.thebreeth.com/mcp",
      "headers": {
        "Authorization": "Bearer ck_live_..."
      }
    }
  }
}

4. Restart Cursor

Quit fully and relaunch. Open the chat panel — Breeth's tools (add_episode, record_fact, search, retract) should show up.

5. Use it

In a chat: "Search my Breeth memory for what I decided about authentication last week." Cursor calls search and pipes the edges back.

To capture decisions as you make them: "Record this in Breeth: we picked Clerk over Supabase Auth for the third-party SSO matrix." Cursor calls add_episode.

Same scopes / multi-team behaviour as Claude Desktop

See Claude Desktop. Auth, scopes, multi-team headers, and error semantics are identical — the only difference is which client surfaces the tools.

On this page