Skip to content
MCP server

AgentFirstStack Replay

Session replay turned into readable transcripts, with rage clicks, errors and heatmaps

Install
Pricing
Open source
Platforms
API, self-hosted, Web
Runs
Remotely
Version
0.1.1
Listing updated
3 days ago

About AgentFirstStack Replay

AgentFirstStack Replay is an open-source MCP server for analytics and data. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://replay.agentfirststack.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "replay": {
      "url": "https://replay.agentfirststack.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Open source

Free hosted; open source

Prices change. Check agentfirststack.com before you buy.

AgentFirstStack Replay 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 to AgentFirstStack Replay

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data