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

# list_metric_catalog

> Every analytics metric slug supported by query_ad_metrics et al, scoped to what this space actually uses.

Enumerates every metric the analytics tools accept, with a short type tag and (for `custom_event_*` metrics) the configured human label. Call this before `query_ad_metrics` whenever you're unsure of the canonical slug — saves a `[validation_error]` round-trip on misspellings.

## When to use

* Before composing a `query_ad_metrics` / `query_metric_breakdown` / `query_ad_metrics_compare` call when you're not certain a metric slug exists.
* To enumerate everything the user can ask for ("what metrics are available?").

## Parameters

| Parameter        | Type    | Required | Description                                                                  |
| ---------------- | ------- | -------- | ---------------------------------------------------------------------------- |
| `format`         | string  | No       | `csv` (default), `json`, or `yaml`.                                          |
| `include_unused` | boolean | No       | Include `custom_event_*` slots without a configured label (default `false`). |

## Output

```csv theme={null}
slug,category,label
amount_spent,ad,
purchase,conversion,
purchase_amount,conversion_amount,
roas,ad,
cost_per_purchase,cost_per_conversion,
custom_event_2,custom_event,Deal Created
cost_per_custom_event_2,cost_per_custom_event,Deal Created
custom_event_2_amount,custom_event_amount,Deal Created
```

`category` is one of: `analytics`, `ad`, `meta`, `tiktok`, `linkedin`, `microsoft`, `conversion`, `cost_per_conversion`, `conversion_amount`, `conversion_roas`, `custom_event`, `cost_per_custom_event`, `custom_event_amount`, `custom_event_roas`.

## Related

* The `cometly://catalog/metrics` MCP Resource serves the same data.
* For user-defined metric formulas, see [`list_user_defined_metrics`](/mcp/tools/list-user-defined-metrics).