MCP server

The obsrv MCP server lets agents (Claude Code, Cursor, custom IDE tools) query your traces and metrics directly through the Model Context Protocol.

Install

npm install -g @obsrv/mcp

Configure

Add the server to your IDE's MCP config. For Claude Code:

{
  "mcpServers": {
    "client": {
      "command": "obsrv-mcp",
      "env": {
        "THETA_API_KEY": "tk_live_…",
        "THETA_PROJECT": "proj_…"
      }
    }
  }
}

Available tools

list_traces — query the trace feed by metadata, status, run type, model.
get_trace — fetch a specific trace, including steps and messages.
list_clusters — get the current cluster set with sizes and labels.
list_metrics — list metric definitions and recent pass rates.
search — full-text search over recent traces.

With the MCP server connected, an in-IDE agent can answer questions like "why did checkout traces start failing in v3.2.1?" by actually querying your real traces and clusters.

← OpenTelemetry

Overview →