Mcp Victoriametrics
Connects Claude to VictoriaMetrics instances through their read-only APIs, letting you query metrics, explore cardinality, test alerting rules, and debug configurations without leaving your chat. Wraps the full VMUI functionality including PromQL querying, label exploration, and retention policy debugging. Works with both self-hosted VictoriaMetrics and VictoriaMetrics Cloud. Includes embedded documentation search so you can reference VictoriaMetrics docs inline. Supports both stdio and HTTP modes, with a public demo instance available for testing. Essential if you're already using VictoriaMetrics for observability and want to troubleshoot or explore your metrics through natural language queries.
- GitHub stars
- 179
- tools
- 30
- auth
- Secret needed
- transport
- STDIO
- env vars
- 7
- last updated
- Mar 19, 2026
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)
MCP_PASSTHROUGH_HEADERSHTTP header names to forward from incoming MCP requests to VictoriaMetrics (comma-separated list). Overrides VM_INSTANCE_HEADERS on collision.
Readme
Details
- Repository
- github.com/victoriametrics/mcp-victoriametrics
- Package
ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active