Automations

Run automations and read their runs. 4 tools: 3 read, 1 write.

Tool	Access	What it does
`nc_run_automation`	write	Trigger an existing NexaCloser automation by id, passing arbitrary JSON as trigger_data.
`nc_list_automations`	read	List all automations for the authenticated user with id, name, trigger type, active state, and total runs.
`nc_get_automation_run`	read	Get the status + step_results of a specific automation run by id.
`nc_list_recent_runs`	read	List the most recent automation runs across all automations.

`nc_run_automation`

write Needs mcp:write on an OAuth or MCP-server token.

Trigger an existing NexaCloser automation by id, passing arbitrary JSON as trigger_data. Returns the run id and final status.

Argument	Type	Required	Description
`automation_id`	string	yes
`trigger_data`	object

`nc_list_automations`

read Works with mcp:read.

List all automations for the authenticated user with id, name, trigger type, active state, and total runs. Use this to discover automation_id values for nc_run_automation.

Argument	Type	Required	Description
`active_only`	boolean		When true, only return active automations. · Default: `false`

`nc_get_automation_run`

read Works with mcp:read.

Get the status + step_results of a specific automation run by id. Use after nc_run_automation to confirm what happened.

Argument	Type	Required	Description
`run_id`	string	yes

`nc_list_recent_runs`

read Works with mcp:read.

List the most recent automation runs across all automations. Includes status, started_at, completed_at, and error_message for failed runs.

Argument	Type	Description
`automation_id`	string	Optional — filter to one automation
`status`	string	One of: `completed`, `failed`, `running`, `all` · Default: `"all"`
`from`	string	ISO: started at/after this moment.
`to`	string	ISO: started before this moment.
`limit`	integer	Default: `10` · Min 1 · Max 50
`offset`	integer	Skip this many rows (paging). · Default: `0` · Min 0