cursor_request
Destructive
Execute Cursor Agent CLI requests synchronously, supporting plan and ask modes with configurable model, output format, and session management.
Instructions
Run a Cursor Agent CLI request synchronously (auto-defers to a pollable job past the sync deadline when async jobs are enabled; otherwise runs to completion). Headless print mode (cursor-agent --print).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Cursor execution mode: plan (read-only planning) or ask (Q&A/read-only) | |
| force | No | Emit --force (Cursor yolo mode; auto-allows commands unless explicitly denied) | |
| model | No | Model name or alias passed via --model | |
| trust | No | Trust the workspace in headless mode (--trust) | |
| addDir | No | Additional workspace root directories (--add-dir, repeatable) | |
| prompt | Yes | Prompt text for Cursor Agent CLI | |
| sandbox | No | Cursor sandbox mode override (--sandbox enabled|disabled) | |
| sessionId | No | Cursor chat/session ID to resume (emits --resume <id>). Note: the gw-* id minted for a brand-new gateway session is not resumable via sessionId; continue with resumeLatest:true. | |
| transport | No | Transport selector. Default `cli` uses cursor-agent --print. `acp` uses the native cursor-agent acp transport and fails closed unless [acp] and [acp.providers.cursor].runtime_enabled are true. | cli |
| workspace | No | Workspace directory or saved workspace name (--workspace). Remote HTTP/OAuth callers must pass a registered workspace alias; local stdio callers may pass local Cursor workspace paths. | |
| autoReview | No | Emit --auto-review (Cursor Smart Auto classifier for tool calls) | |
| forceRefresh | No | Bypass dedup and force a fresh CLI run even if a recent identical request exists | |
| outputFormat | No | Cursor --output-format for --print mode | text |
| resumeLatest | No | Resume the latest Cursor chat (--continue). Note: the gw-* id minted for a brand-new gateway session is not resumable via sessionId; continue with resumeLatest:true. | |
| correlationId | No | Request trace ID (auto if omitted) | |
| idleTimeoutMs | No | Idle timeout in ms (min 30s, max 1h, omit=CLI default) | |
| approvalPolicy | No | Approval policy when approvalStrategy is mcp_managed: strict|balanced|permissive (default balanced). Ignored under legacy strategy. | |
| optimizePrompt | No | Optimize prompt before execution | |
| approvalStrategy | No | Approval strategy: legacy (default) lets Cursor's own flags decide; mcp_managed routes high-impact Cursor controls (force, trust, sandbox disabled) through the gateway approval gate. | legacy |
| compressResponse | No | Compress the response display text via the native compressor (default: [compression].enabled in config.toml, off unless opted in). Skipped for structured output. | |
| createNewSession | No | Force a new session | |
| optimizeResponse | No | Optimize response output |