Victoria Metrics

MCP server for VictoriaMetrics that provides comprehensive access to monitoring, observability, and debugging capabilities. Enables querying metrics, exploring data with visualizations, managing alerting/recording rules, analyzing cardinality, debugging queries, testing relabeling rules, and searching embedded documentation.

Features

• Query metrics using PromQL/MetricsQL (instant and range queries)
• List and explore metrics, labels, label values, and time series
• Analyze and test alerting and recording rules
• View instance parameters and cardinality statistics
• Debug relabeling rules, downsampling, and retention policies
• Integration with VictoriaMetrics Cloud
• Embedded documentation search (works offline)
• Support for both single-node and cluster deployments
• Multi-tenant support

Available Tools

Query & Exploration:

• query - Execute instant PromQL/MetricsQL queries
• query_range - Execute range queries over time periods
• metrics - List available metrics
• metrics_metadata - View stored metrics metadata (type, help, unit)
• labels - List available label names
• label_values - List values for specific labels
• series - List available time series
• export - Export raw time series data to JSON or CSV

Rules & Alerts:

• rules - View alerting and recording rules
• alerts - View current alerts (firing and pending)
• test_rules - Unit-test alerting and recording rules

Analysis & Debugging:

• active_queries - View currently executing queries
• top_queries - View most frequent or slowest queries
• tsdb_status - View TSDB cardinality statistics
• metric_statistics - Get metrics usage statistics
• prettify_query - Format PromQL/MetricsQL queries
• explain_query - Parse and explain queries
• metric_relabel_debug - Debug Prometheus-compatible relabeling rules
• downsampling_filters_debug - Debug downsampling configuration
• retention_filters_debug - Debug retention filters

Instance Management:

• flags - View non-default instance flags
• tenants - List available tenants in multi-tenant clusters
• documentation - Search embedded VictoriaMetrics documentation

VictoriaMetrics Cloud (when using VMC_API_KEY):

• deployments - List cloud deployments
• cloud_providers - List available cloud providers
• regions - List cloud provider regions
• tiers - List deployment tiers
• access_tokens - List deployment access tokens
• rule_filenames - List rule filenames
• rule_file - View rule file contents

Modes

Supports three transport modes:

• stdio - Standard input/output (default, for local clients)
• sse - Server-Sent Events (exposes /sse and /message endpoints)
• http - Streamable HTTP (exposes /mcp endpoint)

Public Demo

Try without installation using the public instance at https://play-mcp.victoriametrics.com/mcp (configured for VictoriaMetrics Playground).