Grafana Tempo MCP

DevOpsstdio
Repository

A Model Context Protocol server for Grafana Tempo that lets AI assistants query and analyze distributed tracing data. Agents can search traces with TraceQL, fetch a trace by ID, and inspect spans to investigate latency and errors across services during incident analysis.

Connect

Add this configuration to .claude/mcp.json

{
  "mcpServers": {
    "grafana-tempo": {
      "command": "npx",
      "args": [],
      "env": {
        "TEMPO_URL": "<YOUR_TEMPO_URL>"
      }
    }
  }
}

Tools (2)

search_traces

Search traces in Grafana Tempo using a TraceQL query.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "TraceQL query expression"
    },
    "time_range": {
      "type": "string",
      "description": "Optional time window to search over"
    }
  }
}

get_trace

Fetch a single trace by its trace ID.

{
  "type": "object",
  "required": [
    "trace_id"
  ],
  "properties": {
    "trace_id": {
      "type": "string",
      "description": "The trace identifier"
    }
  }
}

Resources

This server does not expose any resources.

Prompts

This server does not expose any prompts.

Server information

Author
Grafana Labs (@grafana)
Repository
https://github.com/grafana/tempo-mcp-server
License
Apache-2.0
Stars
0
Last updated
July 25, 2026
Grafana Tempo MCP - MCP Server | OpenModels