cursor-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CURSOR_API_KEY | Yes | A Cursor API key created at https://cursor.com/dashboard/api. Required to authenticate with the Cursor API. | |
| CURSOR_MCP_POLICY | No | Optional path to a custom policy JSON file that overrides the default policy path ~/.config/cursor-mcp/policy.json. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| cursor_whoamiA | Verify the Cursor API key and return its name, creation date, and owning email. |
| cursor_list_modelsA | List model ids accepted when launching a cloud agent. Omit the model to use the account default. |
| cursor_list_reposA | List GitHub repositories Cursor can launch an agent against. Rate limited to one call per minute. |
| cursor_list_workspace_controlsA | List Cloud Agent workspace and account controls and whether each is supported, unverified, unsupported, or unavailable. |
| cursor_inspect_workspaceA | Inspect API-key identity, entitlement, and the workspace-control surface. Does not list repositories. |
| cursor_get_workspace_controlA | Read one workspace or account control. Supported controls fetch live; others return a capability result. |
| cursor_list_agentsA | List cloud agents, newest first. Status is not execution state; use cursor_get_run. |
| cursor_get_agentA | Inspect one agent: repos, settings, web URL, and the id of its most recent run. |
| cursor_list_runsB | List an agent's runs, newest first. Run status carries the execution state: CREATING, RUNNING, or a terminal value. |
| cursor_get_runA | Inspect one run: status, duration, reported branch or PR, and the final reply once it has finished. |
| cursor_inspect_runsA | Read status for up to 64 agent/run id pairs you hold, in your order, under one 45s bound. Exact pairs only; continue at remaining.fromIndex unless complete. |
| cursor_wait_runA | Poll one run until it is terminal or waitMs elapses (default 30s, maximum 45s). Returns what cursor_get_run returns plus timedOut; call again to keep waiting. |
| cursor_get_usageA | Report an agent's token usage, totalled and broken down per run. Pass runId to scope it to one run. |
| cursor_tail_runA | Read a bounded run activity excerpt. Pass lastEventId back to resume; without it Cursor replays from the beginning. Status is checked separately. Does not cancel the cloud run. |
| cursor_list_artifactsA | List files an agent saved to its workspace artifacts directory. Code changes land on the branch, not here. |
| cursor_get_artifact_urlA | Mint a 15-minute presigned download URL for one artifact path from cursor_list_artifacts. |
| cursor_validate_environment_definitionA | Check a Cursor environment definition against the published schema. Schema errors, safety warnings, and capability limitations are reported separately. |
| cursor_inspect_environment_definitionA | Normalized view of a Cursor environment definition: install and start, terminals, ports, MCP policy, container build paths, and snapshot input. Scripts are digests. |
| cursor_diff_environment_definitionA | Bounded semantic diff between two Cursor environment definitions. Scripts and MCP patterns are compared by digest, so no field value can leave through the diff. |
| cursor_list_environmentsA | List saved cloud environments through a configured Cursor CLI. Without one, reports why the authority is unavailable. |
| cursor_get_environment_configurationA | Read one environment's configuration candidates, source, precedence, and digest through a configured Cursor CLI. Scripts stay digests. |
| cursor_list_owner_actionsB | Catalog of Build and environment operations no supported authority performs: cancel, activate, deactivate, roll back, Restore, host-wide trigger. Returns the exact owner action for the ids you pass; launches nothing. |
| cursor_assess_environment_healthA | Judge Build health, source drift, and toolchain drift from readback you hold. Launches nothing and returns a scheduler exit code. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 23 tools
Most tools target distinct resources and actions, and the descriptions clearly separate list/get/inspect/wait/tail operations. A few clusters, especially around workspace controls and run inspection, could require close reading to pick the right tool, but none truly duplicate another.
All tools use the consistent cursor_<verb>_<object> pattern with lowercase snake_case. The only minor deviation is cursor_whoami, but it is a conventional verb-like command and does not disrupt the overall consistency.
23 tools is on the heavy side, but the domain is broad, covering identity, workspace controls, agents, runs, usage, artifacts, and environment definitions. Each tool has a distinct purpose, so the count feels slightly large rather than bloated.
The read/inspection side is thorough: identity, agents, runs, usage, artifacts, environment definitions, and health are well covered. However, there are no tools to launch, mutate, or cancel agents or runs, despite descriptions referencing launching cloud agents, and owner actions are only returned, not executed.