> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Session Replay

> Step through every event in a session to understand what happened and debug.

## What is Session Replay?

When a user reports an issue or you see an error spike, you need the full context, not just an error message. Session Replay lets you step through every event in a session, see what the user was trying to accomplish, and inspect the exact request and response data for each tool call.

## Session List

The sessions page shows all recorded sessions with filtering, sorting, and pagination.

<Frame>
  <img src="https://mintcdn.com/mcpcat/1ZBpCsjHOX5lBBUE/images/sessions-list.png?fit=max&auto=format&n=1ZBpCsjHOX5lBBUE&q=85&s=fb99322f33b8d4b547823ffc54a060d0" alt="sessions list" width="2434" height="898" data-path="images/sessions-list.png" />
</Frame>

### Filters

| Filter              | Description                                                                     |
| ------------------- | ------------------------------------------------------------------------------- |
| **User search**     | Search by user name or ID                                                       |
| **Date range**      | Filter sessions by time period                                                  |
| **User type**       | Identified or anonymous users                                                   |
| **Server**          | Filter by MCP server                                                            |
| **Client**          | Filter by AI client                                                             |
| **Tools**           | Filter sessions that used specific tools                                        |
| **Goals**           | Filter by session goal (visible when [Agent Goals](/features/goals) are active) |
| **Activity toggle** | Show only sessions with activity                                                |
| **Actor traits**    | Filter by user properties set via the identify callback                         |

Sessions can be sorted by date, activity count, or duration, with configurable page sizes.

## Replay View

The replay view uses a two-panel layout: a **timeline** on the left showing every event in sequence, and a **detail panel** on the right showing the full data for the selected event.

<Frame>
  <img src="https://mintcdn.com/mcpcat/1ZBpCsjHOX5lBBUE/images/session-replay.png?fit=max&auto=format&n=1ZBpCsjHOX5lBBUE&q=85&s=dc9fb7b615ac854377a21f1f8f514a8c" alt="session replay" width="2424" height="1116" data-path="images/session-replay.png" />
</Frame>

### Timeline

The timeline lists every event in chronological order, showing the timestamp, event type badge, and a description. Tool call events show the tool name; custom events show the resource name.

* Use the **Show/hide list tools** toggle to filter out `tools/list` events that add noise
* The timeline supports infinite scroll for sessions with many events

### Event Detail Panel

Click any event in the timeline to see its full details:

* **Agent Intent**: an explanation from the agent on why it called this tool (see [Tool Call Context](/sdk/tool-call-context))
* **Error Details**: if the tool call errored, the error message and stack trace
* **Parameters**: the full request arguments
* **Response**: the tool's response data
* **Event Metadata**: information about the event
* **Identify Data**: information about the user, if available