Victoriametrics MCP Server

by victoriametricsio.github.VictoriaMetrics/mcp-victoriametricsv1.120.1

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

237Dockerstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active10d ago

Install Victoriametrics MCP server

claude mcp add victoriametrics -e VM_INSTANCE_ENTRYPOINT='<vm-instance-entrypoint>' -e VM_INSTANCE_TYPE='<vm-instance-type>' -e VM_INSTANCE_BEARER_TOKEN='<vm-instance-bearer-token>' -e VMC_API_KEY='<vmc-api-key>' -- docker run -i --rm -e VM_INSTANCE_ENTRYPOINT -e VM_INSTANCE_TYPE -e VM_INSTANCE_BEARER_TOKEN -e VMC_API_KEY ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1

{
  "mcpServers": {
    "victoriametrics": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VM_INSTANCE_ENTRYPOINT",
        "-e",
        "VM_INSTANCE_TYPE",
        "-e",
        "VM_INSTANCE_BEARER_TOKEN",
        "-e",
        "VMC_API_KEY",
        "ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1"
      ],
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<vm-instance-entrypoint>",
        "VM_INSTANCE_TYPE": "<vm-instance-type>",
        "VM_INSTANCE_BEARER_TOKEN": "<vm-instance-bearer-token>",
        "VMC_API_KEY": "<vmc-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "victoriametrics": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VM_INSTANCE_ENTRYPOINT",
        "-e",
        "VM_INSTANCE_TYPE",
        "-e",
        "VM_INSTANCE_BEARER_TOKEN",
        "-e",
        "VMC_API_KEY",
        "ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1"
      ],
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<vm-instance-entrypoint>",
        "VM_INSTANCE_TYPE": "<vm-instance-type>",
        "VM_INSTANCE_BEARER_TOKEN": "<vm-instance-bearer-token>",
        "VMC_API_KEY": "<vmc-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "victoriametrics": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VM_INSTANCE_ENTRYPOINT",
        "-e",
        "VM_INSTANCE_TYPE",
        "-e",
        "VM_INSTANCE_BEARER_TOKEN",
        "-e",
        "VMC_API_KEY",
        "ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1"
      ],
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<vm-instance-entrypoint>",
        "VM_INSTANCE_TYPE": "<vm-instance-type>",
        "VM_INSTANCE_BEARER_TOKEN": "<vm-instance-bearer-token>",
        "VMC_API_KEY": "<vmc-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "victoriametrics": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VM_INSTANCE_ENTRYPOINT",
        "-e",
        "VM_INSTANCE_TYPE",
        "-e",
        "VM_INSTANCE_BEARER_TOKEN",
        "-e",
        "VMC_API_KEY",
        "ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1"
      ],
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<vm-instance-entrypoint>",
        "VM_INSTANCE_TYPE": "<vm-instance-type>",
        "VM_INSTANCE_BEARER_TOKEN": "<vm-instance-bearer-token>",
        "VMC_API_KEY": "<vmc-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
VM_INSTANCE_ENTRYPOINT	yes	—	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	yes	—	Type of VictoriaMetrics instance (single / cluster)
VM_INSTANCE_BEARER_TOKEN	yes	yes	Authentication token for VictoriaMetrics API
VMC_API_KEY	—	yes	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.

Freshness

Active — last maintenance signal 10d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-30 · 10d ago · GitHub
Latest release
2026-04-15 · 6mo ago · GitHub · v1.20.2
Package published
no data · npm/PyPI
Registry entry updated
2026-03-19 · 7mo ago · official registry · v1.120.1

FAQ

›How do I install the Victoriametrics MCP server in Claude Code?

Run: claude mcp add victoriametrics -e VM_INSTANCE_ENTRYPOINT='<vm-instance-entrypoint>' -e VM_INSTANCE_TYPE='<vm-instance-type>' -e VM_INSTANCE_BEARER_TOKEN='<vm-instance-bearer-token>' -e VMC_API_KEY='<vmc-api-key>' -- docker run -i --rm -e VM_INSTANCE_ENTRYPOINT -e VM_INSTANCE_TYPE -e VM_INSTANCE_BEARER_TOKEN -e VMC_API_KEY ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Victoriametrics require an API key?

Yes. It expects VM_INSTANCE_ENTRYPOINT, VM_INSTANCE_TYPE, VM_INSTANCE_BEARER_TOKEN, VMC_API_KEY, of which 2 are secrets.

›Can I use Victoriametrics as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Victoriametrics in the official MCP registry?

Yes, as io.github.VictoriaMetrics/mcp-victoriametrics.

Install Victoriametrics MCP server

Install in Claude Code

Install in Cursor

Install in Claude Desktop

Install in VS Code

Install in Windsurf

Configuration

Freshness

FAQ

Alternatives to Victoriametrics