# Cursor Agent - Workflow node | Docs - nodulz

Source: https://nodulz.com/docs/nodes/ai_cursor

Language: en

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](/docs/credentials/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](/docs/credentials) 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

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

See also : [Expressions and data](/docs/expressions), [Executions](/docs/executions), [Node catalog](/docs/nodes).

## Explore further

- [Features - nodulz](https://nodulz.com/product/overview)
- [Node catalog - nodulz](https://nodulz.com/product/catalog)
- [MCP server - nodulz](https://nodulz.com/product/mcp)
- [Pricing - nodulz](https://nodulz.com/pricing)
- [Use cases and workflow automation - nodulz](https://nodulz.com/use-cases)
- [Choose what your workflows can do. - nodulz](https://nodulz.com/compare)
- [Documentation - nodulz](https://nodulz.com/docs)