Skip to content
RehearsalDocs

Cursor

Install the Rehearsal plugin in Cursor as a local plugin, or add only the MCP server. Sign in, check that it works, and remove it.

Time
5 minutes
Needs:
Cursor, git, uv, and an account on a Rehearsal server

Install

Cursor loads the plugin from a folder on your machine. Clone the repository, then link the plugin folder into Cursor's local plugins.

git clone --depth 1 https://github.com/MitudruDutta/rehearsal ~/.rehearsal-src
mkdir -p ~/.cursor/plugins/local
ln -s ~/.rehearsal-src/agent-plugin ~/.cursor/plugins/local/rehearsal

Restart Cursor. The plugin adds the Rehearsal skill and the Rehearsal MCP server. Cursor starts the MCP server itself, with uvx. Install uv if you do not have it.

To update the plugin later, run git pull in the clone and restart Cursor.

Or add only the MCP server

Put this entry in Cursor's MCP settings, ~/.cursor/mcp.json:

{
  "mcpServers": {
    "rehearsal": {
      "command": "uvx",
      "args": ["--from", "rehearsal-kit[mcp]>=0.1.1", "rehearsal", "mcp"]
    }
  }
}

With only the MCP server, the assistant has the tools and not the skill. The MCP server still tells it to ask before it spends money.

Sign in

Run this in a terminal, once:

uvx --from rehearsal-kit rehearsal login

Add --url <address> for a server other than the default. Your browser opens the console. Check that the code matches your terminal, then choose Approve. The sign-in is saved for your user only, and the MCP server reads it.

Check that it works

  1. Open Cursor's settings and look at the MCP servers. A server named rehearsal is listed, with its tools.

  2. In the agent chat, ask:

    Show my Rehearsal workspace status.

    The agent calls workspace_status and reports your plan and what exists in the workspace.

If the tool answers that Rehearsal is not signed in, run the sign-in command above and ask again.

What to ask

Evaluate my support agent on the published world for Gitea. Use the dev jobs and two repeats.
The instructions are in agent/instructions.txt.

The agent tells you the number of episodes and the cost, and waits for your yes, before it starts the run.

Why did the failed episodes fail? Group the causes.

More prompts are in AI assistants.

Remove

Delete the link and the clone, then restart Cursor.

rm ~/.cursor/plugins/local/rehearsal
rm -rf ~/.rehearsal-src

To end the access as well, revoke the key on the console's API keys page, and run uvx --from rehearsal-kit rehearsal logout.

Checked against rehearsal-kit 0.1.2 on 11 October 2026.

Was this page helpful?

Edit this page

On this page

Was this page helpful?

Edit this page