---
title: "VictoriaMetrics MCP server: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/victoriametrics/
description: "MetricsQL and metadata reads against one VictoriaMetrics instance. Export, flags, three debug tools, and test_rules stay off unless the disable list is replaced."
---

# VictoriaMetrics MCP server: review, setup & limitations · Undominated.ai

> MetricsQL and metadata reads against one VictoriaMetrics instance. Export, flags, three debug tools, and test_rules stay off unless the disable list is replaced.

[← Explore all mcp servers](/mcp-servers/)

METRICS / VictoriaMetrics

# VictoriaMetrics MCP server

MetricsQL and metadata reads against one VictoriaMetrics instance. Export, flags, three debug tools, and test_rules stay off unless the disable list is replaced.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/VictoriaMetrics/mcp-victoriametrics)

SOURCE REVIEW

 Reviewed 2026-10-14
 Evidence 4 linked sources
 Publisher VictoriaMetrics
 Licence [Apache-2.0 ↗](https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/1a9d356ee337a8f3a3389d371e8c8e67d2da54d9/LICENSE)
 Revision 1a9d356ee337
 [Read what was—and wasn’t—checked ↓](#review)

“MCP server for VictoriaMetrics and VictoriaMetrics Cloud. Empty MCP_SERVER_MODE becomes stdio. SSE and streamable HTTP are separate modes.”

 [VictoriaMetrics · upstream description ↗](https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/1a9d356ee337a8f3a3389d371e8c8e67d2da54d9/cmd/mcp-victoriametrics/main.go) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - When MCP_DISABLED_TOOLS is unset, the disabled set is export, flags, metric_relabel_debug, downsampling_filters_debug, retention_filters_debug, and test_rules. Each of those registrations returns before AddTool while disabled.
- CreateSelectRequest and CreateAdminRequest both use HTTP GET. The opened query, range, rules, alerts, labels, series, and status handlers call one of those helpers.

### A good fit for

 - Investigate MetricsQL results and cardinality against an explicitly selected single-node or cluster deployment.
- Inspect rule/query behavior with restricted tools before enabling high-volume export or local rule testing.

### Weigh up before choosing

 - Setting MCP_DISABLED_TOOLS to an empty string counts as set, and the default disable list is then not applied, so test_rules registers. test_rules is annotated ReadOnlyHint true and writes rule files under a temp directory, then removes that directory.
- access_tokens calls ListDeploymentAccessTokens when VMC_API_KEY is set. The cloud client was not opened, so the HTTP verb and whether the payload contains secret material were not checked. VM_INSTANCE_ENTRYPOINT and VMC_API_KEY cannot both be set. Default mode is stdio. SSE and HTTP listen on localhost:8080 when no address is set. HTTP mounts /mcp. The server was not started. No release tag was checked.
- MCP_PASSTHROUGH_HEADERS and VM_INSTANCE_HEADERS can forward or add backend headers. A shared server needs deliberate identity handling; stdio alone does not prevent reads allowed by its credential.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - cmd/mcp-victoriametrics/config/config.go
- cmd/mcp-victoriametrics/main.go
- cmd/mcp-victoriametrics/tools/utils.go
- cmd/mcp-victoriametrics/tools/test_rules.go
- cmd/mcp-victoriametrics/tools/query.go
- cmd/mcp-victoriametrics/tools/access_tokens.go
- LICENSE
- 2026-10-14 reread of retained pinned setup/configuration evidence for the specific operational details added in this batch.
- README.md

### Our findings

 - The Apache appendix says Copyright 2019-2025 VictoriaMetrics, Inc.
- metrics calls getLabelValues, which builds a GET to /api/v1/label/{name}/values. documentation searches local doc resources. Those resource function bodies were not opened.
- README supplies exact instance/cloud alternatives, supported transports, outgoing-header controls and default disabled-tool names. The example makes the default exclusions explicit without claiming a universal read-only boundary.

### Not established by this review

 - The server was not started.
- No MetricsQL query was sent.
- The cloud client package was not opened.
- No authenticated session, installation, permission bypass or package-to-source parity test was performed.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/1a9d356ee337a8f3a3389d371e8c8e67d2da54d9/cmd/mcp-victoriametrics/main.go)
 - Build/verify the reviewed executable and replace its absolute path. Select either an instance endpoint/type or Cloud credentials, not both.
