Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DEBUG_CURSOR_MCP | No | Set to '1' to log spawn/exit diagnostics to stderr | |
| CURSOR_AGENT_PATH | No | Absolute path to the cursor-agent binary; falls back to PATH | |
| CURSOR_AGENT_FORCE | No | Set to 'true' or '1' to inject -f unless already present | |
| CURSOR_AGENT_MODEL | No | Default model (appended as -m <model> unless you already provided one) | |
| CURSOR_AGENT_TIMEOUT_MS | No | Hard runtime ceiling in milliseconds | 30000 |
| CURSOR_AGENT_ECHO_PROMPT | No | Set to '1' to prepend the effective prompt to the tool's result | |
| CURSOR_AGENT_IDLE_EXIT_MS | No | Idle-kill threshold in ms; '0' disables idle kill (recommended) | 0 |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| cursor_agent_chat | Chat with cursor-agent using a prompt and optional model/force/output_format. |
| cursor_agent_edit_file | Edit a file with an instruction. Prompt-based wrapper; no CLI subcommand required. |
| cursor_agent_analyze_files | Analyze one or more paths; optional prompt. Prompt-based wrapper. |
| cursor_agent_search_repo | Search repository code with include/exclude patterns. Prompt-based wrapper. |
| cursor_agent_plan_task | Generate a plan for a goal with optional constraints. Prompt-based wrapper. |
| cursor_agent_raw | Advanced: provide raw argv array to pass after common flags (e.g., ["search","--query","foo"]). |
| cursor_agent_run | Run cursor-agent with a prompt and desired output format (legacy single-shot). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |