Workflows v2 (Plays) / MCP
List workflow runs
List recent executions of a workflow. Returns up to `limit` runs (default 20, max 100) ordered newest first, each carrying status, trigger_type, started_at, finished_at, and aggregate counts. Pair with get-workflow-run to drill into a specific execution.
tools/callDeterministic operationParameters
workspaceIdOptional · string- Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.
workflowIdRequired · string- Workflow UUID.
limitOptional · number- Max rows to return (1-100, default 20).
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list-workflow-runs",
"arguments": {
"workflowId": "00000000-0000-4000-8000-000000000000"
}
}
}Full input schema
{
"type": "object",
"properties": {
"workspaceId": {
"type": "string",
"minLength": 1,
"description": "Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client."
},
"workflowId": {
"type": "string",
"description": "Workflow UUID."
},
"limit": {
"type": "number",
"description": "Max rows to return (1-100, default 20)."
}
},
"required": [
"workflowId"
]
}