cursor_agent_run
Execute a one-off prompt via the Cursor agent CLI for heavy repo-aware tasks like search, analysis, planning, and edits.
Instructions
Legacy single-shot chat (prompt as positional). Prefer cursor_agent_chat.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | ||
| force | No | Pass --force / --yolo so the agent can run shell without prompts. Env: CURSOR_AGENT_FORCE. | |
| model | No | Model id for the CLI (e.g. auto, gpt-5, composer-2). Overrides CURSOR_AGENT_MODEL. | |
| trust | No | Pass --trust (default true). Env: CURSOR_AGENT_TRUST. | |
| prompt | Yes | ||
| api_key | No | Cursor API key (crsr_…). Prefer CURSOR_API_KEY / CURSOR_AGENT_API_KEY in MCP env. | |
| config_dir | No | Explicit CURSOR_CONFIG_DIR override. Implies isolated config for this call. | |
| executable | No | ||
| extra_args | No | ||
| bare_config | No | Use an isolated CURSOR_CONFIG_DIR (~/.cursor-agent-mcp by default) so the CLI does not load user MCPs/plugins. Much faster startup. Env: CURSOR_AGENT_BARE_CONFIG=1. | |
| echo_prompt | No | ||
| output_format | No | text |