Cursor Server

An MCP (Model Context Protocol) server that wraps the Cursor CLI agent, enabling Claude Code and other MCP clients to delegate tasks to Cursor's AI agent.

Features

• cursor_agent - Execute tasks with full Cursor agent capabilities (file writing, bash commands, etc.)
• cursor_plan - Read-only planning mode to design approaches before coding
• cursor_ask - Read-only Q&A mode for questions about the codebase
• cursor_status - Check Cursor agent authentication status
• cursor_resume - Resume previous Cursor agent conversations

Prerequisites

1. Install the Cursor CLI agent:

   curl https://cursor.com/install -fsS | bash
   

2. Authenticate:

   agent login
   

3. Install Python dependencies:

   pip install fastmcp
   

Usage

With Claude Code

Add to your Claude Code MCP configuration (~/.claude.json or project settings):

{
  "mcpServers": {
    "cursor-agent": {
      "command": "python",
      "args": ["/path/to/cursor_mcp_server.py"],
      "env": {
        "CURSOR_WORKSPACE_PATH": "/path/to/your/workspace"
      }
    }
  }
}

Environment Variables

Variable	Description	Default
CURSOR_WORKSPACE_PATH	Default working directory for agent tasks	~
CURSOR_AGENT_PATH	Path to the cursor agent executable	agent
CURSOR_DEFAULT_TIMEOUT	Default timeout in seconds	300
CURSOR_DEFAULT_MODEL	Default model for agent tasks	gpt-5.2-codex-xhigh

Running Standalone

python cursor_mcp_server.py

Tool Reference

cursor_agent

Execute tasks with full agent capabilities.

cursor_agent(
    prompt="Implement a login form with validation",
    workspace="/path/to/project",  # optional
    force=True,  # allow file modifications
    timeout=300,  # seconds
    model="gpt-5.2-codex"  # optional model override
)

cursor_plan

Design an approach before implementing.

cursor_plan(
    prompt="How should I refactor the authentication system?",
    workspace="/path/to/project"
)

cursor_ask

Ask questions about the codebase.

cursor_ask(
    prompt="What does the DatabaseManager class do?",
    workspace="/path/to/project"
)

cursor_resume

Resume a previous conversation.

cursor_resume(
    prompt="Continue with the next step",
    session_id="abc123",  # optional, omit for latest session
    workspace="/path/to/project"
)

License

MIT