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.
- 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"
}
}
}
} 04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/1a9d356ee337a8f3a3389d371e8c8e67d2da54d9/cmd/mcp-victoriametrics/main.go
Supports: summary, transports, install, configExample, access, limitations, bestFor, review, compatibility
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 ↗Checked
https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/1a9d356ee337a8f3a3389d371e8c8e67d2da54d9/LICENSE
Supports: Redistribution terms, Copyright 2019-2025 VictoriaMetrics, Inc.
https://github.com/VictoriaMetrics/mcp-victoriametrics/blob/1a9d356ee337a8f3a3389d371e8c8e67d2da54d9/README.md
Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports