VictoriaMetrics MCP

Query VictoriaMetrics: MetricsQL, series, alerts, and docs search.

By defaultRead-only
With our presetSame: read-only is built in

Labels are provisional (from the project README/docs, checked Oct 27, 2026). Not yet tested in our sandbox.

Read-only switch

README: covers "almost all read-only APIs of VMUI".

Preset

Read-onlyThe docs say it only reads, so there's no flag to add. Not sandbox-tested yet.
  • Matched by name only. VictoriaMetrics MCP is documented as read-only, but a fork or another server with the same name might not be. So Codex still prompts and Claude Code asks.

Claude Code

.mcp.json
{
  "mcpServers": {
    "victoriametrics": {
      "command": "/path/to/mcp-victoriametrics",
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<YOUR_VM_INSTANCE>",
        "VM_INSTANCE_TYPE": "single",
        "VM_INSTANCE_BEARER_TOKEN": "${VM_BEARER_TOKEN}"
      }
    }
  }
}
.claude/settings.json
{
  "permissions": {
    "ask": ["mcp__victoriametrics"]
  }
}

ask makes Claude Code prompt before every tool from this server.

Codex

~/.codex/config.toml
# Generated by redpresets.dev on 2026-11-03. Unverified preset. Also use a read-only credential. Not a security guarantee.

[mcp_servers.victoriametrics]
# export VM_INSTANCE_BEARER_TOKEN (your mcp.json read it from ${VM_BEARER_TOKEN})
command = "/path/to/mcp-victoriametrics"
env_vars = ["VM_INSTANCE_BEARER_TOKEN"]
default_tools_approval_mode = "prompt"

[mcp_servers.victoriametrics.env]
VM_INSTANCE_ENTRYPOINT = "<YOUR_VM_INSTANCE>"
VM_INSTANCE_TYPE = "single"

default_tools_approval_mode = "prompt" asks before every tool call.

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "victoriametrics": {
      "type": "stdio",
      "command": "/path/to/mcp-victoriametrics",
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<YOUR_VM_INSTANCE>",
        "VM_INSTANCE_TYPE": "single",
        "VM_INSTANCE_BEARER_TOKEN": "${env:VM_BEARER_TOKEN}"
      }
    }
  }
}

Don't add write tools to mcpAllowlist in .cursor/permissions.json. Leave them on approval. Cursor's docs say the allowlist is not a security boundary.

Credential layer

Use a read-only vmauth user.

Facts

Vendor
VictoriaMetrics official
Source
VictoriaMetrics/mcp-victoriametrics
License
Apache-2.0
GitHub stars
240
Latest release
v1.20.2 (Apr 15, 2026)
Last push
Oct 25, 2026
Status
Active
Last checked
Oct 27, 2026

Sources

  • README · checked Oct 27, 2026

Spotted something wrong? Labels change when vendors change. Suggest a correction

Read-only alternatives in Observability