Home › Cloud & Monitoring › mcp-victoriametrics

mcp-victoriametrics

MCP Server for VictoriaMetrics. Provides integration with VictoriaMetrics API and documentation

Official Go Local

★ 243 stars Last pushed 2026-11-11 License: Apache-2.0

View repository →

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (oci)

docker run -i --rm -e VM_INSTANCE_ENTRYPOINT=<YOUR_VALUE> -e VM_INSTANCE_TYPE=<YOUR_VALUE> -e VM_INSTANCE_BEARER_TOKEN=<YOUR_VALUE> -e VMC_API_KEY=<YOUR_VALUE> ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1

Or add to your MCP client config:

{
  "mcpServers": {
    "mcp-victoriametrics": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VM_INSTANCE_ENTRYPOINT=<YOUR_VALUE>",
        "-e",
        "VM_INSTANCE_TYPE=<YOUR_VALUE>",
        "-e",
        "VM_INSTANCE_BEARER_TOKEN=<YOUR_VALUE>",
        "-e",
        "VMC_API_KEY=<YOUR_VALUE>",
        "ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1"
      ]
    }
  }
}

VM_INSTANCE_ENTRYPOINT required — URL to VictoriaMetrics instance (it should be root URL of vmsingle or vmselect), for example http://localhost:8428 or https://play.victoriametrics.com
VM_INSTANCE_TYPE required — Type of VictoriaMetrics instance (single / cluster)
VM_INSTANCE_BEARER_TOKEN required secret — Authentication token for VictoriaMetrics API
VMC_API_KEY secret — Optional: API key from VictoriaMetrics Cloud Console (if you have deployment in VictoriaMetrics Cloud)
MCP_DISABLED_TOOLS — Comma-separated list of tools to disable
MCP_DISABLE_RESOURCES — Disable all resources (documentation tool will continue to work)
MCP_PASSTHROUGH_HEADERS — HTTP header names to forward from incoming MCP requests to VictoriaMetrics (comma-separated list). Overrides VM_INSTANCE_HEADERS on collision.