← Explore all 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.

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

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.

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 ↗
  1. Build/verify the reviewed executable and replace its absolute path. Select either an instance endpoint/type or Cloud credentials, not both.
  2. Use the explicit disabled-tool list in the example; add a backend bearer token only through protected environment settings when required.
  3. 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"
      }
    }
  }
}

04 / FOLLOW THE EVIDENCE

The source trail.

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

  1. https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/1a9d356ee337a8f3a3389d371e8c8e67d2da54d9/cmd/mcp-victoriametrics/main.go

    Supports: summary, transports, install, configExample, access, limitations, bestFor, review, compatibility

  2. 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

  3. Apache-2.0 licence ↗Checked

    https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/1a9d356ee337a8f3a3389d371e8c8e67d2da54d9/LICENSE

    Supports: Redistribution terms, Copyright 2019-2025 VictoriaMetrics, Inc.

  4. https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/1a9d356ee337a8f3a3389d371e8c8e67d2da54d9/README.md

    Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports

Evidence & Ask