list_test_cases
A project's test cases in the project's order, with reference, title, suite, kind, priority, automation, owner, status and last result, narrowed for a guest token; the steps come with get_test_case.
Return the test cases of one project: each with its reference (such as CRM-TC-45), title, the suite it is filed in, what it proves and what must be true before it starts, its kind and priority, whether a person or a script runs it and which test in the suite, how long it takes, who owns it, its status and the last result a run gave it. Read it to find the cases that cover a story before you implement it, to see which cases are still drafts or candidates for automation, and name cases by their reference when you report. The steps are left out of the list and come with get_test_case.
Optional filters narrow the page to one status, type, priority, automation_status or last_result, to the cases filed in one suite_id or owned by one owner_id, or to the cases whose reference, title, objective or automation reference contain search. A guest token reads the active cases only.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Annotations
It reads and never changes anything.
Arguments
project_id*stringUUID of the project whose test cases to list.
statusstringoptionalNarrow to one status.
draftin_reviewactivedeprecatedtypestringoptionalNarrow to one kind of check.
functionalregressionsmokesanityintegrationend_to_endapiperformancesecurityusabilityaccessibilityexploratoryprioritystringoptionalNarrow to one priority.
criticalhighmediumlowautomation_statusstringoptionalNarrow to how the cases are run.
manualcandidateautomateddeprecatedsuite_idstringoptionalNarrow to the cases filed in one suite, by its UUID.
owner_idstringoptionalNarrow to the cases one person owns, by their UUID.
last_resultstringoptionalNarrow to the cases whose last execution ended one way.
not_runpassedfailedblockedskippedretestsearchstringoptionalWords the reference, the title, the objective or the automation reference must contain.
limitintegeroptionalTest cases per page (1..100, default 25).
1max100pageintegeroptional1-indexed page number.
1What it returns
{ "data": [ { "id": "b7c8d9e0-f1a2-4b3c-8d4e-5f6a7b8c9d0e", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "suite_id": "a9b8c7d6-e5f4-4a3b-9c2d-1e0f9a8b7c6d", "suite_name": "Vouchers", "number": 45, "reference": "CRM-TC-45", "title": "Redeem an expired voucher at checkout", "objective": "<p>The checkout refuses a voucher past its date, says why and keeps the total.</p>", "preconditions": "<p>A member is signed in with an expired voucher in the wallet.</p>", "type": "functional", "priority": "high", "automation_status": "automated", "automation_ref": "tests/Feature/CheckoutTest::test_expired_voucher_is_refused", "estimated_minutes": 5, "owner_id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f", "owner_name": "Nimal Fernando", "status": "active", "test_data": "<p>Voucher <code>SPRING24</code>, expired on 31 March.</p>", "environment_requirements": "Staging with the voucher seed loaded", "last_result": "passed", "last_executed_at": "2026-11-10T14:20:00+00:00", "steps": [], "position": 44, "version": 1, "approved_at": "2026-11-05T15:00:00+00:00", "approved_revision_id": "f1a2b3c4-d5e6-4f7a-8b9c-0d1e2f3a4b5c", "created_at": "2026-11-04T09:20:00+00:00", "updated_at": "2026-11-10T14:20:00+00:00" } ], "meta": { "page": 1, "limit": 25, "total": 1, "has_more": false }}How it fails
RESOURCE_NOT_FOUNDunknown project_id, or a project outside the token's scope or the person's visibility.
VALIDATION_FAILEDstatus, type, priority, automation_status or last_result is not one of its values.
TOKEN_MISSING_ABILITYtoken lacks test-case:view-any.
How is this guide?
Last updated on