Prometheus: List Metrics
prometheus_list_metricsFind Prometheus metric names by substring across names and help text, returning type and help. Use it to discover metrics before writing a PromQL query.
Instructions
Find metric names, with their type (counter, gauge, histogram, summary) and help text. search matches the name or the help text, so disk finds node_filesystem_avail_bytes by its description. Use this before writing a query against a metric you have not seen, then prometheus_describe_metric for its labels. Counters need rate() or increase(); summing a raw counter is the most common PromQL mistake.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "prometheus_list_metrics"
}
}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. | |
| limit | No | Maximum metrics to return (1-1000). Defaults to 100. | |
| 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`. | |
| metadata | No | Include type and help per metric. false returns bare names, about a fifth the size. |