> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# get_test_cases

Retrieves test cases configured for an AI Agent. Supports listing all test cases, filtering by name, retrieving full details for a single test case, and grouping by channel.

## Example prompts

* "Show me all test cases on our Agent."
* "Find test cases whose name mentions 'refund'."
* "Group my test cases by channel so I can see Voice vs. Chat coverage."

## Parameters

| Parameter      | Type   | Description                                                         |
| -------------- | ------ | ------------------------------------------------------------------- |
| `test_case_id` | string | Optional. Return full details for a single test case.               |
| `name_filter`  | string | Optional. Case-insensitive substring match against test case names. |
| `group_by`     | string | Optional. Set to `channel` to group the response by channel.        |

## Response

When listing:

* Test case ID and name.
* Channel.
* Message.
* Evaluation criteria.
* Last-updated timestamp.

When requesting a single test case by ID, the full test case definition is returned including any expected outcomes and metadata.