Manage monday Platform Agent Triggers
manage_agent_triggersList, add, or remove triggers that define when a monday.com agent runs automatically. Use block_reference_id to add trigger types and node_id to remove instances.
Instructions
Manage the triggers attached to a monday platform agent — triggers define WHEN the agent runs automatically.
ACTIONS:
list: { agent_id } — returns active triggers with node_id, block_reference_id, name, field_summary.
add: { agent_id, block_reference_id, field_values? } — attaches a trigger type to the agent.
remove: { agent_id, node_id } — detaches a trigger instance by node_id (NOT block_reference_id).
WORKFLOW — add a trigger:
Call agent_catalog action:"list_triggers" — note block_reference_id, field_schemas, and required_fields.
Collect required field values from the user (e.g. board_id, column_id).
Call this tool action:"add" with block_reference_id and field_values. Note: add returns only { success } — no node_id for the new instance. Call action:"list" afterward if you need the node_id.
WORKFLOW — remove a trigger:
Call action:"list" to see active triggers and note the node_id of the instance to remove.
Call action:"remove" with that node_id.
NOTE: Only triggers that can be added programmatically appear in the catalog. OAuth/3rd-party triggers (Slack, Gmail, Salesforce, etc.) require user setup in the monday.com UI — they will not appear in agent_catalog and cannot be managed here.
USAGE EXAMPLES:
List triggers: { "action": "list", "agent_id": "7" }
Add trigger: { "action": "add", "agent_id": "7", "block_reference_id": "status-change-ref", "field_values": { "board_id": "42" } }
Remove trigger: { "action": "remove", "agent_id": "7", "node_id": "node-abc" }
RELATED TOOLS:
agent_catalog action:"list_triggers" — discover available trigger types and their required field_values before calling action:"add" here
manage_agent_skills — manage which skills this agent can perform
manage_agent — manage the agent entity itself (create, activate, deactivate, etc.)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | "list" — returns all triggers currently attached to this agent (includes node_id needed for remove). "add" — attaches a new trigger by block_reference_id. "remove" — detaches a trigger instance by node_id. | |
| agent_id | Yes | Unique identifier of the agent. | |
| block_reference_id | No | Required for action:"add". The block_reference_id from agent_catalog action:"list_triggers" identifying the trigger type to attach. Never guess this value — look it up in the catalog first. | |
| field_values | No | Used with action:"add" when the trigger type has required_fields. Key/value object whose shape is described by field_schemas in the agent_catalog response. Scalar fields use string/number/boolean values. Selection fields use { "value": "<id>", "label": "<name>" }. | |
| node_id | No | Required for action:"remove". The node_id of the trigger instance — get it from action:"list". Each instance has a unique node_id even if the same trigger type is attached multiple times. Do NOT pass block_reference_id here. |