# OpenReplay MCP for AI Agents AI Agent Connect

> OpenReplay MCP. Debug web applications by pulling user sessions, technical events, and project data directly into your AI agent. Stop jumping between tabs to find why a user's checkout failed; just ask your agent to pull the logs and session data for a specific user ID.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_wnk1KautKpY80U2mk7obCeYB3o5isdyqsTp6s29d/ai-agent-connect
- **Tags:** session-replay, debugging, user-experience, error-tracking, web-analytics

## Description

Think about the frustration of a support ticket saying "the button didn't work" and having to hunt through a dashboard to find the right recording. This Connector lets you bring that data directly into your conversation with your AI agent. You can ask it to find the right project, pull up a specific user's history, or dig into the console logs of a failed session. It turns your AI into a specialized support engineer who can see what the user saw. Instead of manual searching, you're getting immediate context on technical errors or UX friction points. Since Vinkius hosts this among thousands of other connections, it's easy to plug into your existing workflow and start getting answers without switching windows. You get a clear picture of user behavior and technical hurdles in one place. It handles the heavy lifting of filtering through thousands of recordings so you can focus on the actual fix. You'll spend less time toggling between your browser and your code editor, and more time actually solving problems. You can see all clicks, all inputs, and all console errors that happened during a user's journey. This means you can reproduce bugs faster and understand where people are getting stuck in your product. It takes the guesswork out of troubleshooting by providing the raw data you need to make informed decisions about your app's performance.

## Tools

### get_session
Retrieve metadata for a single session. This helps you get a quick summary of a user's activity.

### list_projects
List all projects associated with your account. Use this to see which environments are available for inspection.

### list_sessions
Retrieve a list of sessions for a specific project. You can filter these by User ID to find specific journeys.

### search_users
Find users identified within a project. Use this to correlate support tickets with actual session recordings.

### list_session_events
Retrieve all technical and user events recorded during a session. This lets you see all clicks and console logs.

## Prompt Examples

**Prompt:** 
```
Find the last 3 sessions for user x@y.com in my production project.
```

**Response:** 
```
I've found the following recent sessions for x@y.com in your production project:

| Date | Duration | Session ID |
| :--- | :--- | :--- |
| Oct 24, 10:15 AM | 12m 30s | sess_8821 |
| Oct 24, 09:45 AM | 04m 12s | sess_8819 |
| Oct 23, 04:20 PM | 15m 01s | sess_8815 |

Would you like me to pull the logs for the most recent one?
```

**Prompt:** 
```
Show me the console logs for session ID sess_998.
```

**Response:** 
```
I've pulled the technical events for session **sess_998**. Here are the console logs:

- **02:14** - `Uncaught TypeError: Cannot read property 'id' of undefined`
- **02:15** - `Failed to load resource: status code 500`
- **02:16** - `User clicked 'Submit' button` (3 times in 2 seconds)

It looks like a validation error is preventing the form from submitting.
```

**Prompt:** 
```
List all projects in my account.
```

**Response:** 
```
I found 4 projects in your OpenReplay account:

1. **Main Web App** (ID: 12)
2. **Mobile Dashboard** (ID: 45)
3. **Staging Environment** (ID: 8)
4. **Internal Admin Tool** (ID: 99)

Which one would you like to explore?
```

## Capabilities

### Get metadata for a single session
Pull the core details of a specific user recording to understand the context of their visit.

### List all projects in your account
See every project connected to your account to quickly navigate between different environments.

### Fetch technical and user events
Grab all clicks, inputs, and console logs from a session to see exactly what went wrong.

### Filter sessions by user ID
Find specific user journeys by filtering session lists using a unique identifier.

### Search for users by email or ID
Locate specific users within your projects to link support tickets to actual session data.

## Use Cases

### Linking a support ticket to a session
A user reports a broken checkout. You ask your agent to find the last 3 sessions for that user's email and pull the logs using list_sessions.

### Debugging console errors
You see a spike in errors. You ask your agent to list the events for a specific session ID using list_session_events to see the console logs.

### Analyzing a new feature launch
You want to see how people use a new feature. You ask your agent to pull session data for the last 10 users in a specific project.

### Verifying a bug fix
You need to verify a fix. You ask your agent to get the metadata for a session where the bug was reported using get_session.

## Benefits

- Faster bug reproduction by using list_session_events to see console logs and clickstreams immediately.
- Quicker user lookups with search_users to link support tickets to actual session recordings without manual searching.
- Better UX insights by pulling sessions via list_sessions for specific projects to see how people navigate your app.
- Streamlined project management by using list_projects to quickly switch between different environments and apps.
- Immediate context for support by using get_session to grab session metadata the moment a user reports an issue.

## How It Works

The bottom line is you get session data and technical logs in your chat window instead of a separate dashboard.

1. Subscribe to this Connector via the Vinkius catalog.
2. Provide your OpenReplay API key in the configuration.
3. Ask your agent to find sessions, pull logs, or search for users.

## Frequently Asked Questions

**How can I use OpenReplay MCP to find specific user bugs?**
You can ask your agent to search for a user by their email or ID. It will find the correct user profile and then pull up their recent sessions so you can see exactly what they did before the bug happened.

**Can OpenReplay MCP show me console logs from a web session?**
Yes, it can pull all technical events including console logs, clicks, and inputs. This makes it easy to see the exact errors a user encountered without having to ask them for screenshots.

**How do I link a support ticket to an OpenReplay session?**
Just give your AI agent the user's email or ID from the ticket. The Connector will find the matching user in your project and list their recent sessions for you to review.

**Can I use OpenReplay MCP to see where users get stuck?**
Yes, you can pull session data for specific projects or users. This helps you see where users are clicking or where they are dropping off in a specific journey, like a sign-up flow.

**Does OpenReplay MCP work with my current AI client?**
Yes, it works with any MCP-compatible client like Claude, Cursor, or Windsurf. Once you connect it through Vinkius, your agent can access your OpenReplay data directly.

**Can I see technical logs and console errors for a specific session?**
Yes! Use the `list_session_events` tool with a Session ID. It will retrieve all recorded technical and user events, including clicks, inputs, and console logs.

**How do I find sessions for a specific user email?**
First, use `search_users` with the email and Project ID to find the user. Then, use `list_sessions` with that User ID to see all their recorded activity.

**Does this integration support self-hosted OpenReplay instances?**
Yes. You can provide an optional `OPENREPLAY_BASE_URL` during setup to point the agent to your private instance instead of the default cloud API.