How do I install the mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `VL_INSTANCE_ENTRYPOINT`, `VL_INSTANCE_BEARER_TOKEN`, `VL_INSTANCE_HEADERS`, `MCP_PASSTHROUGH_HEADERS`, `MCP_SERVER_MODE`, `MCP_SSE_ADDR`, `MCP_DISABLED_TOOLS`, `VL_DEFAULT_TENANT_ID` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

MCP Server — VictoriaMetrics-Community/mcp

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

Local serverstdioGo

What is the MCP Server?

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

What the server does

This MCP server allows you to use almost all read-only APIs of VictoriaLogs, i.e. all functions available in Web UI:

Querying logs and exploring logs data
Showing parameters of your VictoriaLogs instance
Listing available streams, fields, field values
Query statistics for the logs as metrics
UI with setup instructions and tools inspection on the root endpoint (only in Streamable HTTP mode)

Credentials and setup notes

VictoriaLogs instance: (single-node or cluster) - Go 1.26 or higher (if you want to build from source)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
documentation	Search in embedded VictoriaLogs documentation
facets	Most frequent values per each log field
field_names	List of field names for the query
field_values	List of field values for the query
flags	View non-default flags of the VictoriaLogs instance
hits	The number of matching log entries grouped by buckets
query	Execute LogsQL queries
stats_query	Querying log stats for the given time
stats_query_range	Querying log stats on the given time range
stream_field_names	List of stream fields for the query
stream_field_values	List of stream field values for the query
stream_ids	List of stream IDs for the query
streams	List of streams for the query

How to install the MCP Server

{
  "mcpServers": {
    "victorialogs": {
      "command": "/path/to/mcp-victorialogs",
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>",
        "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>",
        "VL_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VictoriaLogs instance: (single-node or cluster) - Go 1.26 or higher (if you want to build from source)

Variable	Description	Required
VL_INSTANCE_ENTRYPOINT	Configuration value read at startup.	Optional
VL_INSTANCE_BEARER_TOKEN	Credential the server authenticates with.	Yes
VL_INSTANCE_HEADERS	Configuration value read at startup.	Optional
MCP_PASSTHROUGH_HEADERS	Configuration value read at startup.	Optional
MCP_SERVER_MODE	Configuration value read at startup.	Optional
MCP_SSE_ADDR	Configuration value read at startup.	Optional
MCP_DISABLED_TOOLS	Configuration value read at startup.	Optional
VL_DEFAULT_TENANT_ID	Configuration value read at startup.	Optional

Example prompts to try

“Use MCP to documentation.”
“Use MCP to facets.”
“Use MCP to field names.”

Frequently asked questions

MCP Server for VictoriaLogs. Provides integration with VictoriaLogs API and documentation Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.