Tempo Trace MCP Server

Example Use Cases

• 1

  Fetch a specific trace's full details given a traceId (get_trace).

• 2

  Search for traces across a time range using service name, tags, or TraceQL (search_traces).

• 3

  Retrieve TraceQL-based metrics and timeseries data (get_traceql_metrics) for analysis and monitoring.

Description

This MCP server provides access to Grafana Tempo trace data over stdio, exposing resources and tools for searching traces, retrieving trace details by ID, and querying TraceQL metrics. It is implemented in TypeScript, uses Axios for HTTP requests, and is configured via a TEMPO_URL environment variable. The server enables agents to perform detailed trace searches, obtain rich metadata, and run timeseries metric queries for analysis and monitoring.