# VictoriaMetrics MCP
> VictoriaMetrics' official MCP server exposes selected metrics queries, metadata, alerting information, and embedded documentation for a configured VictoriaMetrics instance or VictoriaMetrics Cloud deployment.
Canonical: https://www.mcpfolio.com/servers/victoriametrics-mcp
Last updated: 2026-10-28
## Catalog record

- Publisher: VictoriaMetrics (official)
- Categories: search, cloud-service

## Website

https://victoriametrics.com/

## Repository

https://github.com/VictoriaMetrics/mcp-victoriametrics

## Transports

stdio by default; optional SSE and Streamable HTTP.

## Authentication

A self-hosted instance may use an optional bearer token or custom headers; VictoriaMetrics Cloud requires a VMC_API_KEY. The documented public playground endpoint is configured against the public VictoriaMetrics playground; no user credential is listed for that demo endpoint.

## Tools

- **query**: Execute an instant PromQL or MetricsQL query.
- **query_range**: Execute a range query over a time period.
- **metrics**: List metrics available in the configured instance.
- **metrics_metadata**: Read stored metric type, help, and unit metadata.
- **labels**: List available label names.
- **label_values**: List values for a selected label.
- **series**: List available time series.
- **rules**: View alerting and recording rules.
- **alerts**: View firing and pending alerts.
- **documentation**: Search embedded VictoriaMetrics documentation.
- **prettify_query**: Format PromQL or MetricsQL query text.
- **explain_query**: Parse a query and explain how it works.

## Sources

- [official_repository_documentation](https://github.com/VictoriaMetrics/mcp-victoriametrics)
- [official_source_runtime_metadata](https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/main/go.mod)
- [verified_publisher_organization_avatar](https://github.com/VictoriaMetrics.png?size=300)
- [discovery_directory](https://awesome-mcp.tools/)
- [official_or_maintainer_tool_reference](https://github.com/VictoriaMetrics/mcp-victoriametrics)

## Setup

Use the interactive setup panel on [the detail page](https://www.mcpfolio.com/servers/victoriametrics-mcp) to view instructions for each supported client.