Local MCP

Roll talks to Cursor and Claude Code over stdio on your machine. There is no hosted MCP endpoint and no personal access token in the cloud.

Install the server

npx -y @trace/mcp

Or register the Chrome native host so the extension can write into ~/.trace/jams:

npx @trace/mcp install --extension-id=<id from chrome://extensions>

Cursor

Click Add to Cursor. Cursor opens an install card for the local Roll MCP server. If the deeplink is blocked, paste this into .cursor/mcp.json and restart Cursor.

{
  "mcpServers": {
    "roll": {
      "command": "npx",
      "args": ["-y", "@trace/mcp"]
    }
  }
}

Claude Code

claude mcp add roll -- npx -y @trace/mcp

Codex

Append to ~/.codex/config.toml:

[mcp_servers.roll]
command = "npx"
args = ["-y", "@trace/mcp"]

What the agent can call

Tools include list_jams, get_latest_jam, get_timeline, get_console, get_network, get_keyframes, search_jams, resolve_jam, comment_jam, and create_jam. Prefer get_timeline over dumping the video into the prompt.

Ask: “Open the latest Roll and tell me why checkout failed.” Paste a /c/<id> URL if you already published one. The server still reads the local copy when it can.

Settings UI

The same configs live on the MCP settings page, with Add to Cursor and copy buttons for Claude Code.