# mcp-victoriametrics Connects Claude Code to VictoriaMetrics instances for reading metrics, diagnosing alert rules, and querying embedded documentation. - MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 240 - Author: VictoriaMetrics - License: Apache-2.0 · policy=link-only · description only; the file stays with the author - Source: https://github.com/VictoriaMetrics/mcp-victoriametrics - Updated: 2026-10-24 - HTML: https://affpapa.org/en/nevibecode/mcp/victoriametrics-mcp-victoriametrics ## What it does This MCP server exposes read-only endpoints from VictoriaMetrics to your coding assistant. The model can inspect time series, review label values, check cardinality hotspots, and explain query execution plans. It also tests alerting rules and relabeling configs directly inside your chat session. The server bundles a complete copy of the official documentation, enabling offline searches when formulating queries. You need either a self-hosted single-node or cluster instance, or VictoriaMetrics Cloud credentials. Without a reachable `VM_INSTANCE_ENTRYPOINT`, tools cannot pull telemetry. If you just want to experiment, point your client at the public playground at `https://play-mcp.victoriametrics.com/mcp`. ## Requirements - Needs: Docker - Environment variables: `VM_INSTANCE_ENTRYPOINT`, `VM_INSTANCE_TYPE`, `VM_INSTANCE_BEARER_TOKEN`, `VMC_API_KEY`, `MCP_DISABLED_TOOLS`, `MCP_DISABLE_RESOURCES`, `MCP_PASSTHROUGH_HEADERS` — keys and tokens: ask the human for the values, never commit them or put them in shared files. ## Install ### Claude Code (native platform) **Platform CLI** ```bash claude mcp add --env VM_INSTANCE_ENTRYPOINT= --env VM_INSTANCE_TYPE= --env VM_INSTANCE_BEARER_TOKEN= --env VMC_API_KEY= --env MCP_DISABLED_TOOLS= --transport stdio victoriametrics-mcp-victoriametrics -- docker run -i --rm -e VM_INSTANCE_ENTRYPOINT -e VM_INSTANCE_TYPE -e VM_INSTANCE_BEARER_TOKEN -e VMC_API_KEY -e MCP_DISABLED_TOOLS ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1 ``` Replace <…> with your own values. 2 more environment variables are in the server README ### Codex **Platform CLI** ```bash codex mcp add victoriametrics-mcp-victoriametrics --env VM_INSTANCE_ENTRYPOINT= --env VM_INSTANCE_TYPE= --env VM_INSTANCE_BEARER_TOKEN= --env VMC_API_KEY= --env MCP_DISABLED_TOOLS= -- docker run -i --rm -e VM_INSTANCE_ENTRYPOINT -e VM_INSTANCE_TYPE -e VM_INSTANCE_BEARER_TOKEN -e VMC_API_KEY -e MCP_DISABLED_TOOLS ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1 ``` Replace <…> with your own values. 2 more environment variables are in the server README ### Cursor **Config file** File `.cursor/mcp.json`: ```json { "mcpServers": { "victoriametrics-mcp-victoriametrics": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "VM_INSTANCE_ENTRYPOINT", "-e", "VM_INSTANCE_TYPE", "-e", "VM_INSTANCE_BEARER_TOKEN", "-e", "VMC_API_KEY", "-e", "MCP_DISABLED_TOOLS", "ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1" ], "env": { "VM_INSTANCE_ENTRYPOINT": "", "VM_INSTANCE_TYPE": "", "VM_INSTANCE_BEARER_TOKEN": "", "VMC_API_KEY": "", "MCP_DISABLED_TOOLS": "" } } } } ``` Replace <…> with your own values. 2 more environment variables are in the server README ### GitHub Copilot **Config file** File `.vscode/mcp.json`: ```json { "servers": { "victoriametrics-mcp-victoriametrics": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "-e", "VM_INSTANCE_ENTRYPOINT", "-e", "VM_INSTANCE_TYPE", "-e", "VM_INSTANCE_BEARER_TOKEN", "-e", "VMC_API_KEY", "-e", "MCP_DISABLED_TOOLS", "ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1" ], "env": { "VM_INSTANCE_ENTRYPOINT": "", "VM_INSTANCE_TYPE": "", "VM_INSTANCE_BEARER_TOKEN": "", "VMC_API_KEY": "", "MCP_DISABLED_TOOLS": "" } } } } ``` Replace <…> with your own values. 2 more environment variables are in the server README ### Gemini CLI **Platform CLI** ```bash gemini mcp add -e VM_INSTANCE_ENTRYPOINT= -e VM_INSTANCE_TYPE= -e VM_INSTANCE_BEARER_TOKEN= -e VMC_API_KEY= -e MCP_DISABLED_TOOLS= victoriametrics-mcp-victoriametrics docker run -i --rm -e VM_INSTANCE_ENTRYPOINT -e VM_INSTANCE_TYPE -e VM_INSTANCE_BEARER_TOKEN -e VMC_API_KEY -e MCP_DISABLED_TOOLS ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1 ``` Replace <…> with your own values. 2 more environment variables are in the server README ## When to use it - Run read-only metric queries and inspect time series - Evaluate label cardinality and monitor metric usage - Verify alerting rules and debug relabeling policies - Search VictoriaMetrics documentation without internet access ## Example prompts - Check the highest cardinality labels in our VictoriaMetrics cluster - Explain why this alerting rule failed and suggest query fixes - Search embedded docs for downsampling retention parameters ## Similar - [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918 - [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115 - [Oh My Posh Validator](https://affpapa.org/en/nevibecode/mcp/oh-my-posh-validator.md) — MCP server · ★ 23643 - [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727 - [Coder](https://affpapa.org/en/nevibecode/mcp/coder.md) — MCP server · ★ 17160 - [mcp](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — MCP server · ★ 12109 --- NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md