# Triggers

> MCP tools for the Triggers module. See the [Triggers module docs](/docs/modules/triggers) for permissions and data model.

# Triggers

MCP tools for the Triggers module. See the [Triggers module docs](/docs/modules/triggers) for permissions and data model.

### `list-triggers`

List triggers

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `project_id` | `string` | no | — |
| `type` | `string` | no | — |
| `target_type` | `string` | no | — |
| `limit` | `number` | no | Maximum number of results to return |
| `offset` | `number` | no | Number of results to skip |

### `create-trigger`

Create a trigger

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `project_id` | `string` | no | Public ID of the project. Optional when authenticating with a project-scoped API key, which defaults to the key's project; required otherwise. |
| `name` | `string` | yes | — |
| `description` | `string` | no | — |
| `type` | `string` | yes | — |
| `target_type` | `string` | yes | — |
| `target_id` | `string` | yes | — |
| `action` | `string` | no | Tool targets only — the action for builtin/mcp tools |
| `input` | `object` | no | — |
| `cron` | `string` | no | 5-field cron expression (UTC). Required when type is schedule |
| `event_pattern` | `string` | no | Internal-event subscription pattern. Required when type is event, rejected otherwise. `*` matches every event, `prefix.*` a namespace, or give an exact event name such as `documents.ingested` |
| `active` | `boolean` | no | — |
| `policy_id` | `string` | no | — |

### `get-trigger`

Get a trigger

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `trigger_id` | `string` | yes | — |

### `update-trigger`

Update a trigger

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `trigger_id` | `string` | yes | — |
| `name` | `string` | no | — |
| `description` | `string \| null` | no | — |
| `target_type` | `string` | no | — |
| `target_id` | `string` | no | — |
| `action` | `string \| null` | no | — |
| `input` | `object \| null` | no | — |
| `cron` | `string \| null` | no | — |
| `event_pattern` | `string \| null` | no | — |
| `active` | `boolean` | no | — |
| `policy_id` | `string \| null` | no | — |

### `delete-trigger`

Delete a trigger

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `trigger_id` | `string` | yes | — |

### `fire-trigger`

Fire a trigger

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `trigger_id` | `string` | yes | — |
| `input` | `object` | no | Fire-time input, shallow-merged over the trigger's static input. For `eval` targets it may carry `agent_version` and `baseline_run_id`. |

### `get-trigger-secret`

Get trigger secret

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `trigger_id` | `string` | yes | — |

### `rotate-trigger-secret`

Rotate trigger secret

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `trigger_id` | `string` | yes | — |

### `list-trigger-firings`

List trigger firings

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `trigger_id` | `string` | yes | Trigger to list firings for (trg_...) |
| `limit` | `number` | no | — |
| `offset` | `number` | no | — |

### `get-trigger-firing`

Get a trigger firing

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `firing_id` | `string` | yes | — |