MCP Agent Trace Inspector MCP Server

Step-by-step observability for MCP agent workflows

Remote serverstreamable-http

What is the MCP Agent Trace Inspector MCP Server?

Step-by-step observability for MCP agent workflows

What it actually does

Local-first, MCP-native observability for agent workflows. Every tool call, prompt transformation, latency, and token count is recorded in a local SQLite database — no cloud account, no API key, no traces leaving your machine. Built specifically for MCP rather than bolted onto a generic LLM proxy.

  • Tool call tracing — Captures inputs, outputs, latency, and token usage for every step in a workflow
  • Persistent storage — Traces survive session restarts; stored locally in SQLite with no external dependencies
  • HTML dashboard — Generates a self-contained single-file dashboard with an interactive step timeline
  • Token cost estimation — Calculates USD cost per trace using a configurable model pricing table — no API calls required
  • Trace comparison — Diff two traces side by side to measure the impact of prompt or tool changes
  • Low overhead — Adds less than 5ms per step; never becomes the bottleneck

Configuration

  • Node.js v22.5.0 or newer. - npm.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
trace_startbegin a new trace; returns a trace_id for subsequent calls
trace_steprecord one tool call step (inputs, outputs, optional token count and latency)
trace_endmark a trace as completed
list_traceslist stored traces with names, statuses, and timestamps
get_trace_summarytoken totals, step count, latency, and cost estimate for a trace
compare_tracesdiff two traces side by side (step counts, tokens, latency)
extract_reasoning_chainextract only reasoning/thinking steps from a trace
export_dashboardgenerate a self-contained single-file HTML dashboard with latency waterfall
export_otelexport one or all traces in OpenTelemetry OTLP JSON span format
export_compliance_logexport the compliance audit log as JSON or CSV, with optional date range filtering
configure_alertsconfigure alert rules on latency, error rate, or cost; fire to Slack or generic webhooks
set_retention_policyset how many days to keep traces (in-memory; must be called before apply_retention)
apply_retentionarchive traces older than the configured threshold; delete traces past 2x the threshold

How to install the MCP Agent Trace Inspector MCP Server

{
  "mcpServers": {
    "trace-inspector": {
      "command": "npx",
      "args": ["-y", "mcp-agent-trace-inspector@latest"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js v22.5.0 or newer. - npm.

Example prompts to try

  • “Use MCP Agent Trace Inspector to trace start.”
  • “Use MCP Agent Trace Inspector to trace step.”
  • “Use MCP Agent Trace Inspector to trace end.”

Frequently asked questions

Step-by-step observability for MCP agent workflows Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.