# MCP Victoriametrics (MCP server) > MCP Victoriametrics is an MCP server that adds cloud and DevOps tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP Server for VictoriaMetrics. Provides integration with… It has 236 GitHub stars, is released under the Apache-2.0 license and runs locally with 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. The implementation of Model Context Protocol (MCP) server for VictoriaMetrics. This provides access to your VictoriaMetrics instance and seamless integration with VictoriaMetrics APIs and documentation. It can give you a comprehensive interface for monitoring, observability, and debugging tasks related to your VictoriaMetrics instances, enable advanced automation and interaction capabilities for engineers and tools. ## Key facts | Fact | Value | |---|---| | Repository | https://github.com/VictoriaMetrics/mcp-victoriametrics | | GitHub stars | 236 | | License | Apache-2.0 | | Language | Go | | Transport | stdio | | Packages | docker: ghcr.io/victoriametrics-community/mcp-victoriametrics:1.18.0 | | Remote URL | none | | Needs API key | yes | | Official | yes | | Works with | Claude Desktop, Claude Code, Cursor, VS Code | | Category | Cloud & DevOps | | Latest release | v1.20.2 (Apr 15, 2026) | | Last commit | Sep 30, 2026 | | MCP registry name | io.github.VictoriaMetrics-Community/mcp-victoriametrics | ## Install ### Claude Desktop (claude_desktop_config.json) ```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": "your-value", "VM_INSTANCE_TYPE": "your-value", "VM_INSTANCE_BEARER_TOKEN": "your-value", "VMC_API_KEY": "your-value" } } } } ``` Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards. ### Claude Code ```sh claude mcp add --env VM_INSTANCE_ENTRYPOINT=your-value --env VM_INSTANCE_TYPE=your-value --env VM_INSTANCE_BEARER_TOKEN=your-value --env VMC_API_KEY=your-value --transport stdio mcp-victoriametrics -- 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 ``` ### Cursor (.cursor/mcp.json) ```json { "mcpServers": { "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": "your-value", "VM_INSTANCE_TYPE": "your-value", "VM_INSTANCE_BEARER_TOKEN": "your-value", "VMC_API_KEY": "your-value" } } } } ``` Project file; use ~/.cursor/mcp.json to enable it in every project. ### VS Code (.vscode/mcp.json) ```json { "inputs": [ { "type": "promptString", "id": "vm_instance_bearer_token", "description": "VM_INSTANCE_BEARER_TOKEN", "password": true }, { "type": "promptString", "id": "vmc_api_key", "description": "VMC_API_KEY", "password": true } ], "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": "your-value", "VM_INSTANCE_TYPE": "your-value", "VM_INSTANCE_BEARER_TOKEN": "${input:vm_instance_bearer_token}", "VMC_API_KEY": "${input:vmc_api_key}" } } } } ``` Config formats checked against the official docs on 2026-10-07. ## Environment variables - `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` (secret) (required): 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) ## Similar MCP servers - [Worldmonitor](https://appsgit.com/mcp-servers/worldmonitor): Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface. (87,920 stars, AGPL-3.0) - [Netdata](https://appsgit.com/mcp-servers/netdata): Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection. (80,817 stars, GPL-3.0, needs API key) - [openstatus](https://appsgit.com/mcp-servers/openstatus): Manage monitors, status pages, incidents and maintenances in your openstatus workspace. (9,171 stars, AGPL-3.0, official) - [MCP Server Cloudflare](https://appsgit.com/mcp-servers/mcp-server-cloudflare): Model Context Protocol (MCP) is a new, standardized protocol for managing context between large language models (LLMs) and external systems. (4,360 stars, Apache-2.0, official, needs API key) - [Dagu](https://appsgit.com/mcp-servers/dagu): Self-hostable workflow orchestrator for teams whose main work isn't orchestration. (4,289 stars, GPL-3.0) - [Azure MCP Server](https://appsgit.com/mcp-servers/azure-mcp-server): All Azure MCP tools to create a seamless connection between AI agents and Azure services. (3,738 stars, MIT, official) --- Canonical page: https://appsgit.com/mcp-servers/mcp-victoriametrics Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly. Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.