list_testruns
Browse and filter test runs by branch, time interval, author, environment, or commit to find specific test executions and analyze results.
Instructions
Browse and filter your test runs to find specific test executions. Filter by git branch (e.g., 'develop', 'main'), time interval ('1d', '3d', 'weekly', 'monthly', or custom date ranges), commit author, or environment (e.g., 'production', 'staging', 'development'). Supports efficient pagination using page/limit or offset/limit, or use get_all=true to fetch all results (up to 1000). Returns test run summaries with statistics (total, passed, failed, skipped, flaky counts), duration, status, branch, author, and PR information when available. Perfect for answering questions like 'What tests ran on the develop branch?' or 'Show me all test runs from last week.' The PAT should be configured in mcp.json as TESTDINO_PAT environment variable.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectId | Yes | Project ID (Required). The TestDino project identifier. | |
| by_branch | No | Filter by git branch name (e.g., 'main', 'develop', 'feature/login'). | |
| by_time_interval | No | Filter by time: '1d' (last day), '3d' (last 3 days), 'weekly' (last 7 days), 'monthly' (last 30 days), or '2024-01-01,2024-01-31' (date range). | |
| by_author | No | Filter by commit author name (case-insensitive, partial match). | |
| by_commit | No | Filter by git commit hash (full or partial). | |
| by_environment | No | Filter by environment. Example: 'production', 'staging', 'development'. | |
| limit | No | Number of results per page (default: 20, max: 1000). | |
| page | No | Page number (default: 1). | |
| get_all | No | Get all results up to 1000 (default: false). |