list-dag-runs
List DAG runs for a specific DAG, showing execution dates, states, and run IDs. Filter by state or date range, sort, and paginate results for efficient monitoring.
Instructions
List DAG runs for a specific DAG.
Returns a list of DAG runs with their execution dates, states, and run IDs.
Results are sorted by execution date descending (newest first) by default.
Args:
ctx: The MCP context.
environment_name: Name of the MWAA environment.
dag_id: The DAG identifier.
limit: Maximum number of results.
offset: Pagination offset.
state: Filter by run state.
order_by: Sort order (default: "-execution_date", newest first).
execution_date_gte: Filter runs on or after this date (ISO 8601).
execution_date_lte: Filter runs on or before this date (ISO 8601).
region: AWS region override.
profile_name: AWS CLI profile name override.
Returns:
CallToolResult with the list of DAG runs.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of DAG runs to return. | |
| state | No | Filter by run state (e.g., "success", "failed", "running"). | |
| dag_id | Yes | The DAG ID to list runs for. | |
| offset | No | Number of DAG runs to skip for pagination. | |
| region | No | AWS region override. | |
| order_by | No | Sort order for results. Prefix with "-" for descending. Default: "-execution_date" (newest first). Examples: "execution_date", "-start_date", "-end_date". | -execution_date |
| profile_name | No | AWS CLI profile name override. | |
| environment_name | No | Name of the MWAA environment. If omitted and only one environment exists, it is used automatically. | |
| execution_date_gte | No | Filter runs with execution date >= this value (ISO 8601, e.g., "2026-02-20T00:00:00+00:00"). | |
| execution_date_lte | No | Filter runs with execution date <= this value (ISO 8601, e.g., "2026-02-21T00:00:00+00:00"). |