MCP tools

Run workflow

Trigger a workflow to run now, starting a new execution.

Tool name: run-workflow.

Trigger a workflow to run now, starting a new execution. WRITE.

When to use

Kick off a workflow run on demand. Poll getWorkflowExecution for progress.

Access

PropertyValue
Required scopewrite
PublishesNo
Read-onlyNo
DestructiveYes
IdempotentNo
Open worldYes

Input

FieldTypeRequiredDescription
workflowIdstringYes

Output

The tool catalog does not declare an output schema for this tool.

REST equivalent

POST /v1/brands/{brandId}/workflows/{workflowId}/runs, Run workflow. CLI: koast run-workflow.

On this page