- Use the explicit disabled-tool list in the example; add a backend bearer token only through protected environment settings when required.
- For shared HTTP mode review request-header passthrough and configured outgoing headers before exposing the server; these affect backend identity and data access.

### Before you start

 - Go toolchain
- Either VM_INSTANCE_ENTRYPOINT plus VM_INSTANCE_TYPE, or VMC_API_KEY, not both

### Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

 {
 "mcpServers": {
 "victoriametrics": {
 "command": "/absolute/path/mcp-victoriametrics",
 "args": [],
 "env": {
 "VM_INSTANCE_ENTRYPOINT": "http://127.0.0.1:8428",
 "VM_INSTANCE_TYPE": "single",
 "MCP_SERVER_MODE": "stdio",
 "MCP_DISABLED_TOOLS": "export,flags,metric_relabel_debug,downsampling_filters_debug,retention_filters_debug,test_rules"
 }
 }
 }
} Copy configuration ↗

### Compatibility

MCP stdio clients · MCP SSE clients · MCP Streamable HTTP clients

### Implementation

Go

### Transports

stdio · SSE · Streamable HTTP

### Reads a configured VictoriaMetrics instance. test_rules writes temp files and is off by default.

 - HTTP GET to the configured instance for the opened select and admin helpers
- List cloud deployments and access tokens only when a cloud API key is set

### Cost model

Apache-2.0 source at no charge. Copyright 2019-2025 VictoriaMetrics, Inc. Queries use the instance whose address or API key you supply.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Server entry and tool registration ↗](https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/1a9d356ee337a8f3a3389d371e8c8e67d2da54d9/cmd/mcp-victoriametrics/main.go) Checked 2026-10-14 https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/1a9d356ee337a8f3a3389d371e8c8e67d2da54d9/cmd/mcp-victoriametrics/main.go Supports: summary, transports, install, configExample, access, limitations, bestFor, review, compatibility
- [Disable list and mode defaults ↗](https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/1a9d356ee337a8f3a3389d371e8c8e67d2da54d9/cmd/mcp-victoriametrics/config/config.go) Checked 2026-10-14 https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/1a9d356ee337a8f3a3389d371e8c8e67d2da54d9/cmd/mcp-victoriametrics/config/config.go Supports: default disabled tools, stdio default, summary, install, configExample, access, limitations, bestFor, review, compatibility, transports
- [Apache-2.0 licence ↗](https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/1a9d356ee337a8f3a3389d371e8c8e67d2da54d9/LICENSE) Checked 2026-10-07 https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/1a9d356ee337a8f3a3389d371e8c8e67d2da54d9/LICENSE Supports: Redistribution terms, Copyright 2019-2025 VictoriaMetrics, Inc.
- [Additional pinned implementation/setup review: README.md ↗](https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/1a9d356ee337a8f3a3389d371e8c8e67d2da54d9/README.md) Checked 2026-10-14 https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/1a9d356ee337a8f3a3389d371e8c8e67d2da54d9/README.md Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Prometheus MCP server ↗ Prometheus project's MCP server. The default tool set includes config reload and process quit. TSDB delete tools error unless a dangerous flag is set.](/mcp-servers/prometheus/)[### Axiom MCP ↗ Queries Axiom telemetry and manages observability resources through an account-authorized hosted connection.](/mcp-servers/axiom/)[### Datadog MCP ↗ Query Datadog telemetry and operate permitted monitoring resources from an authenticated AI client.](/mcp-servers/datadog/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
