Triggers

MCP tools for the Triggers module. See the Triggers module docs 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	—