Ask Cursor (new chat)
cursor_askSubmit a question or task to Cursor CLI in a new chat. Returns the agent's final message using your Cursor login and optional workspace context.
Instructions
Ask the Cursor CLI (cursor-agent -p) a question or task in a NEW chat.
Uses your existing Cursor login (OS credential store, or a CURSOR_API_KEY env
var — see cursor_status). Returns the agent's final message, read straight
from stdout (no scraping). Cursor is a capable agentic coder with a wide model
menu (GPT / Claude / Grok / Composer); point workspace at a project dir for
context-aware answers.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Optional model override (`--model`, e.g. "gpt-5.2", "sonnet-4-thinking", "auto"); validated against `cursor-agent models` and rejected on a typo. Omit to use your Cursor default. | |
| watch | No | If true, open a live "watch" view streaming cursor's steps from its `--output-format stream-json` event stream. Same final text is returned. Best-effort. Default false. | |
| prompt | Yes | Question or instruction for Cursor. | |
| sandbox | No | Permission policy (maps to cursor's mode/force flags): "read-only" (default — `--mode ask`: agent-enforced, no file/shell edits; NOT an OS sandbox, so unlike codex it is not a hard boundary), "workspace-write" (may edit files, rooted at the workspace), or "danger-full-access" (OS sandbox off — avoid). | read-only |
| timeout_s | No | Max seconds to wait for cursor to complete. Default 180. | |
| workspace | No | Working root for the chat (`--workspace`). Defaults to the server cwd. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |