# mcp-vmanomaly Connects AI assistants to the vmanomaly REST API. It tunes anomaly detection models for VictoriaMetrics and produces alerting configurations. - MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11 - Author: VictoriaMetrics - License: Apache-2.0 · policy=link-only · description only; the file stays with the author - Source: https://github.com/VictoriaMetrics/mcp-vmanomaly - Updated: 2026-10-15 - HTML: https://affpapa.org/en/nevibecode/mcp/victoriametrics-mcp-vmanomaly ## What it does The server exposes `vmanomaly` REST endpoints to language models through the Model Context Protocol. It allows assistants to query engine health, inspect build metadata, and validate setups for univariate and multivariate detectors. Offline documentation search is also included via embedded docs. The tool samples time series data to suggest shared configurations across multiple metrics. It translates calculated anomaly scores into alerting rules for `vmalert` and produces deployment-ready YAML specs. A running `vmanomaly` instance is mandatory. Basic operations need version 1.28.3+, while autotuning and peer-group features require versions up to 1.31.0. Compiling the binary manually requires Go 1.26.9. ## Requirements - Needs: Docker - Environment variables: `VMANOMALY_ENDPOINT`, `VMANOMALY_BEARER_TOKEN`, `VMANOMALY_BEARER_TOKEN_FILE`, `VMANOMALY_HEADERS`, `MCP_SERVER_MODE`, `MCP_LISTEN_ADDR`, `MCP_LOG_LEVEL`, `MCP_LOG_FILE`, `MCP_ENABLED_TOOLS`, `MCP_DISABLED_TOOLS` — 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 VMANOMALY_ENDPOINT= --env VMANOMALY_BEARER_TOKEN= --env VMANOMALY_BEARER_TOKEN_FILE= --env VMANOMALY_HEADERS= --env MCP_SERVER_MODE= --transport stdio victoriametrics-mcp-vmanomaly -- docker run -i --rm -e VMANOMALY_ENDPOINT -e VMANOMALY_BEARER_TOKEN -e VMANOMALY_BEARER_TOKEN_FILE -e VMANOMALY_HEADERS -e MCP_SERVER_MODE ghcr.io/victoriametrics/mcp-vmanomaly:0.5.1 ``` Replace <…> with your own values. 7 more environment variables are in the server README ### Codex **Platform CLI** ```bash codex mcp add victoriametrics-mcp-vmanomaly --env VMANOMALY_ENDPOINT= --env VMANOMALY_BEARER_TOKEN= --env VMANOMALY_BEARER_TOKEN_FILE= --env VMANOMALY_HEADERS= --env MCP_SERVER_MODE= -- docker run -i --rm -e VMANOMALY_ENDPOINT -e VMANOMALY_BEARER_TOKEN -e VMANOMALY_BEARER_TOKEN_FILE -e VMANOMALY_HEADERS -e MCP_SERVER_MODE ghcr.io/victoriametrics/mcp-vmanomaly:0.5.1 ``` Replace <…> with your own values. 7 more environment variables are in the server README ### Cursor **Config file** File `.cursor/mcp.json`: ```json { "mcpServers": { "victoriametrics-mcp-vmanomaly": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "VMANOMALY_ENDPOINT", "-e", "VMANOMALY_BEARER_TOKEN", "-e", "VMANOMALY_BEARER_TOKEN_FILE", "-e", "VMANOMALY_HEADERS", "-e", "MCP_SERVER_MODE", "ghcr.io/victoriametrics/mcp-vmanomaly:0.5.1" ], "env": { "VMANOMALY_ENDPOINT": "", "VMANOMALY_BEARER_TOKEN": "", "VMANOMALY_BEARER_TOKEN_FILE": "", "VMANOMALY_HEADERS": "", "MCP_SERVER_MODE": "" } } } } ``` Replace <…> with your own values. 7 more environment variables are in the server README ### GitHub Copilot **Config file** File `.vscode/mcp.json`: ```json { "servers": { "victoriametrics-mcp-vmanomaly": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "-e", "VMANOMALY_ENDPOINT", "-e", "VMANOMALY_BEARER_TOKEN", "-e", "VMANOMALY_BEARER_TOKEN_FILE", "-e", "VMANOMALY_HEADERS", "-e", "MCP_SERVER_MODE", "ghcr.io/victoriametrics/mcp-vmanomaly:0.5.1" ], "env": { "VMANOMALY_ENDPOINT": "", "VMANOMALY_BEARER_TOKEN": "", "VMANOMALY_BEARER_TOKEN_FILE": "", "VMANOMALY_HEADERS": "", "MCP_SERVER_MODE": "" } } } } ``` Replace <…> with your own values. 7 more environment variables are in the server README ### Gemini CLI **Platform CLI** ```bash gemini mcp add -e VMANOMALY_ENDPOINT= -e VMANOMALY_BEARER_TOKEN= -e VMANOMALY_BEARER_TOKEN_FILE= -e VMANOMALY_HEADERS= -e MCP_SERVER_MODE= victoriametrics-mcp-vmanomaly docker run -i --rm -e VMANOMALY_ENDPOINT -e VMANOMALY_BEARER_TOKEN -e VMANOMALY_BEARER_TOKEN_FILE -e VMANOMALY_HEADERS -e MCP_SERVER_MODE ghcr.io/victoriametrics/mcp-vmanomaly:0.5.1 ``` Replace <…> with your own values. 7 more environment variables are in the server README ## When to use it - Generate YAML configurations for vmanomaly - Tune model parameters across multiple time series using autotune - Produce alerting rules for vmalert based on anomaly metrics - Search embedded vmanomaly documentation offline ## Example prompts - Check the health status and build info of my vmanomaly instance - Generate a vmalert alerting rule using anomaly score metrics for CPU usage - Profile these metric series and autotune a vmanomaly detection config ## Similar - [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989 - [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163 - [Oh My Posh Validator](https://affpapa.org/en/nevibecode/mcp/oh-my-posh-validator.md) — MCP server · ★ 23654 - [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779 - [Coder](https://affpapa.org/en/nevibecode/mcp/coder.md) — MCP server · ★ 17191 - [mcp](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — MCP server · ★ 12110 --- 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