Installing Deliberation in Cursor
Cursor (external) connects to the Deliberation MCP server and reads a project rule that tells the agent when to delegate. Both pieces are below.
Install
The install steps for Cursor are on the install page, with every other host. This page has the rest: what the plugin ships, provider keys, updating and notes.
Other ways to install
Add the server by hand to ~/.cursor/mcp.json (global) or .cursor/mcp.json
(project):
{
"mcpServers": {
"deliberation": { "command": "npx", "args": ["-y", "@antonbabenko/deliberation-mcp"] }
}
}Provider credentials
The MCP server reads credentials from the host environment. Set only the providers you use:
| Provider | How it authenticates |
|---|---|
| GPT (Codex) | Codex CLI auth (codex login, e.g. ChatGPT - codex login --device-auth on a remote machine; or CODEX_ACCESS_TOKEN; else CODEX_API_KEY) |
| Gemini | GEMINI_API_KEY (Google AI Studio key). Opt-in fallback: the Antigravity CLI (agy) - see the terms note below |
| Grok (xAI) | XAI_API_KEY |
| OpenRouter | OPENROUTER_API_KEY (advisory-only; declare models in ~/.config/deliberation/config.json) |
Gemini note: with no key, Gemini falls back to the Antigravity CLI (agy). Read the
Antigravity terms (external) first. Section 6 lists "Using third
party software, tools, or services to access the Service (e.g. using OpenClaw with
Antigravity OAuth)" as a breach that "may be grounds for suspension or termination of your
Antigravity and/or Gemini CLI accounts". Deliberation drives agy as third-party software.
Missing keys just disable that one provider.
Distribution
- cursor.directory - the community rules/MCP registry. Submit the rule via the site's "Submit" flow / its GitHub repo.
- [unverified] Whether the official Cursor Marketplace (cursor.com/marketplace) accepts a self-serve third-party MCP+rules package - confirm with Cursor's publisher docs before treating a Marketplace listing as available.
Updating
Cursor starts the server with npx -y @antonbabenko/deliberation-mcp. The npm package does
not include this repository's scripts/ folder. After an update:
# stop the dashboard; prints "no running dashboard" if none runs
npx -y @antonbabenko/deliberation-mcp dashboard --stop
# drop the cached old build of this package (macOS, Linux)
find ~/.npm/_npx -type d -path '*/@antonbabenko/deliberation-mcp' -prune -exec rm -rf {} +On Windows, dashboard --stop is not supported: close the dashboard process first, then
delete the @antonbabenko\deliberation-mcp folders under %LocalAppData%\npm-cache\_npx.
Then restart the Deliberation server in Cursor's MCP settings, or reload the window. In a
clone of this repository, bash scripts/commands/reload-mcp.sh clears the cached package, restarts the dashboard
and audits the running Deliberation processes.
If you use the dashboard, start it again on the new version with
npx -y @antonbabenko/deliberation-mcp dashboard.
Notes / verified vs unverified
Verified against cursor.com/docs + cursor.directory: project rules live in
.cursor/rules/*.mdc (frontmatter description / globs / alwaysApply); MCP
servers register under mcpServers in ~/.cursor/mcp.json or .cursor/mcp.json;
one-click install deeplink format
cursor://anysphere.cursor-deeplink/mcp/install?name=&config=<base64>.