---
title: cascades_list_workflows
description: List the caller's saved Cascades (decision workflows) — their id, code, name, use_case, trigger_type, and whether each is active.
canonical_url: "https://cascades.crscreditapi.com/docs/mcp/tools/cascades_list_workflows"
doc_version: "1.0.0"
last_updated: "2026-10-09T14:37:54Z"
source: docs/mcp/tools.json
---

# `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.

- **Access:** read
- **Scopes:** `workflows:read`
- **REST operation:** `GET /api/v1/workflows` — [listWorkflows](https://cascades.crscreditapi.com/docs/api/workflows/list-workflows.md)

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `page` | `integer` | no | 1-based page number. |
| `per_page` | `integer` | no | Items per page. Values above 100 are clamped to 100. |
| `active` | `boolean` | no | Only active (`true`) or draft (`false`) workflows. |
| `use_case` | `string` | no | Exact match, e.g. `tenant_screening`. |
| `trigger_type` | `string` | no | Exact match. Not validated: a value outside the list returns an empty list, not an error. One of: `manual`, `event`, `scheduled`. |
| `environment` | `string` | no | Target environment: "prod" (default) or "dev". One of: `dev`, `prod`. |

## Example call

```json
{
  "name": "cascades_list_workflows",
  "arguments": {
    "active": true
  }
}
```

## Example result

```json
{
  "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"
  }
}
```

## Sitemap

See the full [sitemap](https://cascades.crscreditapi.com/sitemap.md) for all pages.