Cursor Delegate
Cursor Delegate bridges MCP clients to Cursor’s CLI agent so you can delegate coding implementation while your primary agent writes the brief and reviews the diff.
delegate: send a task brief and workspace tocursor-agent;agentimplements,plandrafts a plan, andaskanswers codebase questions. Supports model, fast mode, effort, context size, attached context files, and resuming sessions. Auto-approves permissions and returns structured results with answer, changed files, session ID, plan, and warnings.Resume a delegation with
resumeSessionId, including answering Cursor’s clarifying questions returned as prose.cancel: best-effort cancellation of an in-flight delegation by session ID, with optional forced process kill.doctor: diagnose setup, plugin version, MCP client capabilities, andcursor-agentlauncher resolution;deepverifies an ACP handshake and lists models/modes/options.Use as a portable stdio MCP server across Claude Code, Codex/ChatGPT, Copilot, VS Code, JetBrains, Windsurf, OpenCode, Antigravity, and other MCP clients.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Cursor Delegate Delegate to Cursor: refactor the auth module and update its tests."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Cursor Delegate
Stop burning your frontier agent's limits on boilerplate.
Delegate edits to Cursor's CLI agent — your agent writes the brief and reviews the diff.
Use your best coding agent where its judgment matters most: understanding the task, shaping the plan, and reviewing the result.
Cursor Delegate is the MCP bridge that lets Claude Code, ChatGPT/Codex, Copilot — or any MCP client — hand implementation to Cursor's CLI agent, then get a clean, structured result back for review.

🧠 Frontier quality, kept
Your assistant does what frontier models are for: understands the task, writes a precise brief, reviews the finished diff. Composer 2.5 runs the implementation loop under that brief. The bundled skill puts the review step in the loop — the agent that scoped the work reads the changed files back before reporting.
Related MCP server: cursor-mcp-server
⚡ Done faster
Composer 2.5 is built for throughput on multi-file edits. The whole delegation is one call — brief in, result out — so you review a finished diff instead of babysitting edits landing file by file.
🔋 Your limits stop being the bottleneck
Composer and Grok draw from the Cursor Models usage pool, separate from third-party model usage on supported Cursor plans. Your Claude or Codex subscription handles the brief and review while Cursor runs the implementation. If you pay per token on API, implementation moves onto the Cursor capacity you already have.


