Ask Cursor (new chat)
cursor_askRun a new Cursor coding chat with an optional model and project workspace to answer questions or perform agentic coding tasks. Continue the same task with follow-up calls.
Instructions
Best for agentic coding on a Cursor plan, with a wide model menu
(GPT/Claude/Grok/Composer via model) (cursor-agent -p), in a NEW chat. Pass
workspace=; without it the sub-agent sees no repo. Follow up with
cursor_continue. Uses your Cursor login or CURSOR_API_KEY. Its sandbox is
agent-enforced (read-only = ask mode), not an OS boundary. Autonomous agent: trusted
prompts only.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>"
},
"name": "cursor_ask"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Optional model override (`--model`, e.g. "auto", "gpt-5.2", "claude-opus-4-8-high", "composer-2.5"); validated against `cursor-agent models` and rejected on a typo. cursor bakes the effort and speed axes into the id (…-low/-high/-xhigh/-max, each with a -fast twin) and also accepts a bracket form on the family base, e.g. "claude-opus-4-8[context=1m,effort=high]". 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
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |