OpenReplay MCP Server

An MCP (Model Context Protocol) server that provides AI-powered analytics for OpenReplay sessions. This server enables LLMs to query and analyze user sessions through OpenReplay's API.

Authentication Methods

API Key Authentication (Current)

The server currently uses API key authentication which provides access to:

List all projects
Get user sessions by user ID
Get session events
User details

Note: API key authentication has limited access. For full functionality (session search, metrics, funnels, etc.), JWT authentication is required.

JWT Authentication (Future)

Full access to all OpenReplay features including:

Complete session search with filters
Performance metrics and analytics
Funnel analysis
Error tracking and aggregation
Custom dashboards and metrics

Installation

npm install
npm run build

Configuration

Copy .env.example to .env:

cp .env.example .env

Configure your OpenReplay credentials:

# OpenReplay API URL
# For cloud: https://api.openreplay.com (default)
# For self-hosted: Your instance URL
OPENREPLAY_API_URL=https://api.openreplay.com

# Organization API Key (find in Preferences > Account > Organization API Key)
OPENREPLAY_API_KEY=your_organization_api_key

# Project key from your project settings
OPENREPLAY_PROJECT_KEY=your_project_key

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "openreplay": {
      "command": "node",
      "args": ["/path/to/openreplay-mcp/dist/index.js"],
      "env": {
        "OPENREPLAY_API_URL": "https://api.openreplay.com",
        "OPENREPLAY_API_KEY": "your_organization_api_key",
        "OPENREPLAY_PROJECT_KEY": "your_project_key"
      }
    }
  }
}

Available Tools

search_sessions

Search and filter sessions with various criteria like date range, user properties, errors, performance metrics.

get_session_details

Get detailed information about a specific session including all events, errors, network requests, console logs.

get_session_events

Get all events from a session with optional filtering by event type.

aggregate_sessions

Aggregate session data with various metrics and groupings (count, avg_duration, error_rate, bounce_rate, etc.).

get_user_journey

Get the complete journey of a user across multiple sessions.

get_errors_issues

Get errors and issues with their impact and affected sessions.

get_funnel_analysis

Analyze user funnels and conversion paths with custom step definitions.

get_performance_metrics

Get performance metrics like page load times, LCP, TTI with percentiles.

execute_custom_query

Execute custom queries for advanced analysis (SQL-like syntax for ClickHouse).

Example Queries

Once connected, you can ask the LLM questions like:

"What are the most common drop-off points in our checkout flow?"
"Show me the longest user sessions from the last week"
"What JavaScript errors are affecting the most users?"
"Analyze the user journey for users who converted vs those who didn't"
"What pages have the worst performance metrics?"
"Find patterns in sessions that resulted in errors"
"Show me the bounce rate by device type and country"

Development

# Run in development mode
npm run dev

# Build for production
npm run build

# Start production server
npm start

License

MIT

Deploy Server

HTTP connection URL

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Enables AI-powered analytics for OpenReplay user sessions through natural language queries. Supports session search, user journey analysis, error tracking, performance metrics, and funnel analysis to understand user behavior patterns.

Related MCP Servers

Plausible MCP Server
AVIMBU
-
security
F
license
-
quality
Allows AI models to query and retrieve analytics data from Plausible Analytics through the Plausible API, enabling natural language interactions with website statistics.
Last updated -
SEO Review Tools - MCP serverofficial
SEO-Review-Tools
A
security
F
license
A
quality
Get access to real-time SEO data, including: keyword insights, backlink data, traffic estimates and more. Allow AI tools and Large Language Models (LLMs) to tap into the real-time SEO Review Tools API with natural language commands.
Last updated -
8
1
2
SuperDataAnalysis - DataMaster_MCP
szqshan
-
security
F
license
-
quality
Provides powerful data analysis capabilities for AI systems with functions for data import/export, SQL querying, statistical analysis, and data processing.
Last updated -
9
New Relic MCP Server
piekstra
-
security
A
license
-
quality
Enables AI assistants to interact with New Relic monitoring and observability data through programmatic access to New Relic APIs. Supports APM management, NRQL queries, alert policies, synthetic monitoring, dashboards, infrastructure monitoring, and deployment tracking.
Last updated -
2
MIT License

View all related MCP servers

OpenReplay MCP Server