cursor-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@cursor-mcp Ask Cursor agent with Claude Sonnet to review my uncommitted changes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
cursor-mcp
Run Cursor's coding agent from Claude Code, with any model your Cursor plan offers.
Install
curl https://cursor.com/install -fsS | bash && agent login # the Cursor CLI
claude mcp add --scope user cursor-cli -- npx -y @qmediat.io/cursor-mcpRelated MCP server: cursor-agent-bridge
Try it
Use cursor_agent to add input validation to src/form.tsTools
Tool | Does |
| Run a prompt with Cursor's agent |
| Continue a session |
| Models your plan offers |
| Sessions of this server |
| Installation and login check |
Supports · version 1.2.3
Works in | Claude Code · Claude Desktop |
Model families | Composer · Claude · GPT · Gemini · Grok |
Runs on | macOS · Linux |
Docs
Read | File |
docs/CONFIGURATION.md | |
docs/TOOLS.md | |
docs/SUPERVISED-CODING.md | |
SECURITY.md | |
CONTRIBUTING.md | |
AGENTS.md |
Node.js 22 or newer · MIT · Quantum Media Technologies · Trademarks
Available Tools
5 toolscursor_agentA
Execute a prompt using Cursor's AI agent with any model id the installed cursor-agent accepts (Composer, Claude, GPT, Gemini, Grok families on your plan; run cursor_models for ids). Modes: 'agent' (tools, terminal, search), 'plan' (design-focused), 'ask' (read-only). In headless mode cursor-agent only PROPOSES file changes unless the server operator set CURSOR_ALLOW_YOLO=true (then --force applies them; CURSOR_SANDBOX=enabled confines them). The result lists the files changed and the model used; a client that sends a progress token gets a progress notification per tool call.
Inputs: prompt (required), mode, model, workspace, +1 more. Returns: model, result, status, stderr, +10 more
cursor_healthA
Check Cursor CLI installation, authentication, and server configuration. Run this first to verify everything is set up correctly.
Inputs: no named parameters.
cursor_modelsA
List the model ids the installed cursor-agent offers (its models command), or a known list when it offers none. Pricing is on cursor.com/docs/models-and-pricing. Use an id with cursor_agent's 'model' parameter.
Inputs: no named parameters.
cursor_replyA
Continue an existing Cursor agent session. Send a follow-up message in the same conversation context. Requires a session_id from a previous cursor_agent call.
Inputs: prompt (required), session_id (required), model, timeout_seconds. Returns: model, result, status, stderr, +10 more
cursor_sessionsA
List Cursor agent sessions created during this MCP server instance. Shows session IDs, models, and prompts. Use session IDs with cursor_reply to continue a conversation.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct operation: starting an agent session, continuing it, listing models, listing sessions, and checking health. The session_id requirement in cursor_reply clearly separates it from cursor_agent, leaving no ambiguity.
All tools share the consistent `cursor_` prefix and snake_case, but suffixes mix nouns (agent, models, sessions, health) with a verb-like action (reply). This minor deviation is still readable and predictable.
Five tools is well-scoped for a Cursor agent wrapper, covering execution, continuation, discovery, and diagnostics without redundancy. Each tool clearly earns its place.
Core workflows for interacting with the Cursor agent are covered: starting, continuing, listing models/sessions, and health checks. Minor gaps like session cancellation or status inspection exist but are not essential for typical use.
Maintenance
Related MCP Connectors
Discover and call AI agents via MCP. Supports A2A agents and platform agents with async tasks.
Real-time chat for AI agents. Claude Code, Cursor, Cline and Codex join channels over MCP.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
A paid remote MCP for OpenAI Codex agent coordination MCP, built to return verdicts, receipts, usage
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables MCP clients to invoke Cursor SDK's agent runtime, run coding agents, list models, and continue conversations.41MIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients like Claude Code to delegate coding tasks to the local Cursor Agent CLI, with persistent per-workspace sessions that resume across calls.12 npmMIT
- AlicenseAqualityBmaintenanceEnables MCP clients like Claude Code and Codex to delegate coding tasks to Cursor's CLI agent, which implements changes in the workspace and returns clean, structured results for review.3580 npm9MIT
- AlicenseAqualityCmaintenanceEnables AI assistants and other MCP clients to launch and steer Cursor Cloud Agents on repositories or as repo-less research tasks, including model selection, mid-run follow-ups, cancellation, result retrieval, and run listing. Also exposes authentication checks and per-agent or per-run token usage and cost reporting.9MIT