Quickstart

Run the following command to install the Replay MCP Skill:

• npm
• yarn
• pnpm
• bun

Terminal
npx skills add https://github.com/replayio/skills --skill '*'

• Claude Code
• Cursor
• VS Code
• Codex

Terminal
claude mcp add replay\
 --transport http https://dispatch.replay.io/nut/mcp\
 --header "Authorization: YOUR_API_KEY"

Refer to these docs to see how you can generate an API key.

Instruct your agent to open replay-cli. This will open the browser that records the activity. Replicate the issue that you want to debug. Once replicated, exit the browser completely.

Example prompt:

Please help me debug issues on my applcation. 
Use replay-cli skill to record my application running on localhost:3000. 
Then use Replay MCP to debug the recording.

Usually this is enough for Replay to debug your issue and provide your agent with enough information. The instruction will:

1. Record the activity
2. Notice when the browser is closed
3. Upload the recording to Replay DevTools (each recording has a unique id )
4. Call the Replay MCP server to fetch data from the recording
5. Your agent will then take care of the rest thanks to the analysis provided by Replay MCP