victoriametrics-community avatar

Mcp Vmanomaly

victoriametrics-community/mcp-vmanomaly

Connects Claude directly to VictoriaMetrics' vmanomaly REST API for anomaly detection workflows. You get health checks, model management for algorithms like zscore_online and prophet, YAML config generation, and alert rule creation based on anomaly scores. The server embeds the full vmanomaly docs with fuzzy search, so you can query configuration details without leaving your conversation. Reach for this when you're building observability pipelines and want to prototype anomaly detection models, tune thresholds, or generate vmalert rules conversationally instead of writing YAML by hand. Requires vmanomaly 1.28.3 or later running somewhere accessible.

GitHub stars
8
tools
19
auth
Secret needed
transport
STDIO
env vars
10
last updated
Dec 17, 2025

Tools

19 tools

Public tool metadata for what this MCP can expose to an agent.

vmanomaly_health_checkCheck vmanomaly server health status

Check vmanomaly server health status

No parameter schema in public metadata yet.

vmanomaly_get_buildinfoGet build information (version, build time, Go version)

Get build information (version, build time, Go version)

No parameter schema in public metadata yet.

vmanomaly_get_server_queriesGet configured server query aliases and expressions

Get configured server query aliases and expressions

No parameter schema in public metadata yet.

vmanomaly_get_metricsGet vmanomaly server metrics in Prometheus format

Get vmanomaly server metrics in Prometheus format

No parameter schema in public metadata yet.

vmanomaly_estimate_deployment_resourcesDeployment CPU/RAM/disk and composable stage estimates

Deployment CPU/RAM/disk and composable stage estimates

No parameter schema in public metadata yet.

vmanomaly_estimate_inference_capacityApproximate active models per inference interval at fixed CPUs, optionally RAM constrained

Approximate active models per inference interval at fixed CPUs, optionally RAM constrained

No parameter schema in public metadata yet.

vmanomaly_get_deployment_sizing_profilesDiscover supported sizing profiles and their model parameters

Discover supported sizing profiles and their model parameters

No parameter schema in public metadata yet.

vmanomaly_list_modelsList models exposed to VMUI and other UI-oriented flows

List models exposed to VMUI and other UI-oriented flows

No parameter schema in public metadata yet.

vmanomaly_get_server_modelsGet configured server models and their query attachments

Get configured server models and their query attachments

No parameter schema in public metadata yet.

vmanomaly_get_model_schemaGet JSON schema for a specific model type

Get JSON schema for a specific model type

No parameter schema in public metadata yet.

vmanomaly_validate_model_configValidate model configuration before using it

Validate model configuration before using it

No parameter schema in public metadata yet.

vmanomaly_validate_configValidate complete vmanomaly YAML configuration

Validate complete vmanomaly YAML configuration

No parameter schema in public metadata yet.

vmanomaly_search_docsFull-text search across vmanomaly documentation with fuzzy matching

Full-text search across vmanomaly documentation with fuzzy matching

No parameter schema in public metadata yet.

vmanomaly_check_compatibilityCheck if persisted state is compatible with runtime version

Check if persisted state is compatible with runtime version

No parameter schema in public metadata yet.

vmanomaly_generate_alert_ruleGenerate VMAlert rule YAML for anomaly score alerting

Generate VMAlert rule YAML for anomaly score alerting

No parameter schema in public metadata yet.

vmanomaly_timeseries_characteristicsProfile sampled query results for trends, seasonalities, spikiness, and gaps

Profile sampled query results for trends, seasonalities, spikiness, and gaps

No parameter schema in public metadata yet.

vmanomaly_create_autotune_taskStart tuning one requested model class on sampled series

Start tuning one requested model class on sampled series

No parameter schema in public metadata yet.

vmanomaly_get_autotune_taskPoll autotune progress and retrieve a completed recommendation

Poll autotune progress and retrieve a completed recommendation

No parameter schema in public metadata yet.

vmanomaly_cancel_autotune_taskRequest cooperative cancellation of an autotune task

Request cooperative cancellation of an autotune task

No parameter schema in public metadata yet.

Sponsors

Configuration

VMANOMALY_ENDPOINT*

vmanomaly server endpoint URL (e.g., http://localhost:8490)

VMANOMALY_BEARER_TOKENsecret

Bearer token for authenticating with vmanomaly API

VMANOMALY_HEADERS

Custom HTTP headers for vmanomaly requests (comma-separated key=value pairs, e.g., X-Custom-Header=value1,X-Another=value2)

MCP_SERVER_MODE

MCP server mode: stdio (default), sse, or http

MCP_LISTEN_ADDR

Listen address for SSE/HTTP modes (default: localhost:8080)

MCP_LOG_LEVEL

Log level: debug, info (default), warn, or error

MCP_LOG_FILE

Log file path (empty = stderr)

MCP_DISABLED_TOOLS

Comma-separated list of tools to disable

MCP_HEARTBEAT_INTERVAL

Heartbeat interval for HTTP mode (default: 30s)

MCP_DISABLE_RESOURCES

Disable embedded documentation resources

Readme

MCP Server for vmanomaly

Latest Release License Slack X

The implementation of Model Context Protocol (MCP) server for vmanomaly - VictoriaMetrics Anomaly Detection product.

This provides seamless integration with vmanomaly REST API and documentation for AI-assisted anomaly detection, model management, and observability insights.

Features


View the full README on GitHub

Details

Repository
github.com/victoriametrics-community/mcp-vmanomaly
Package
ghcr.io/victoriametrics-community/mcp-vmanomaly:0.1.0
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from victoriametrics-community