Prometheus: List Label Values
prometheus_list_label_valuesLists every value a Prometheus label takes, optionally restricted to series matching a selector. Use it to fetch exact label values before filtering metrics instead of guessing regexes.
Instructions
List the values one label takes — every namespace, job or instance — optionally only on series matching a selector (e.g. the pods of one deployment). Use it to get exact values right before filtering on them, instead of guessing at a regex.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"label": "<label>"
},
"name": "prometheus_list_label_values"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Only consider series with samples before this: now, now-1h, -30m, an RFC3339 timestamp (2026-01-31T12:00:00Z) or unix seconds. Defaults to now. | |
| label | Yes | Label name, e.g. `namespace`, `job`, or `__name__` for metric names. | |
| limit | No | Maximum values to return (1-5000). Defaults to 200. | |
| match | No | A series selector to restrict to, e.g. `{namespace="monitoring"}` or `up{job=~"kube.*"}`. A selector only — no functions or operators. An empty matcher set `{}` is rejected by Prometheus; use at least one non-empty matcher such as `{job=~".+"}`. | |
| start | No | Only consider series with samples after this: now, now-1h, -30m, an RFC3339 timestamp (2026-01-31T12:00:00Z) or unix seconds. Defaults to an hour before end (now-1h when end is not given), i.e. series that exist now. Pass now-30d to include ones that have since gone away. | |
| search | No | Case-insensitive substring to filter by, e.g. `http`. |