---
title: "list_test_campaigns"
description: "List Tests campaigns accessible with the current API key."
sidebarTitle: "list_test_campaigns"
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 Tests campaigns accessible with the current API key.

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

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `creator` | string | No | Filter by creator user id(s), comma-separated |
| `detail` | boolean | No | Return full JSON instead of compact one-liners (default: false) |
| `ids` | string | No | Comma-separated Tests campaign ids |
| `page` | number | No | Page number (default 1) |
| `page_size` | number | No | Items per page (default 50, max 4000) |
| `product` | string | No | Filter by product slug or short_name (comma-separated list also accepted) |

## Example arguments

Illustrative arguments an agent supplies when calling this tool:

```json
{
  "creator": "string",
  "detail": false
}
```

## Description

```text
A Tests campaign is a SAVED, ordered pack of tests attached to a single product — use it to group regression scenarios, smoke packs, or anything you run as one unit. To run one: build_campaign(test_campaign_id=<id>) → run_campaign(overrides=…).

Returns compact one-liners by default (`"#42 Regression pack [8 tests, valid]"`). detail=true returns the full Tests campaign including the test_list.
```

## Related

- [`build_campaign`](/mcp/tools/execution/build_campaign)
- [`run_campaign`](/mcp/tools/execution/run_campaign)

## 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>