mcp-replay v0.1.0-alpha.2

Replay every MCP server call your agent made.

mcp-replay is a static-page renderer for JSON-RPC traces recorded by mcp-tape — the stdio proxy that wraps any MCP server and writes every message to a replayable .jsonl file. Drop a trace URL in, see exactly what tools your agent called, with what arguments, and what they returned.

Open the demo trace → Get mcp-tape ↗

Tip: drag & drop one or more .jsonl traces anywhere on this page to open them locally.

URL grammar. ?trace=<url> for one trace, ?trace=<a>;<b>;… to merge several by timestamp. Traces must be reachable via HTTPS or same-origin.
Drop to open

Timeline

Every JSON-RPC message, ordered. Click to expand the raw payload.

Tool aggregates

Which tools your agent called, how often, how long they took, how often they errored.

Call inspector

Each tools/call request paired with its response, with latency and full arguments.

Raw view

The JSONL itself, line-numbered. The format is documented and stable.

Try it in 5 steps

From zero to a replayable trace of your own Claude Code session. No public URLs, no server staging.

  1. 1

    Install mcp-tape globally

    npm i -g mcp-tape@alpha

    Requires Node 20+. -g (not npx) so the wrapped binary path in your config survives upgrades.

  2. 2

    Wrap every MCP server in your client config

    mcp-tape install

    Auto-detects and wraps these configs: ~/.claude.json (Claude Code), ~/.config/claude/claude_desktop_config.json (Claude Desktop), ~/.gemini/antigravity/mcp_config.json (Antigravity IDE), ~/.gemini/settings.json (Gemini CLI). Idempotent. Backs up to <file>.mcp-tape.bak. --dry-run previews; --target=<list> scopes; mcp-tape uninstall reverses.

  3. 3

    Restart your MCP client and use it normally

    Every server you talk to writes a JSONL trace to ./mcp-traces/ (relative to the server's working directory). One file per session per server, named like 2026-05-13T15-30-00-000Z-<label>.jsonl.

  4. 4

    Open the trace here

    Click Open local trace… at the top of this page (or drag-and-drop the .jsonl file anywhere). The file stays in your browser. To merge sessions across servers, drag multiple files at once.

  5. 5

    Share the trace

    Send the .jsonl file to a collaborator. They drop it into mcpreplay.dev the same way. No public URL needed.

Done when you've recorded a few real sessions and shared at least one without hand-editing config or hand-scrubbing secrets.

MIT · craigm26 · mcpreplay.dev repo ↗ · trace format spec
mcp-replay

Couldn't load that trace.

← back