> ## 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`](https://docs.cometly.com/mcp/tools/list-user-defined-metrics).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.