MCP Server — VictoriaMetrics-Community/mcp

MCP Server for vmanomaly - VictoriaMetrics anomaly detection

Local serverstdioGo

What is the MCP Server?

MCP Server for vmanomaly - VictoriaMetrics anomaly detection

The short version

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

  • Health Monitoring — Check vmanomaly server health and build information
  • Model Management — Discover UI-compatible models and validate univariate or multivariate configurations
  • Data-Driven Recommendations — Profile sampled time series and run shared autotune suggestions for one production-ready model config across many returned series
  • Configuration Generation — Generate complete vmanomaly YAML configurations
  • Alert Rule Generation — Generate vmalert alerting rules based on anomaly score metrics to simplify alerting setup
  • Documentation Search — Full-text search across embedded vmanomaly documentation with fuzzy matching

What it needs from you

  • vmanomaly instance with REST API access: - version 1.28.3+ for the core MCP toolset - version 1.30.0+ for time-series characteristics and task-based shared autotune - Go 1.24 or higher (if building

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
vmanomaly_health_checkCheck vmanomaly server health status
vmanomaly_get_buildinfoGet build information (version, build time, Go version)
vmanomaly_get_server_queriesGet configured server query aliases and expressions
vmanomaly_get_metricsGet vmanomaly server metrics in Prometheus format
vmanomaly_list_modelsList models exposed to VMUI and other UI-oriented flows
vmanomaly_get_server_modelsGet configured server models and their query attachments
vmanomaly_get_model_schemaGet JSON schema for a specific model type
vmanomaly_validate_model_configValidate model configuration before using it
vmanomaly_timeseries_characteristicsProfile sampled query results for trends, seasonalities, spikiness, and gaps
vmanomaly_create_autotune_taskStart tuning one requested model class on sampled series
vmanomaly_get_autotune_taskPoll autotune progress and retrieve a completed recommendation
vmanomaly_cancel_autotune_taskRequest cooperative cancellation of an autotune task

Configuration

  • vmanomaly instance with REST API access: - version 1.28.3+ for the core MCP toolset - version 1.30.0+ for time-series characteristics and task-based shared autotune - Go 1.24 or higher (if building
VariableDescriptionRequired
VMANOMALY_ENDPOINTConfiguration value read at startup.Optional
VMANOMALY_BEARER_TOKENCredential the server authenticates with.Yes
VMANOMALY_HEADERSConfiguration value read at startup.Optional
MCP_SERVER_MODEConfiguration value read at startup.Optional
MCP_LISTEN_ADDRConfiguration value read at startup.Optional
MCP_LOG_LEVELConfiguration value read at startup.Optional
MCP_LOG_FILEConfiguration value read at startup.Optional

Example prompts to try

  • “Use MCP to vmanomaly health check.”
  • “Use MCP to vmanomaly get buildinfo.”
  • “Use MCP to vmanomaly get server queries.”

Frequently asked questions

MCP Server for vmanomaly - VictoriaMetrics anomaly detection Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.