Skip to content
MCP server

MCP Victoriametrics

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.18.0
Listing updated
4 days ago

About MCP Victoriametrics

MCP Victoriametrics is an open-source MCP server. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

claude mcp add mcp-victoriametrics --env VM_INSTANCE_ENTRYPOINT='<VM_INSTANCE_ENTRYPOINT>' --env VM_INSTANCE_TYPE='<VM_INSTANCE_TYPE>' --env VM_INSTANCE_BEARER_TOKEN='<VM_INSTANCE_BEARER_TOKEN>' --env 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-community/mcp-victoriametrics:1.18.0

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-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-community/mcp-victoriametrics:1.18.0"
      ],
      "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

{
  "mcpServers": {
    "mcp-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-community/mcp-victoriametrics:1.18.0"
      ],
      "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

{
  "servers": {
    "mcp-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-community/mcp-victoriametrics:1.18.0"
      ],
      "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

{
  "mcpServers": {
    "mcp-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-community/mcp-victoriametrics:1.18.0"
      ],
      "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 your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-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-community/mcp-victoriametrics:1.18.0"
      ],
      "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>"
      }
    }
  }
}

Configuration

  • VM_INSTANCE_ENTRYPOINTURL to VictoriaMetrics instance (it should be root URL of vmsingle or vmselect), for example http://localhost:8428 or https://play.victoriametrics.comRequired
  • VM_INSTANCE_TYPEType of VictoriaMetrics instance (single / cluster)Required
  • VM_INSTANCE_BEARER_TOKENAuthentication token for VictoriaMetrics APIRequired
  • VMC_API_KEYOptional: API key from VictoriaMetrics Cloud Console (if you have deployment in VictoriaMetrics Cloud)
  • MCP_DISABLED_TOOLSComma-separated list of tools to disable
  • MCP_DISABLE_RESOURCESDisable all resources (documentation tool will continue to work)

Pricing

Open source

MCP Victoriametrics FAQ

Is MCP Victoriametrics free?

Yes. MCP Victoriametrics is open source, so you can use and self-host it for free.

How do I add MCP Victoriametrics to Claude Code?

Run this command in your terminal: claude mcp add mcp-victoriametrics --env VM_INSTANCE_ENTRYPOINT='<VM_INSTANCE_ENTRYPOINT>' --env VM_INSTANCE_TYPE='<VM_INSTANCE_TYPE>' --env VM_INSTANCE_BEARER_TOKEN='<VM_INSTANCE_BEARER_TOKEN>' --env 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-community/mcp-victoriametrics:1.18.0