# AgentFirstStack Replay

> AgentFirstStack Replay is an open-source MCP server for analytics and data. Session replay turned into readable transcripts, with rage clicks, errors and heatmaps. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, self-hosted, Web
- **Website:** https://agentfirststack.com/mcp
- **Repository:** https://github.com/startglobal-ai/agentfirststack
- **MCP Registry name:** com.agentfirststack/replay
- **Categories:** analytics and data, developer tools
- **Listing updated:** 2026-11-14

## About

Replay is the session-recording part of AgentFirstStack, exposed at replay.agentfirststack.com/mcp. Instead of a video a person has to scrub through, an agent gets each session back as a readable transcript, along with rage, dead and error clicks, heatmaps and JavaScript errors as data. A share link can open a player for a human reviewer.

Recordings are masked in the browser by default. The script can load from your own domain through a CNAME or path proxy so ad blockers do not drop visitors, and it uses one key shared with analytics, tags and mail. The README presents it as an alternative to Hotjar and Microsoft Clarity.

The project is open source, free to use hosted, and can be deployed to your own Cloudflare account, where replay chunks are stored in R2.

## Features

- **Transcript output:** Sessions come back as text an agent can read.
- **Click problems:** Reports rage, dead and error clicks.
- **Heatmaps as data:** Returns heatmap data to the agent.
- **JS error capture:** Surfaces JavaScript errors from sessions.
- **Masked by default:** Masking happens in the browser.
- **Share link:** A player link for human review.

## Good for

- Ask an agent why visitors abandon a checkout page
- Find where users hit dead clicks
- List JavaScript errors seen in real sessions
- Share a problem session with a teammate

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http replay https://replay.agentfirststack.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://replay.agentfirststack.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "replay": {
      "url": "https://replay.agentfirststack.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "replay": {
      "type": "http",
      "url": "https://replay.agentfirststack.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "replay": {
      "serverUrl": "https://replay.agentfirststack.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "replay": {
      "type": "http",
      "url": "https://replay.agentfirststack.com/mcp"
    }
  }
}
```

## FAQ

### Is it an alternative to Hotjar?

The README names Hotjar and Microsoft Clarity as the tools it replaces.

### Is data masked?

Yes, masking in the browser is on by default.

### Can I self-host?

Yes, on Cloudflare Workers.

### Is it free?

It is described as free to use and open source.

### Is AgentFirstStack Replay free?

Yes. AgentFirstStack Replay is open source, so you can use and self-host it for free.

### How do I add AgentFirstStack Replay to Claude Code?

Run this command in your terminal: claude mcp add --transport http replay https://replay.agentfirststack.com/mcp

### What are the best alternatives to AgentFirstStack Replay?

The closest alternatives to AgentFirstStack Replay are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/agentfirststack-replay
