Skip to content
MCP server

Cursor Delegate

Hand coding work from Claude Code or Codex to Cursor's CLI agent and review the diff

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, vscode, jetbrains
Runs
Locally
Version
2.8.0
Listing updated
2 days ago

About Cursor Delegate

Cursor Delegate is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

The idea is to split the labour: your main assistant understands the task, writes a precise brief and reviews the result, while Cursor's CLI agent runs the implementation loop. The README says Composer and Grok draw on a Cursor usage pool separate from third-party models on supported plans, so heavy edits do not eat into your Claude or Codex limits.

One call carries a brief in and a compact JSON result out, containing the final answer, changed files, session id and plan. If Cursor needs clarification it ends the turn and returns the question, so nothing hangs on a dialog; the calling agent answers by resuming the same session. Plan mode has Cursor draft a plan first, and ask mode answers questions about the codebase. A doctor tool reports what is missing from setup.

It needs Node.js 20+ and the Cursor CLI logged in with cursor-agent login. Plugins exist for Claude Code, ChatGPT desktop and Codex, Google Antigravity and GitHub Copilot CLI, and it runs over plain stdio in VS Code, JetBrains, Windsurf, Visual Studio, OpenCode, Kiro and Kilo Code. It is MIT licensed.

Install

Run in a terminal

claude mcp add cursor-delegate-mcp -- npx -y cursor-delegate-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "cursor-delegate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cursor-delegate-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cursor-delegate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cursor-delegate-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

doctor
Reports what is missing if setup is not right.

What it does

One-call delegation
Sends a brief and returns a finished, structured result.
Plan mode
Cursor drafts a plan that you review before the same session implements it.
Ask mode
Answers questions about your codebase.
Resumable sessions
Clarifying questions come back as results; the session id lets the caller resume.
Doctor tool
Reports exactly what is missing if setup is wrong.
Native plugins
Installs into Claude Code, Codex, Antigravity and Copilot CLI with a bundled skill.

Good for

  • Delegate a callback-to-async migration to Cursor and review the diff
  • Save a frontier model's usage for planning and review
  • Get a plan from Cursor before it edits anything
  • Query a codebase through Cursor without leaving your main agent

Pricing

Open source

MIT licensed; needs a Cursor account for the CLI agent

Cursor Delegate FAQ

What do I need installed?

Node.js 20 or later and the Cursor CLI, logged in with cursor-agent login.

Which clients does it work with?

Claude Code, ChatGPT desktop/Codex, Antigravity and Copilot CLI via plugins, and any MCP client over stdio.

What happens if Cursor needs clarification?

It ends the turn and returns the question as a normal result, which the caller answers by resuming the session.

What licence is it?

MIT.

Is Cursor Delegate free?

Yes. Cursor Delegate is open source, so you can use and self-host it for free.

How do I add Cursor Delegate to Claude Code?

Run this command in your terminal: claude mcp add cursor-delegate-mcp -- npx -y cursor-delegate-mcp

What are the best alternatives to Cursor Delegate?

The closest alternatives to Cursor Delegate are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Cursor Delegate

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools