Documentation#

mcp-replay reads .jsonl traces of what an AI agent actually did. The trace format is open: anything that can write a line of JSON can produce a trace these pages describe, and mcpreplay.dev will render it.

Every page here is generated from the markdown in the repo, which stays the source of truth. Each one links back to its source.

• Format
  The normative v1 trace format. One JSON object per line. Any producer can emit it.
• Extensions
  A compatible extension to v1 for non-MCP producers: attribution, signed events, correlation.
• Live mode
  Watch a session unfold in real time over a localhost websocket. Nothing leaves your machine.
• Insights
  Normative definitions for every derived metric the Insights tab shows.