Other formats agents might prefer:
markdownjsonllms.txt

Agent? You probably want markdown or json, or Pod over MCP.

Reported issues for io.github.VictoriaMetrics/mcp-victoriametrics

Pod holds 20 of 23 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to io.github.VictoriaMetrics/mcp-victoriametrics.

Most discussed

Web UI is not available on docker install

Running MCP in docker doesn't render a Web UI:

│ vmm-victoria-metrics-mcp-66bb85f877-6zzg2 time=2026-05-15T13:10:47.106Z level=INFO msg="Starting mcp-victoriametrics" version=1.19.0 date=2026-03-17T12:55:19Z mode=http addr=0.0.0.0:8080 │
│ vmm-victoria-metrics-mcp-66bb85f877-6zzg2 time=2026-05-15T13:10:53.702Z level=INFO msg="Starting server in HTTP mode" addr=0.0.0.0:8080                                                    │
│ vmm-victoria-metrics-mcp-66bb85f877-6zzg2 time=2026-05-15T13:10:5

[Read the thread](https://github.com/VictoriaMetrics/mcp-victoriametrics/issues/172) · 2026-05-15 · closed · external user · 3 comments

### High memory usage

Somewhat ironic but my mcp-victoriametrics Docker container is using a lot of memory. To quote Claude:

>  mcp-victoriametrics on xxxx is using ~696MB
That's surprisingly heavy for what is essentially a small MCP bridge container. You might want to check if it's got a memory leak or just inherently large. It's using about 4x what VictoriaMetrics itself uses on that same node.

I restarted the container and it came back at 644MB which is still pretty high. There are no errors in the logs and I'm 

[Read the thread](https://github.com/VictoriaMetrics/mcp-victoriametrics/issues/138) · 2026-03-13 · closed · external user · 4 comments

### Support dynamic per-request headers in tool calls

## Problem

`VM_INSTANCE_HEADERS` is static — set once at startup and cannot be changed during the MCP server's lifetime.

This doesn't work when headers need to be dynamic, for example short-lived auth tokens that expire and must be refreshed.

## Typical Scenario

VictoriaMetrics cluster deployed behind an auth proxy:

MCP Client → mcp-victoriametrics → Auth Proxy (validates X-Token) → vmselect


- The auth proxy requires a custom `X-Token` header on every request
- Tokens are short-liv

[Read the thread](https://github.com/VictoriaMetrics/mcp-victoriametrics/issues/129) · 2026-03-04 · closed · external user · 13 comments

### Feature request: add otel-collector receivers metrics to metrics_metadata_db

Hi VM team,

we're using otel-collector to collect metrics from node, kubelet and k8s apiserver with following receivers:
- [hostmetricsreceiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/hostmetricsreceiver)
- [kubeletstatsreceiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/kubeletstatsreceiver)
- [k8sclusterreceiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/k8sclust

[Read the thread](https://github.com/VictoriaMetrics/mcp-victoriametrics/issues/90) · 2025-11-07 · closed · external user · 10 comments

### Error running in streamable http mode

Hi Team,

While running the server in streamable http mode, getting below error:

**Error on server:**
`2025/09/15 05:53:18 Starting mcp-victoriametrics version dev (date: unknown)
2025/09/15 05:53:26 Starting server in HTTP mode on 0.0.0.0:8080
2025/09/15 05:53:26 Server is listening on 0.0.0.0:8080
2025/09/15 05:54:03 ERROR: Failed to deliver sampling response: no pending request found for session mcp-session-2ad06bc0-2dcd-408e-8c13-e9e07bf2d4d7, request 1
2025/09/15 05:54:03 ERROR: Failed to 

[Read the thread](https://github.com/VictoriaMetrics/mcp-victoriametrics/issues/51) · 2025-09-15 · closed · external user · 9 comments

### More load resources

Hi. I have a problem using the mcp server. I used the mcp-use client in python, the connection goes fine, however, when tools are found, a lot of resources appear that dramatically increase the context for transmission to the model, I looked for ways to disable but did not find. Can you tell me how to fix it?

2025-07-18 17:45:31,725 - mcp_use - DEBUG - Successfully connected to MCP implementation via SSE: http://localhost:8082/sse 2025-07-18 17:45:31,725 - mcp_use - DEBUG - Initializing MCP

Read the thread · 2025-07-18 · closed · external user · 6 comments

Container images are not public

Hi!

I have been trying to follow your documentation to use docker images for running the server, but I get the following error:

Error response from daemon: Head "https://ghcr.io/v2/victoriametrics-community/mcp-victoriametrics/manifests/latest": unauthorized

Is it possible you have not set the images public?

Read the thread · 2025-06-09 · closed · external user · 3 comments

Add ability to query alertmanager

I'm using the Victoriametrics MCP-server to query the current alerts in my environment, and it is correctly showing all alerts that are in a firing state, but it does not take into account silenced or inhibited alerts since the MCP server is unable to query alertmanager.

Read the thread · 2025-05-22 · closed · external user · 3 comments

Most recent

The documentation tool is too attractive for agents

Whenever I have the MCP server enabled and ask agents questions completely unrelated to VictoriaMetrics, they try to use the documentation tool. For example here I asked Opus 4.8 a question about Backrest:

Image

What do you think about renaming this tool to contain VictoriaMetrics in its name?

Read the thread · 2026-06-16 · open · external user · 0 comments

Alerts tool panics when limit is greater than returned alerts count

The alerts tool panics when it is called with a limit value greater than the number of alerts returned by the VictoriaMetrics API.

Request:

{
  "state": "firing",
  "limit": 50
}

In my MCP client this tool is exposed as:

mcp_mcp_victoriametrics_alerts

Error:

2026-05-19 13:53:02,818 ERROR [20260519_135155_2a8e0a] tools.mcp_tool: MCP tool mcp-victoriametrics/alerts call failed: panic recovered in alerts tool handler: runtime error: slice bounds out of rang

[Read the thread](https://github.com/VictoriaMetrics/mcp-victoriametrics/issues/175) · 2026-05-19 · open · external user · 0 comments

### Add a Joy Trust badge to your README?

Hey VictoriaMetrics team!

We indexed your MCP server on **Joy** (trust network for AI agents) and wanted to offer a README badge:

```markdown
[![Joy Trust](https://img.shields.io/badge/Joy-Indexed-blue)](https://joy-connect.fly.dev/agents/ag_c28d1620988c02697e0a4d7d)

What you get:

  • Discoverability among 8,000+ agents
  • Trust verification for multi-agent pipelines

Your profile: https://joy-connect.fly.dev/agents/ag_c28d1620988c02697e0a4d7d

— Joy Team

Read the thread · 2026-04-07 · closed · external user · 1 comment

Support dynamically selecting a host per tool call

We have multiple victoria metrics hosts, it would be nice if only a single MCP is needed in order to send tool calls off to a different host. Could be done as optional parameters on the tool call itself, or since in our case we use streamable-http a header would suffice

Read the thread · 2026-03-12 · open · external user · 3 comments

can not send query request to vmgateway if it enable auth

Reproduce Having VM cluster with vmgateway enable JWT token auth. Within this, the request don't need /prometheus prefix to be pass to vmgateway. However the mcp still sending request with prefix. So vmgateway repsone with 404 I tried to make a patch for fix this by removing the prefix, then the MCP works

Read the thread · 2026-03-07 · open · external user · 0 comments

The default tenant parameter for queries is 0, modify it to set the tenant parameter via environment variable

The default tenant parameter for queries in cluster mode is hardcoded to '0', which causes queries to fail when the actual tenant ID is different. Need to modify the code to allow setting the default tenant via an environment variable (e.g., VM_DEFAULT_TENANT) to support different tenant configurations.

https://xxxx.com/select/0/prometheus/api/v1/

Read the thread · 2026-01-06 · closed · external user · 2 comments

By logging detailed HTTP request and response information to help locate abnormal calls

By logging detailed HTTP request and response information to help locate abnormal calls:

  • Debugging Support: Record request URLs, parameters, headers, and response content to facilitate troubleshooting communication issues
  • Error Tracking: Record error messages and abnormal status codes to quickly identify problems
  • Performance Monitoring: Understand request response times and other performance metrics through logs"

Read the thread · 2026-01-06 · closed · external user · 2 comments

Installation Error Using Smithery

I'm receiving the following error when trying to install the mcp server using smithery.

npx -y @smithery/cli install @VictoriaMetrics-Community/mcp-victoriametrics --client vscode

✖ Failed to install @VictoriaMetrics-Community/mcp-victoriametrics Error: API error occurred: {"error":"Server not found","request$":{},"response$":{},"body$":"{"error":"Server not found"}"}

Read the thread · 2025-12-18 · closed · external user · 1 comment

Can We Have Accessible Helm Chart (e.g. github pages)

I saw the helm chart was there in k8s/helm but I wonder, maybe we can have it accessible through Github Pages?

Read the thread · 2025-12-05 · closed · external user · 3 comments

Error adding server to MCP Context Forge

Hi team,

I experience issues trying to add this MCP server to my IBM Context Forge app. I've deployed my Context Forge app and this server in the same Kubernetes cluster and the same namespace. The versions are the latest for each product.

I launch the server with the following config :

  • VM_INSTANCE_ENTRYPOINT = http://<my-victoria-url>
  • VM_INSTANCE_TYPE = cluster
  • MCP_SERVER_MODE = http
  • MCP_LISTEN_ADDR = 0.0.0.0:8080

I should be able to add this server by targeting the url **http://

Read the thread · 2025-10-22 · closed · external user · 2 comments

Hi team I get a strange regex error when using Gemini CLI as client

Image

Hi team I get the error as above when I use Gemini CLI. This error seems to be not happen when I attach it to Github Copilot though

Read the thread · 2025-10-13 · closed · external user · 2 comments

Running container as non-root user

Summary The current Docker image runs as root. This is not a best practice to run container in Kubernetes. Please update the Dockerfile to add and run as a dedicated non-root user instead of root.

Risks of running as root

Privilege escalation if the container is broken out of.

File permission surprises when shared volumes are used.

Incompatible with restrictive clusters (PSa/PSP, OPA/Gatekeeper, PodSecurity “restricted” profile).

Proposal

Update the Dockerfile to create a non-r

Read the thread · 2025-09-17 · closed · external user · 3 comments

The remaining reports are on the project's issue tracker.