Cursor Agent

Node catalog Artificial intelligence

On this page

Cursor cloud agents on your Git repositories

Usage and specifics

Choose agent creation, follow-up, retrieval or conversation. The key must access the selected repositories. waitForCompletion and timeoutMs control waiting for long operations.

Technical type : ai_cursor. Runtime : nodulz.

Credentials and prerequisites

Create and configure the credential : cursor

Create credentials in your nodulz instance’s Credentials area, then select them on the node. Availability depends on ownership and sharing. See the credentials guide for access and rotation.

Parameters

Names below are technical keys. Defaults are not a ready-to-run configuration: complete fields required by your operation. Paths containing [] describe list items; some fields depend on the selected mode.

Parameter	Type	Default	Values / limits
`credentialId`	`string`	-	-
`operation`	`enum`	`"create_agent"`	`create_agent`, `follow_up`, `get_agent`, `list_conversation`
`promptText`	`string`	`""`	-
`images`	`array`	`[]`	-
`images[].sourceType`	`enum`	`"url"`	`url`, `base64`
`images[].sourceMode`	`enum`	`"manual"`	`manual`, `node`, `file`
`images[].source`	`string`	`""`	-
`images[].mimeType`	`string`	`"image/png"`	-
`modelId`	`string`	`""`	-
`modelParamsJson`	`string`	`""`	-
`agentName`	`string`	`""`	-
`repos`	`array`	`[]`	-
`repos[].url`	`string`	`""`	-
`repos[].startingRef`	`string`	`"main"`	-
`repos[].prUrl`	`string`	`""`	-
`workOnCurrentBranch`	`boolean`	`false`	-
`autoCreatePR`	`boolean`	`false`	-
`mcpServersJson`	`string`	`""`	-
`agentId`	`string`	`""`	-
`runId`	`string`	`""`	-
`waitForCompletion`	`boolean`	`true`	-
`timeoutMs`	`number`	`600000`	-; ≥ 1000

Configuration help

credentialId AI credential: API key stored on the Credentials page for this provider.
operation Operation: Cursor Cloud Agents action to execute.
promptText Prompt: Instructions sent to the Cursor agent.
agentId Agent ID: Cursor agent ID for follow-up or read operations.
agentName Agent name: Display name for the new Cursor agent.
modelId Model: Model identifier at the provider (e.g. gpt-4o, claude-3-5-sonnet).
modelParamsJson Model params (JSON): JSON model parameters sent to the Cursor API.
workOnCurrentBranch Push to current branch: Pushes commits to the current branch instead of a dedicated branch.
autoCreatePR Auto-create pull request: Automatically opens a pull request after changes.
mcpServersJson MCP servers (JSON): JSON configuration of MCP servers available to the agent.
waitForCompletion Wait for run completion: Waits for execution to finish before continuing the workflow.
timeoutMs Timeout (ms): Maximum wait time in milliseconds.
runId Run ID (optional): Optional run ID to filter or resume.

Examples

Prompt

Initial configuration

Initial catalog configuration example, to adapt before running. Keep secrets in credentials.

json

{
  "operation": "create_agent",
  "promptText": "",
  "images": [],
  "modelId": "",
  "modelParamsJson": "",
  "agentName": "",
  "repos": [],
  "workOnCurrentBranch": false,
  "autoCreatePR": false,
  "mcpServersJson": "",
  "agentId": "",
  "runId": "",
  "waitForCompletion": true,
  "timeoutMs": 600000
}

Verification

Test with representative data. Check node output in the inspector and logs, then use editor mapping for downstream fields. A trigger test with a simulated payload does not validate external service delivery.