MCP tool
cascades_list_workflows
List the caller's saved Cascades (decision workflows) — their id, code, name, use_case, trigger_type, and whether each is active. Use this first when the user refers to a cascade by name or asks "what can I run", to discover the workflow id you then pass to cascades_trigger_workflow. Only workflows owned by the API key's account are returned. Optional filters narrow the list.
REST operation
This tool makes one call:
GET
/api/v1/workflows
— see listWorkflows in the API reference for the full response schema and error codes.
Input schema
| Argument | Type | Description |
|---|---|---|
page
|
integer |
1-based page number. |
per_page
|
integer |
Items per page. Values above 100 are clamped to 100. |
active
|
boolean |
Only active (`true`) or draft (`false`) workflows. |
use_case
|
string |
Exact match, e.g. `tenant_screening`. |
trigger_type
|
string |
Exact match. Not validated: a value outside the list returns an empty list, not an error.
One of:
manual event scheduled |
environment
|
string |
Target environment: "prod" (default) or "dev".
One of:
dev prod |
Example
What the model sends, and the JSON the tool returns (the REST response, verbatim).
Call
{
"name": "cascades_list_workflows",
"arguments": {
"active": true
}
}Result
{
"data": [
{
"id": 157,
"object": "workflow",
"code": "WF-157",
"name": "Tenant screening — standard",
"use_case": "tenant_screening",
"trigger_type": "manual",
"active": true
}
],
"meta": {
"page": 1,
"per_page": 25,
"total_count": 1,
"total_pages": 1,
"object": "list"
}
}