---
title: "search_collections"
description: "Search across collections and items (tests + dashboards) under a collection sub-tree."
sidebarTitle: "search_collections"
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 */}

Search across collections and items (tests + dashboards) under a collection sub-tree.

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

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `collection_uid` | string | Yes | Scope the search to this collection sub-tree (typically a product's tests_root_collection_uid) |
| `detail` | boolean | No | Return full JSON instead of compact one-liners (default: false) |
| `operator` | string | Yes | Operator slug (supplies org-id) |
| `owner_id` | number | No | Filter by owner user id |
| `query` | string | No | Free-text search (matches name and metadata) |
| `tags` | string | No | Comma-separated tag IDs |

## Example arguments

Illustrative arguments an agent supplies when calling this tool:

```json
{
  "operator": "string",
  "collection_uid": "string"
}
```

## Description

```text
Search requires a collection_uid to scope to a sub-tree — pass the product's tests_root_collection_uid or any sub-collection UID. Returns a payload with two arrays: collections and 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>