MCP server bridging AI coding hosts to cursor-agent over the Agent Client Protocol (ACP).
$git clone https://github.com/andreilungeanu/cursor-delegate-mcpInstalls into the current project.
Install cursor-delegate-mcp by running `git clone https://github.com/andreilungeanu/cursor-delegate-mcp`, then use it for the current task and follow its documentation at https://github.com/andreilungeanu/cursor-delegate-mcp.
| 1 | # Cursor Delegate MCP |
| 2 | |
| 3 | **Keep the brains. Delegate the build.** |
| 4 | |
| 5 | [](https://www.npmjs.com/package/cursor-delegate-mcp) |
| 6 | [](https://www.npmjs.com/package/cursor-delegate-mcp) |
| 7 | [](https://nodejs.org) |
| 8 | [](LICENSE) |
| 9 | [](https://github.com/andreilungeanu/cursor-delegate-mcp/actions/workflows/test.yml) |
| 10 | |
| 11 | <img src="assets/logo-light.png" alt="Cursor Delegate MCP logo" width="150" align="left" hspace="15"> |
| 12 | |
| 13 | Use your best coding agent where its judgment matters most: understanding the task, shaping the plan, and reviewing the result. |
| 14 | |
| 15 | 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. |
| 16 | |
| 17 | <br clear="left"> |
| 18 | |
| 19 |  |
| 20 | |
| 21 | ## 🧠 Frontier quality, kept |
| 22 | |
| 23 | Your assistant does what frontier models are actually for: understands the task, writes a precise brief, reviews the finished diff. And **Composer 2.5** holds its own — a seriously capable coding model, just guided and checked by a smarter one. The result reads like frontier work, because a frontier model planned it and signed off on it. |
| 24 | |
| 25 | ## ⚡ Done faster |
| 26 | |
| 27 | Composer 2.5 is built for speed. It tears through multi-file edits while a frontier model would still be streaming the first file. You delegate, keep working with your assistant, and the diff shows up done. |
| 28 | |
| 29 | ## 🔋 Your limits stop being the bottleneck |
| 30 | |
| 31 | Delegated work bills to Composer's **own usage pool** — separate from Cursor's API-priced main quota, and so generous most users never hit its ceiling. Your Claude or Codex subscription spends tokens only on the brief and the review, so the 5-hour window and weekly limits go a lot further. On API? That's the per-token grind moved off your bill. |
| 32 | |
| 33 | ``` |
| 34 | You → your agent (plans & reviews) |
| 35 | │ MCP delegate tool |
| 36 | ▼ |
| 37 | cursor-agent (Composer 2.5 — implements) |
| 38 | │ edits your workspace |
| 39 | ▼ |
| 40 | Clean result: what changed, which files, the plan |
| 41 | ``` |
| 42 | |
| 43 | ## Features |
| 44 | |
| 45 | - 🤝 **Native plugins** — install into Claude Code, ChatGPT/Codex, or GitHub Copilot CLI and just say *"delegate this to Cursor"*. The shared skill teaches your agent how to delegate well. |
| 46 | - 💬 **No stalled runs** — if Cursor asks a question mid-task, it pops up as a normal prompt in your client. In clients without that support, the recommended option is picked automatically and reported back, so nothing hangs. |
| 47 | - 📦 **Clean, typed results** — final answer, changed files, session id, and the plan, returned as validated structured output. Nothing to parse, nothing to guess. |
| 48 | - 📋 **Plan first** — `plan` mode: Cursor drafts a plan, you review it, then the same session implements it. |
| 49 | - 🔍 **Ask anything** — `ask` mode: read-only Q&A over your codebase, zero file changes. |
| 50 | - 🩺 **Self-diagnosing** — a `doctor` tool that tells you exactly what's missing if setup isn't right. |
| 51 | - 🔌 **Works everywhere MCP does** — VS Code, JetBrains, Windsurf, Visual Studio, and more. |
| 52 | |
| 53 | ## Quick start |
| 54 | |
| 55 | You need [Node.js 22+](https://nodejs.org/) and the [Cursor CLI](https://cursor.com/docs/cli/overview), logged in (`cursor-agent login`). |
| 56 | |
| 57 | ### Claude Code |
| 58 | |
| 59 | ```shell |
| 60 | /plugin marketplace add andreilungeanu/cursor-delegate-mcp |
| 61 | /plugin install cursor-delegate-mcp@cursor-delegate-mcp |
| 62 | ``` |
| 63 | |
| 64 | Then just ask: |
| 65 | |
| 66 | > Delegate to Cursor: migrate src/api from callbacks to async/await and update the tests, then walk me through what changed. |
| 67 | |
| 68 | That's the whole loop — Claude writes the brief, Cursor grinds through the files, Claude walks you through the diff. |
| 69 | |
| 70 | ### ChatGPT desktop / Codex |
| 71 | |
| 72 | ```shell |
| 73 | codex plugin marketplace add andreilungeanu/cursor-delegate-mcp |
| 74 | codex plugin add cursor-delegate-mcp@cursor-delegate-mcp |
| 75 | ``` |
| 76 | |
| 77 | ### GitHub Copilot CLI |
| 78 | |
| 79 | ```shell |
| 80 | copilot plugin install andreilungeanu/cursor-delegate-mcp |
| 81 | ``` |
| 82 | |
| 83 | ### More clients |
| 84 | |
| 85 | <details> |
| 86 | <summary><strong>VS Code</strong> — <code>.vscode/mcp.json</code></summary> |
| 87 | |
| 88 | ```json |
| 89 | { |
| 90 | "servers": { |
| 91 | "cursor-delegate-mcp": { |
| 92 | "type": "stdio", |
| 93 | "command": "npx", |
| 94 | "args": ["-y", "cursor-delegate-mcp"] |
| 95 | } |
| 96 | } |
| 97 | } |
| 98 | ``` |
| 99 | |
| 100 | Or run **Chat: Install Plugin From Source** with this repository's URL. |
| 101 | |
| 102 | </details> |
| 103 | |
| 104 | <details> |
| 105 | <summary><strong>JetBrains AI Assistant</strong> — Settings → Tools → AI Assistant → MCP</summary> |
| 106 | |
| 107 | Under **Settings → Tools → AI Assistant → Model Context Protocol (MCP)**, add a server with command `npx` and arguments `-y cursor-delegate-mcp`. |
| 108 | |
| 109 | </details> |
| 110 | |
| 111 | <details> |
| 112 | <summary><strong>Windsurf</strong> — <code>~/.codeium/windsurf/mcp_config.json</code></summary> |
| 113 | |
| 114 | ```json |
| 115 | { |
| 116 | "mcpServers": { |
| 117 | "cursor-delegate-mcp": { |
| 118 | "command": "npx", |
| 119 | "args": |