victoriametrics-community avatar

Mcp Victoriatraces

victoriametrics-community/mcp-victoriatraces

Connects Claude to VictoriaTraces instances for distributed tracing queries and analysis. Exposes read-only APIs to list services and operations, query trace data, and search embedded documentation without needing internet access. You'd use this when debugging microservices or analyzing request flows in production, letting Claude explore traces and correlate them with VictoriaTraces docs. Supports both single-node and cluster deployments, works with custom tenants, and can combine with other observability MCP servers for cross-system analysis. Runs via stdio, SSE, or HTTP transports, and ships as a binary, Docker image, or Go install.

GitHub stars
9
tools
6
auth
Secret needed
transport
STDIO
env vars
3
last updated
Dec 15, 2025

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

documentationSearch in embedded VictoriaTraces documentation

Search in embedded VictoriaTraces documentation

No parameter schema in public metadata yet.

servicesList of all traced services

List of all traced services

No parameter schema in public metadata yet.

service_namesGet all the span names (operations) of a service

Get all the span names (operations) of a service

No parameter schema in public metadata yet.

tracesQuery traces

Query traces

No parameter schema in public metadata yet.

traceGet trace info by trace ID

Get trace info by trace ID

No parameter schema in public metadata yet.

dependenciesQuery the service dependency graph

Query the service dependency graph

No parameter schema in public metadata yet.

Sponsors

Configuration

VT_INSTANCE_ENTRYPOINT*

URL to VictoriaTraces instance (it should be root URL of vtlingle or vtselect), for example http://localhost:10428

VT_INSTANCE_BEARER_TOKEN*secret

Authentication token for VictoriaMetrics API

MCP_DISABLED_TOOLS

Comma-separated list of tools to disable

Readme

VictoriaTraces MCP Server


View the full README on GitHub

Details

Repository
github.com/victoriametrics-community/mcp-victoriatraces
Package
ghcr.io/victoriametrics-community/mcp-victoriatraces:1.5.0
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from victoriametrics-community