Insights TestRail summary
insights_testrail_summaryPre-aggregated TestRail results, identical to what the Insights dashboard shows. USE THIS for any TestRail pass-rate, failure-count, run-comparison or "how is milestone X going" question or chart — never tally testrail_list_tests_for_run rows yourself. Pick ONE view: runs = specific run ids (1-10): per-run counts + pass rates, what changed vs each run's previous run, and, for 2+ runs, a combined rollup (counts are summed; a case present in two runs is counted twice) with the top failure signatures. project_runs = the newest runs of a project (optionally one milestone): per-run counts for a pass-rate-per-run chart, plus combined when the list is 2-10 runs. To COMPARE two runs/milestones, call this once per side and compare the numbers; do not mix sides in one call. Counts are per status: passed, failed, blocked, retest, untested (total = their sum). pass_rate_executed_pct = passed / (passed + failed + blocked + retest), so untested tests are EXCLUDED and a half-run suite can look better than it is; pass_rate_total_pct = passed / total, so untested tests count against it. Both are null when the denominator is 0. State which one you quote, and use the same one on both sides of a comparison. Per-run delta counts tests that newly failed / recovered / still fail compared with the run before it. Chart the per-run rows with an ra-chart block (add source with this tool, your exact params and the series mapping, e.g. path runs, label name, value pass_rate_executed_pct, so the user can pin it), and give the user the dashboard_url as a markdown link (use insights_build_link instead when you need a status filter). Read-only; needs TestRail connected in Settings > Integrations.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| view | Yes | `runs` needs runIds. `project_runs` needs projectId (milestoneId optional). | |
| fresh | No | Bypass the short-lived cache. Only set when the user says results just changed. | |
| limit | No | project_runs only: how many newest runs to return (default 20, max 50). | |
| runIds | No | TestRail run ids (view=runs). | |
| projectId | No | TestRail project id (view=project_runs). Find it with insights_testrail_browse. | |
| milestoneId | No | Restrict project_runs to one milestone. Find it with insights_testrail_browse. |