list_testruns
Browse and filter test runs by branch, status, time, environment, author, or tags to locate specific executions. Sort and paginate results for efficient review.
Instructions
Browse and filter your test runs to find specific test executions. Filter by git branch (e.g., 'develop', 'main'), run status ('passed', 'failed', 'interrupted', 'incomplete', 'running'), time interval ('Latest', '1h', '2h', '5h', '1d', '3d', '5d', 'weekly', 'monthly', or custom date ranges), commit author, environment (e.g., 'production', 'staging', 'development'), or test case tags. Search commit messages (or an exact run counter when numeric) with 'search', and order results with 'sort'. Supports efficient pagination using page/limit or offset/limit. 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 failed runs from last hour.' The PAT should be configured in mcp.json as TESTDINO_PAT environment variable.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (default: 1). | |
| sort | No | Sort order for the run list: 'counter_desc' (newest first, default), 'counter_asc', 'duration_asc', or 'duration_desc'. | |
| limit | No | Number of results per page (default: 20, max: 1000). | |
| search | No | Search run commit messages, or match an exact run counter when the value is numeric. | |
| by_author | No | Filter by commit author name (exact match). | |
| by_branch | No | Filter by git branch name (e.g., 'main', 'develop', 'feature/login'). | |
| by_commit | No | Filter by git commit hash (full or partial). | |
| by_status | No | Filter by run status: 'passed', 'failed', 'interrupted', 'incomplete', or 'running'. | |
| projectId | Yes | Project ID (Required). The TestDino project identifier. | |
| by_environment | No | Filter by environment. Example: 'production', 'staging', 'development'. | |
| by_time_interval | No | Filter by time interval. Supports: 'Latest' (most recent, no time filter), '1h' (last hour), '2h' (last 2 hours), '5h' (last 5 hours), '12h' (last 12 hours), '1d' (last day), '3d' (last 3 days), '5d' (last 5 days), 'weekly' (last 7 days), 'monthly' (last 30 days), 'last 1 hour', 'last day', 'last 5 days', or '2024-01-01,2024-01-31' (date range). | |
| by_test_case_tags | No | Comma-separated test case tags contained in the run (exact match, include the '@' prefix if the tag has one, e.g. '@critical'). |