Mcp Vmanomaly
Wire vmanomaly into your agent so you can inspect anomaly detection results and API behavior without manually hitting the vmanomaly HTTP endpoint.
Overview
mcp-vmanomaly is an Operate-phase MCP server that connects AI agents to the VictoriaMetrics vmanomaly anomaly-detection HTTP API.
What is this MCP server?
- Beta MCP server 0.1.0-beta.2 for VictoriaMetrics vmanomaly anomaly detection
- VMANOMALY_ENDPOINT required (e.g. http://localhost:8490) with optional VMANOMALY_BEARER_TOKEN
- Custom headers via VMANOMALY_HEADERS (comma-separated key=value pairs)
- MCP_SERVER_MODE supports stdio (default), sse, or http with MCP_LISTEN_ADDR for remote modes
- OCI image ghcr.io/victoriametrics-community/mcp-vmanomaly for registry install
- Version 0.1.0-beta.2 in server metadata
- Three MCP_SERVER_MODE values documented: stdio, sse, http
- Default MCP_LISTEN_ADDR example localhost:8080 for SSE/HTTP modes
Community signal: 8 GitHub stars.
What problem does it solve?
Interpreting vmanomaly alerts still means juggling the anomaly UI and your editor because agents cannot call your vmanomaly endpoint by default.
Who is it for?
Operators running vmanomaly on top of VictoriaMetrics who want agent-assisted review of anomaly detection during incidents or tuning cycles.
Skip if: Builders without a vmanomaly deployment, or anyone who only needs raw metrics or logs without anomaly services.
What do I get? / Deliverables
With endpoint, auth, and transport configured, your agent can work with vmanomaly API responses while you adjust metrics pipelines or application fixes.
- MCP tools backed by vmanomaly API
- Configurable transport (stdio, sse, or http)
- Agent-ready anomaly investigation alongside your codebase
Recommended MCP Servers
Journey fit
Anomaly detection runs against production signals—Operate is where you act on outliers, not where you first ideate features. Monitoring subphase fits ML-assisted alert and anomaly workflows atop VictoriaMetrics metrics pipelines.
How it compares
Anomaly-detection API MCP, not a general metrics MCP (mcp-victoriametrics) or hosted APM product.
Common Questions / FAQ
Who is mcp-vmanomaly for?
Solo builders and small teams using VictoriaMetrics vmanomaly who want MCP access from Claude Code, Cursor, or similar agents.
When should I use mcp-vmanomaly?
Use it during Operate when investigating automated anomaly findings, validating detection behavior, or coordinating fixes with metrics context.
How do I add mcp-vmanomaly to my agent?
Run the OCI MCP package, set VMANOMALY_ENDPOINT (and token or headers if required), pick MCP_SERVER_MODE stdio/sse/http, add the server to your agent MCP list, and restart.