> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cometly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# search_cometly_docs

> Lightweight substring search across Cometly's product documentation.

Grep-style search over the same MDX content you're reading now. Use when the user asks "how does Cometly handle X?" or "what does Y mean?" rather than guessing — the docs are the source of truth for product behavior and naming.

## When to use

* "How does Cometly define a conversion?" → search "conversion".
* "What does the linear attribution model mean?" → search "linear".
* "Can I export my contacts?" → search "export".

For *data* about THIS space, use the analytics / events / contacts tools instead.

## Parameters

| Parameter | Type    | Required | Description                                                            |
| --------- | ------- | -------- | ---------------------------------------------------------------------- |
| `query`   | string  | Yes      | Search terms (case-insensitive substring match). Minimum 2 characters. |
| `limit`   | integer | No       | Max results (1–20, default 5).                                         |
| `format`  | string  | No       | `json` (default), `csv`, or `yaml`.                                    |

## Output

```json theme={null}
[
  {
    "path":    "publicApiDocs/V1/mcp/tools/query-ad-metrics.mdx",
    "title":   "query_ad_metrics",
    "snippet": "...the Cometly report builder...attribution_window: 0 means LTV — the model is instructed to refer to it as..."
  }
]
```

`snippet` is a ±200-character window around the match.