Cursor Delegate

io.github.andreilungeanuPublished by GitHub account andreilungeanuv2.8.0Updated Nov 8, 2026

Bridge AI coding hosts to cursor-agent over the Agent Client Protocol.

VerifiedSTDIODesktop onlyDeveloper ToolsAI & ML

Overview

AI-generated overview

Bridges an MCP client to Cursor's CLI agent so the assistant can hand off coding tasks, cancel runs, and check setup.

What you can do
  • Delegate a coding task to cursor-agent over ACP and get back a structured result with the answer, changed files, session id and plan
  • Resume a delegation by session id to answer the agent's clarifying questions
  • Request a best-effort cancel of an in-flight delegation and see whether it was cancelled, killed or already finished
  • Run setup diagnostics covering plugin version, client capabilities and cursor-agent launcher resolution
When to use it
Use it when you want your main assistant to write the brief and review the diff while Cursor's CLI agent performs multi-file implementation work, or when you want plan-first and codebase Q&A modes handled by that agent.
Requirements
Runs locally over stdio, typically via npx. Needs Node.js 20+ and the Cursor CLI installed and logged in (cursor-agent login). No environment variables or headers are declared.
Before you install
Every permission the agent requests is auto-approved in every mode, so it can reach any file the user account can; scope the workspace tightly and review the git diff after each run, since the reported file list is not authoritative. Cancellation is advisory and the agent may finish the turn anyway.

Installation

In SourceWeft

  1. Open Cursor Delegate in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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.

[npm version] [npm downloads] [MCP Registry] [cursor-delegate-mcp MCP server] [node] [license: MIT] [tests]

[Cursor Delegate logo]

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.


[Demo]

🧠 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.

⚡ 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.

[You and your agent plan and review; the MCP delegate tool hands the brief to cursor-agent (Composer 2.5), which implements and edits your workspace; a clean result comes back with what changed, which files, and the plan, for your agent to review]

[Delegate result payload]

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 — plan mode: Cursor drafts a plan, you review it, then the same session implements it.
  • 🔍 Ask anything — ask mode: Q&A over your codebase.
  • 🩺 Self-diagnosing — a doctor tool 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

shell
/plugin marketplace add andreilungeanu/cursor-delegate-mcp/plugin install cursor-delegate@cursor-delegate-mcp

Then 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

shell
codex plugin marketplace add andreilungeanu/cursor-delegate-mcpcodex plugin add cursor-delegate@cursor-delegate-mcp

Google Antigravity

shell
agy plugin install https://github.com/andreilungeanu/cursor-delegate-mcp

Restart 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

shell
copilot plugin marketplace add andreilungeanu/cursor-delegate-mcpcopilot plugin install cursor-delegate@cursor-delegate-mcp

Any other MCP client

json
{  "mcpServers": {    "cursor-delegate": {      "command": "npx",      "args": ["-y", "cursor-delegate-mcp"]    }  }}

Client-specific config locations

VS Code — one-click install, or .vscode/mcp.json

[Install in VS Code] [Install in VS Code Insiders]

Or add it manually:

json
{  "servers": {    "cursor-delegate": {      "type": "stdio",      "command": "npx",      "args": ["-y", "cursor-delegate-mcp"]    }  }}

Or run Chat: Install Plugin From Source with this repository's URL.

JetBrains AI Assistant — Settings → Tools → AI Assistant → MCP

Under Settings → Tools → AI Assistant → Model Context Protocol (MCP), add a server with command npx and arguments -y cursor-delegate-mcp.

Windsurf — ~/.codeium/windsurf/mcp_config.json

Same mcpServers block as the generic snippet above. Cascade caps you at 100 tools across all servers.

Visual Studio 2022 / 2026 — %USERPROFILE%\.mcp.json

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 — ~/.config/opencode/opencode.json or project opencode.json

OpenCode does not use mcpServers. Local servers go under mcp, with type: "local" and command as one array:

json
{  "$schema": "https://opencode.ai/config.json",  "mcp": {    "cursor-delegate": {      "type": "local",      "command": ["npx", "-y", "cursor-delegate-mcp"],      "enabled": true    }  }}
Google Antigravity (without the plugin) — ~/.gemini/config/mcp_config.json or workspace .agents/mcp_config.json
json
{  "mcpServers": {    "cursor-delegate": {      "command": "npx",      "args": ["-y", "cursor-delegate-mcp"],      "timeoutSeconds": 21660    }  }}
Kiro — .kiro/settings/mcp.json or ~/.kiro/settings/mcp.json

Same mcpServers block as the generic snippet above. Workspace file wins when both exist.

Kilo Code — kilo.jsonc (mcp key, not mcpServers)

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

Source: README.md at commit 9ab9ccb

Tools

3

delegate

Delegate coding task to Cursor

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.

ParametersfastmodespecrequiredmodeleffortcontextworkspacerequiredcontextFilesresumeSessionId

cancel

Cancel Cursor delegation

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).

ParametersforcesessionIdrequired

doctor

Diagnose Cursor delegation setup

Setup diagnostics: plugin version, MCP client capabilities, cursor-agent launcher resolution. Run when delegation fails or agent.found is false.

Parametersdeep

Version history

6
  1. v2.8.0LatestNov 8, 2026
  2. v2.7.0Nov 7, 2026
  3. v2.6.0Oct 22, 2026
  4. v2.5.2Oct 15, 2026
  5. v2.4.0Oct 5, 2026
  6. v2.3.0Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts