Use the Speak AI MCP server tool run_automations to manually run one or more
automations against one or more media items now (outside the normal trigger).
What does it do?
Manually run one or more automations against one or more media items now (outside
the normal trigger). Only active automations run; inactive or unknown automation ids
and unknown media ids are skipped without an error. The runs happen in the
background and this returns only an acknowledgement, so check results with
get_automation_runs. Every step executes for real: it can send email, post to
Slack, call webhook URLs, run actions in connected third-party apps, and use AI
credits.
Parameters
run_automations takes 2 parameters, all of them required.
| Name | Type | Required | Description |
|---|---|---|---|
mediaIds |
array of string | Yes | Media ids to run the automations against |
automationIds |
array of string | Yes | Automation ids to run |
Behaviour
The Speak AI MCP server publishes these behaviour hints for run_automations.
- Can change data in your workspace.
- Can delete or overwrite data. Use with care.
- Repeating an identical call can have an extra effect.
- Can reach systems outside Speak AI.
Related
- Automations lists the rest of the Automations category.
- Tool reference lists every Speak AI MCP server tool.
- MCP server covers setup, supported clients, and what agents can do once connected.