# Cursor Delegate [Health: Active]

**Category:** 🤖 Coding Agents  
**Repository:** https://github.com/andreilungeanu/cursor-delegate-mcp  
**GitHub Stars:** 9  
**npm Downloads (last month):** 1314  
**Views:** 7  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/cursor-delegate

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

## Tools
Capabilities this server exposes over MCP:

- **delegate** — 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.
- **cancel** — 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).
- **doctor** — Setup diagnostics: plugin version, MCP client capabilities, cursor-agent launcher resolution. Run when delegation fails or agent.found is false.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What Cursor Delegate does

Cursor Delegate lets an MCP-connected coding assistant hand implementation work to Cursor's CLI agent. The calling assistant can formulate the brief, receive the completed result, and review the resulting changes instead of issuing individual file-edit commands itself.

Delegated work runs through ACP. Cursor's agent operates in the requested workspace and can implement multi-file changes, produce a plan, or answer questions about the codebase. Results are returned as a compact structured payload with the final response, changed files, session ID, and plan.

## How it works

The `delegate` tool starts a Cursor agent turn and returns its result through MCP. A delegation can use implementation, `plan`, or `ask` instructions. In plan mode, the agent drafts a plan in the session before implementation; ask mode is intended for codebase questions.

If Cursor needs clarification, the turn ends and the question is returned as prose. The caller can answer by invoking `delegate` again with the returned `resumeSessionId`, allowing the same session to continue without waiting on an interactive modal.

Cancellation uses the `cancel` tool and a session ID. Cancellation is best effort: the underlying agent may finish its current turn, in which case the result indicates that cancellation was requested. The reported status can distinguish a cancelled session, an observed process exit, a session that already ended but remains resumable, and an unknown session in the process history.

## Setup and configuration

Install Node.js 20 or later and the Cursor CLI. The CLI must be installed and authenticated with `cursor-agent login`.

For a generic MCP client, configure a stdio server using `npx -y cursor-delegate-mcp`. Client-specific installation paths are available for Claude Code, ChatGPT/Codex, GitHub Copilot CLI, VS Code, JetBrains AI Assistant, Windsurf, Visual Studio, OpenCode, Google Antigravity, Kiro, Kilo Code, and Zed. The exact configuration key differs by client; local stdio configurations commonly provide `npx` as the command and `-y cursor-delegate-mcp` as its arguments.

Run `doctor` when delegation fails or when the agent is reported as unavailable. It checks the plugin version, MCP client capabilities, and resolution of the Cursor CLI launcher.

## Tools and capabilities

- `delegate`: Sends a coding brief to cursor-agent over ACP. It supports implementation work, plan-oriented requests, codebase Q&A, and session resumption.
- `cancel`: Requests cancellation of an in-flight delegation by session ID and reports the observed status.
- `doctor`: Provides setup diagnostics for the plugin, MCP client, and Cursor agent launcher.
- Structured delegation results include the final answer, changed files, session ID, and plan.
- The bridge uses Composer 2.5 as the default model and keeps the model, speed, and effort defaults unless the user requests otherwise.

## Limitations and notes

The bridge automatically approves every permission requested by the delegated agent, regardless of mode or disk location. Treat the selected workspace and Cursor agent actions accordingly.

Cancellation is advisory rather than guaranteed. An agent can complete its turn after a cancellation request. Clarification is handled as a returned result followed by session resumption, not as a blocking prompt.

Use the `delegate` tool for Cursor work rather than shelling out to `cursor-agent` directly. The server is a stdio MCP server, and its operation depends on a working, authenticated Cursor CLI installation.

_Full upstream README: https://allmcps.com/mcp/cursor-delegate/readme_