Log inSubmit server
Cursor Delegate logo

Cursor Delegate

Delegates coding work from MCP clients to Cursor's CLI agent through ACP, with planning, Q&A, cancellation, and diagnostics.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Cursor Delegate

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "cursor-delegate": {
      "command": "npx",
      "args": [
        "-y",
        "cursor-delegate-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

Cursor Delegate bridges MCP clients to Cursor's CLI agent over the Agent Client Protocol (ACP). Its delegate tool sends implementation briefs to cursor-agent and returns a structured result containing the response, changed files, session ID, and plan. Use it when one coding agent should scope and review work while Cursor handles multi-file implementation, or when you need plan and ask modes. The server communicates through standard stdio and requires Node.js 20+ plus a logged-in Cursor CLI.

Use cases

  • Delegate multi-file implementation work to Cursor's CLI agent
  • Request a plan before allowing implementation
  • Ask questions about a codebase through Cursor
  • Resume a delegation after answering a clarification
  • Diagnose Cursor CLI or MCP setup failures

Key features

  • ACP bridge to Cursor's CLI agent
  • Plan and ask delegation modes
  • Session resumption for clarifying questions
  • Best-effort cancellation by session ID
  • Structured results with changed files and plans
  • Built-in setup diagnostics

Tools3

What Cursor Delegate lets your agent do. Expand a tool for its parameters.

Verified live~861 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

20/23 checks healthy over the last 93d

What it can do

From the 3 tools this server returned when we ran it; 3 declare their own safety hints.

Runs commands · 1Can delete or modify data · 2Makes network requests · 1Read-only tools · 1
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age111 days
Maintainers1

Observed 2026-10-18 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · cursor-delegate-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars9Stargazers on the source repository.
npm downloads1.3kPackage downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Tools exposed3Callable tools this server registers over MCP.
Directory activity7 viewsConfig copies, upvotes, and views on AllMCPs.

How Cursor Delegate works

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.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Cursor Delegate

Cursor Delegate is an MCP server that connects MCP clients to Cursor's CLI agent over the Agent Client Protocol. Its main tools are `delegate` for coding tasks, plans, and codebase questions, `cancel` for best-effort session cancellation, and `doctor` for setup diagnostics. Results include changed files, plans, and session identifiers.

Install Node.js 20+, install and log in to the Cursor CLI with `cursor-agent login`, then configure a stdio MCP server using `npx -y cursor-delegate-mcp`. Claude Code, Codex, Copilot CLI, and several IDEs also have client-specific installation instructions.

Yes, Cursor Delegate connects MCP clients to Cursor's CLI agent, `cursor-agent`, over ACP. The CLI must be installed and authenticated, and the MCP server must be configured in the client that will call its tools.

Resume it by calling `delegate` with the `resumeSessionId` returned with the clarification question. Cursor ends the current turn and returns the question as prose, so the calling agent can provide an answer and continue the same session.

Run the `doctor` tool to inspect the plugin version, MCP client capabilities, and Cursor CLI launcher resolution. It is intended for failures during delegation and cases where the Cursor agent cannot be found.

Related MCP servers

All in Coding Agents All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCursor Delegate AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/cursor-delegate?style=directory)](https://allmcps.com/mcp/cursor-delegate)
HTML Embed
<a href="https://allmcps.com/mcp/cursor-delegate"><img src="https://allmcps.com/api/badge/cursor-delegate?style=directory" alt="Cursor Delegate on AllMCPs" /></a>