This MCP server provides an interface for AI assistants to interact with VictoriaMetrics time series database for monitoring and observability data:
Write custom metrics - Insert time series data with metric tags, values, and timestamps
Import Prometheus format data - Ingest metrics in Prometheus exposition format for ecosystem compatibility
Query current values - Execute PromQL queries to retrieve instantaneous metric values at specific points in time
Query time ranges - Run PromQL queries over specified time periods with configurable start, end, and resolution steps for historical analysis
Discover labels - Retrieve all unique label names to explore metric structure
Get label values - Fetch all unique values for specific labels to understand metric dimensions
Integrate with Claude Desktop - Install via Smithery or manual NPX configuration
This server bridges AI assistants and VictoriaMetrics, enabling automated metric analysis, data ingestion, and time-series exploration through natural language interactions.
Enables importing Prometheus exposition format data and executing PromQL queries against the VictoriaMetrics database.
Provides tools for reading and writing time series data to VictoriaMetrics, including capabilities for querying data over specific time ranges, importing Prometheus format data, and retrieving label information.

VictoriaMetrics MCP Server
MCP Server for the VictoriaMetrics.
Installing via Smithery
To install VictoriaMetrics Server for Claude Desktop automatically via Smithery:
Debug
NPX
📊 VictoriaMetrics Tools API Documentation
1. vm_data_write
Description: Write data to the VictoriaMetrics database.
Input Parameters:
Parameter | Type | Description | Required |
|
| Tags of the metric | ✅ |
|
| Array of metric values | ✅ |
|
| Array of timestamps in Unix seconds | ✅ |
2. vm_prometheus_write
Description: Import Prometheus exposition format data into VictoriaMetrics.
Input Parameters:
Parameter | Type | Description | Required |
|
| Metrics in Prometheus exposition format | ✅ |
3. vm_query_range
Description: Query time series data over a specific time range.
Input Parameters:
Parameter | Type | Description | Required |
|
| PromQL expression | ✅ |
|
| Start timestamp in Unix seconds | ⛔️ |
|
| End timestamp in Unix seconds | ⛔️ |
|
| Query resolution step width (e.g.,
,
) | ⛔️ |
Only
queryis required; the other fields are optional.
4. vm_query
Description: Query the current value of a time series.
Input Parameters:
Parameter | Type | Description | Required |
|
| PromQL expression to evaluate | ✅ |
|
| Evaluation timestamp in Unix seconds | ⛔️ |
5. vm_labels
Description: Get all unique label names.
Input Parameters: None
6. vm_label_values
Description: Get all unique values for a specific label.
Input Parameters:
Parameter | Type | Description | Required |
|
| Label name to get values for | ✅ |
Related MCP Servers
- Apache 2.0
- -securityAlicense-qualitymcp-victoriametricsLast updated -90Apache 2.0