---
title: "list_tests"
description: "List test scenarios."
sidebarTitle: "list_tests"
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

{/* GENERATED FILE: do not edit by hand. Regenerate with: node scripts/generate.mjs */}

List test scenarios.

<Note>
  **Read-only · Calls external systems.** Safe to call: this tool does not modify data.
</Note>

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `archived` | boolean | No | Filter by archived status |
| `detail` | boolean | No | Return full JSON instead of compact summaries (default: false) |
| `name` | string | No | Filter by test name |
| `operator` | string | No | Filter by operator slug |
| `ordering` | string | No | Sort order (e.g. 'name', '-name', 'id', '-id') |
| `page` | number | No | Page number (default: 1) |
| `page_size` | number | No | Number of tests to return per page (default: 20) |
| `product` | string | No | Filter by product slug (format: operator~product) |
| `tags` | string | No | Filter by tags (comma-separated) |

## Example arguments

Illustrative arguments an agent supplies when calling this tool:

```json
{
  "archived": false,
  "detail": false
}
```

## Description

```text
Returns compact summaries by default; use detail=true for full JSON. List test scenarios. Tests belong to a product and can be executed via campaigns.

Flat discovery: returns all tests in a product (paginated, filterable by name/tag/status). For folder-based browsing, use list_collections → list_collection_items instead.
```

## Related

- [`list_collections`](/mcp/tools/collections/list_collections)
- [`list_collection_items`](/mcp/tools/collections/list_collection_items)

## What's next?

<Columns cols={2}>
  <Card title="All MCP tools" icon="robot" href="/mcp/tools/overview">
    Browse the full tool reference by category.
  </Card>
  <Card title="Connect a client" icon="plug" href="/mcp/connect">
    Point Claude, Cursor, or Claude Code at the server.
  </Card>
</Columns>