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