Features
🤝 Native plugins — install into Claude Code, ChatGPT/Codex, Google Antigravity, or GitHub Copilot CLI and just say "delegate this to Cursor". The shared skill teaches your agent how to delegate well.
💬 No stalled runs — if Cursor needs to clarify, it ends the turn and returns the question as a normal result. Your agent reads it and answers by resuming the same session — nothing blocks on a modal waiting for input.
📦 Clean, named results — final answer, changed files, session id, and the plan, returned as one compact JSON payload. Nothing to scrape.
📋 Plan first —
planmode: Cursor drafts a plan, you review it, then the same session implements it.🔍 Ask anything —
askmode: Q&A over your codebase.🩺 Self-diagnosing — a
doctortool that tells you exactly what's missing if setup isn't right.🔌 Portable — plain stdio MCP, so it runs anywhere: VS Code, JetBrains, Windsurf, Visual Studio, OpenCode, Antigravity, and more.
plan and ask are instructions to the agent, and workspace is its working directory — Security and the delegate reference spell out what the bridge enforces and what it reports back.
Install
You need Node.js 20+ and the Cursor CLI, logged in (cursor-agent login).
Claude Code
/plugin marketplace add andreilungeanu/cursor-delegate-mcp
/plugin install cursor-delegate@cursor-delegate-mcpThen just ask:
Delegate to Cursor: migrate src/api from callbacks to async/await and update the tests, then walk me through what changed.
That's the whole loop — Claude writes the brief, Cursor grinds through the files, Claude walks you through the diff.
ChatGPT desktop / Codex
codex plugin marketplace add andreilungeanu/cursor-delegate-mcp
codex plugin add cursor-delegate@cursor-delegate-mcpGoogle Antigravity
agy plugin install https://github.com/andreilungeanu/cursor-delegate-mcpRestart the Antigravity app to load it. If you added cursor-delegate to mcp_config.json by hand, remove that entry.
Without the CLI, use the manual config under Client-specific config locations.
GitHub Copilot CLI
copilot plugin marketplace add andreilungeanu/cursor-delegate-mcp
copilot plugin install cursor-delegate@cursor-delegate-mcpAny other MCP client
{
"mcpServers": {
"cursor-delegate": {
"command": "npx",
"args": ["-y", "cursor-delegate-mcp"]
}
}
}Client-specific config locations
Or add it manually:
{
"servers": {
"cursor-delegate": {
"type": "stdio",
"command": "npx",
"args": ["-y", "cursor-delegate-mcp"]
}
}
}Or run Chat: Install Plugin From Source with this repository's URL.
Under Settings → Tools → AI Assistant → Model Context Protocol (MCP), add a server with command npx and arguments -y cursor-delegate-mcp.
Same mcpServers block as the generic snippet above. Cascade caps you at 100 tools across all servers.
Same servers + type: "stdio" shape as VS Code. Requires Visual Studio 2026, or 2022 17.14+. Note the top-level key is servers, not mcpServers. Visual Studio also discovers .mcp.json next to the solution, plus .vscode/mcp.json.
OpenCode does not use mcpServers. Local servers go under mcp, with type: "local" and command as one array:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"cursor-delegate": {
"type": "local",
"command": ["npx", "-y", "cursor-delegate-mcp"],
"enabled": true
}
}
}{
"mcpServers": {
"cursor-delegate": {
"command": "npx",
"args": ["-y", "cursor-delegate-mcp"],
"timeoutSeconds": 21660
}
}
}Same mcpServers block as the generic snippet above. Workspace file wins when both exist.
Same shape as OpenCode: type: "local" and command as one array. In the VS Code extension: Settings → MCP → Add Server → Local (stdio). On Windows, if npx is not found, use command cmd with arguments /c, npx, -y, cursor-delegate-mcp.
License
MIT © Andrei Lungeanu
Technical reference · Security · Privacy · Terms · Changelog
Available Tools
3 toolscancelADestructiveIdempotent
Best-effort cancel of an in-flight delegation by sessionId. session/cancel is advisory — the agent may finish the turn anyway, and the delegate result then carries cancelRequested. Status: cancelled, killed (agent process observed to exit), not-running (turn already ended, still resumable), not-found (id not in this process's recent session history).
Inputs: sessionId (required), force.
delegateADestructive
Delegate a coding task to cursor-agent over ACP. Never shell out to cursor-agent — use this tool only. Auto-approves every permission the agent requests, in any mode and anywhere on disk. Clarifying questions arrive as prose in result — resume with resumeSessionId to answer. Keep model (composer-2.5), fast and effort at their defaults unless the user explicitly asks. See the delegate skill.
Inputs: spec (required), workspace (required), fast, mode, +5 more.
doctorARead-onlyIdempotent
Setup diagnostics: plugin version, MCP client capabilities, cursor-agent launcher resolution. Run when delegation fails or agent.found is false.
Inputs: deep.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
delegate, cancel, and doctor each target a clearly distinct purpose: starting/resuming work, aborting it, and diagnosing setup. There is no overlap between initiating a delegation, cancelling one, and running diagnostics, so an agent can select unambiguously.
All three tools use a single lowercase verb-style command (delegate, cancel, doctor) with no camelCase or underscore mixing. The pattern is predictable and readable throughout.
Three tools is on the slim side but well-matched to a focused delegation wrapper: one action tool, one control tool, one diagnostic. Nothing feels redundant or missing for the core scope, though it sits at the low end of the 3-15 range.
The lifecycle is largely covered: delegate handles start and resume (via resumeSessionId), cancel handles termination with rich status codes, and doctor handles setup failures. The main gap is the lack of a session-listing or status-introspection tool, which agents must work around via the delegate result fields.
Maintenance
Related MCP Connectors
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
A paid remote MCP for OpenAI Codex agent coordination MCP, built to return verdicts, receipts, usage
Real-time chat for AI agents. Claude Code, Cursor, Cline and Codex join channels over MCP.
Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables programmatic control of Cursor's cloud-based AI agents for automated code generation and repository management via standardized MCP tools.6MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server wrapping the Cursor CLI agent, enabling Claude Code and other MCP clients to delegate tasks to Cursor's AI agent for file writing, bash commands, and codebase queries.-
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients like Claude Code to delegate coding tasks to the local Cursor Agent CLI, with persistent per-workspace sessions that resume across calls.12 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude Code to delegate tasks to Cursor's headless agent, run adversarial reviews, and verify findings with prosecutor/advocate roles.MIT