Mcp Victoriametrics
Connects Claude directly to your VictoriaMetrics instance through its read-only APIs. You get the full query interface for exploring metrics, labels, and series, plus tools for analyzing alerting rules, tracing PromQL queries, and debugging relabeling configurations. Works with both single-node and cluster deployments, including VictoriaMetrics Cloud. The server bundles the complete VictoriaMetrics documentation for offline search, so you can ask about cardinality analysis or retention policies without leaving your conversation. Supports stdio and HTTP transports. Useful when you're already using VictoriaMetrics for observability and want to query, troubleshoot, or explore your monitoring data without switching contexts.
- GitHub stars
- 179
- tools
- 30
- auth
- Secret needed
- transport
- STDIO
- env vars
- 6
- last updated
- Dec 15, 2025
Tools
30 toolsPublic tool metadata for what this MCP can expose to an agent.
active_queriesActive queries
Active queries
No parameter schema in public metadata yet.
alertsList of alerts
List of alerts
No parameter schema in public metadata yet.
documentationSearch documentation resources
Search documentation resources
No parameter schema in public metadata yet.
downsampling_filters_debugDownsampling filters debugger
Downsampling filters debugger
No parameter schema in public metadata yet.
explain_queryExplain Query
Explain Query
No parameter schema in public metadata yet.
exportExport time series
Export time series
No parameter schema in public metadata yet.
flagsList of non-default flags (parameters)
List of non-default flags (parameters)
No parameter schema in public metadata yet.
label_valuesList of label values
List of label values
No parameter schema in public metadata yet.
labelsList of label names
List of label names
No parameter schema in public metadata yet.
metric_relabel_debugMetric relabel debugger
Metric relabel debugger
No parameter schema in public metadata yet.
metric_statisticsMetric statistics
Metric statistics
No parameter schema in public metadata yet.
metricsList of metric names
List of metric names
No parameter schema in public metadata yet.
metrics_metadataList of metrics metadata (name, type, help and unit)
List of metrics metadata (name, type, help and unit)
No parameter schema in public metadata yet.
prettify_queryPrettify Query
Prettify Query
No parameter schema in public metadata yet.
queryInstant Query
Instant Query
No parameter schema in public metadata yet.
query_rangeRange Query
Range Query
No parameter schema in public metadata yet.
retention_filters_debugRetention filters debugger
Retention filters debugger
No parameter schema in public metadata yet.
rulesList of alerting and recording rules
List of alerting and recording rules
No parameter schema in public metadata yet.
seriesList of time series
List of time series
No parameter schema in public metadata yet.
tenantsList of tenants (cluster mode only)
List of tenants (cluster mode only)
No parameter schema in public metadata yet.
test_rulesUnit test rules
Unit test rules
No parameter schema in public metadata yet.
top_queriesTop queries
Top queries
No parameter schema in public metadata yet.
tsdb_statusTSDB Stats (information about cardinality of the data)
TSDB Stats (information about cardinality of the data)
No parameter schema in public metadata yet.
access_tokensList of deployment access tokens
List of deployment access tokens
No parameter schema in public metadata yet.
cloud_providersList of cloud providers
List of cloud providers
No parameter schema in public metadata yet.
deploymentsList of deployments
List of deployments
No parameter schema in public metadata yet.
regionsList of regions
List of regions
No parameter schema in public metadata yet.
rule_fileGet rules file content
Get rules file content
No parameter schema in public metadata yet.
rule_filenamesList of filenames of alerting and recording rules
List of filenames of alerting and recording rules
No parameter schema in public metadata yet.
tiersList of tiers
List of tiers
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
VM_INSTANCE_ENTRYPOINT*URL to VictoriaMetrics instance (it should be root URL of vmsingle or vmselect), for example http://localhost:8428 or https://play.victoriametrics.com
VM_INSTANCE_TYPE*Type of VictoriaMetrics instance (single / cluster)
VM_INSTANCE_BEARER_TOKEN*secretAuthentication token for VictoriaMetrics API
VMC_API_KEYsecretOptional: API key from VictoriaMetrics Cloud Console (if you have deployment in VictoriaMetrics Cloud)
MCP_DISABLED_TOOLSComma-separated list of tools to disable
MCP_DISABLE_RESOURCESDisable all resources (documentation tool will continue to work)
Readme
Details
- Repository
- github.com/victoriametrics-community/mcp-victoriametrics
- Package
ghcr.io/victoriametrics-community/mcp-victoriametrics:1.18.0- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active