Skip to main content

​
MCP Server

Replay exposes an MCP (Model Context Protocol) server that lets AI agents interact with your Replay workspace. Use it from Claude Desktop, Cursor, or any MCP-compatible client to manage roleplays, scripts, courses, and more through natural language.

​
Available Tools

​
Roleplays

ToolDescription
list_roleplaysList all roleplays with optional live/draft filter.
get_roleplayGet detailed roleplay configuration including persona, scorecard, and variables.
create_roleplayCreate a new roleplay with persona, scorecard, and configuration.
update_roleplayUpdate a roleplay’s title, instructions, objective, passing score, or live status.
archive_roleplaySoft-delete a roleplay.

​
Sessions

ToolDescription
list_sessionsList roleplay sessions with scores, pass/fail, and user info.
get_session_resultsGet detailed scoring results for a completed session.

​
Scripts

ToolDescription
list_scriptsList all script memorization activities.
get_scriptGet a script’s segments and configuration.
create_scriptCreate a new script with dialog segments.

​
Rapid Fire

ToolDescription
list_rapid_firesList all rapid fire objection handling activities with objection counts.
get_rapid_fireGet a rapid fire’s objections and configuration.
create_rapid_fireCreate a new rapid fire with objections.

​
Courses

ToolDescription
list_coursesList all courses in your workspace.
get_courseGet a course’s details and assignments.
create_courseCreate a new course.

​
Building Blocks — Personas

ToolDescription
list_personasList all customer personas with usage counts.
create_personaCreate a new persona with voice and avatar settings.
update_personaUpdate a persona (checks for shared usage — see Building Block Safety).
archive_personaPermanently delete a persona (checks for shared usage).

​
Building Blocks — Scorecards

ToolDescription
list_scorecardsList all scorecards with their sections.
create_scorecardCreate a new scorecard (add sections/criteria in the web editor).
update_scorecardUpdate a scorecard’s title (checks for shared usage).
archive_scorecardPermanently delete a scorecard (checks for shared usage).

​
Building Blocks — Variables & Variants

ToolDescription
list_variablesList all variables with their variants and usage counts.
get_variableGet a variable’s variants and usage details.
create_variableCreate a new variable with its first variant, linked to a roleplay.
create_variantAdd a new variant to an existing variable.
update_variantUpdate a variant’s name or content (checks for shared usage).
link_variant_to_roleplayLink a variant to a roleplay (add or switch).
unlink_variant_from_roleplayUnlink a variant from a roleplay. Only removes the association.
delete_variablePermanently delete a variable, all its variants, and all roleplay links.

​
Users & Teams

ToolDescription
list_usersList all users in your workspace with name, email, team, and role.
list_teamsList all teams in your workspace.
ToolDescription
global_searchFull-text search across all content types (roleplays, scripts, courses, etc.).

​
Building Block Safety

Personas, scorecards, and variants are shared resources — one persona can be used by many roleplays. To prevent accidental changes that affect multiple roleplays, the MCP server enforces a safety check:
  1. When you try to update or delete a shared building block, the tool lists all affected roleplays and refuses the change.
  2. To proceed, you must call the tool again with confirm_shared_edit: true — but only after the user has explicitly approved.
This ensures AI agents always get human confirmation before making changes that ripple across multiple roleplays.

​
Authentication

The MCP server uses OAuth 2.1 for authentication. When you connect an MCP client, it automatically:
  1. Discovers the OAuth server via /.well-known/oauth-protected-resource
  2. Redirects you to log in to your Replay account
  3. Shows a consent screen asking you to approve access
  4. Exchanges the authorization for an access token
All tool calls are scoped to your user and company — you can only access content in your own workspace.

​
Connecting from Claude Desktop

  1. Open Claude Desktop
  2. Go to Settings → Connectors
  3. Click Add Custom Connector
  4. Enter:
    • Name: Replay
    • URL: https://app.replay.sale/mcp
  5. Click Save
The first time you use a Replay tool, Claude will open a browser window for you to log in and authorize access. Once connected, you can ask Claude things like:
  • “List my roleplays in Replay”
  • “Show me the details of my Cold Call roleplay”
  • “Create a new roleplay for objection handling practice”
  • “Search for anything related to discovery calls”
  • “Show me session results for last week”

​
Connecting from Cursor

  1. Open Cursor Settings (Cmd+, on macOS)
  2. Navigate to MCP in the sidebar
  3. Click Add new MCP server
  4. Enter:
    • Name: Replay
    • Type: URL (Server-Sent Events)
    • URL: https://app.replay.sale/mcp
  5. Click Save
Cursor will prompt you to authenticate when you first use a Replay tool.

​
Connecting from Claude Code

Run this command in your terminal: 
claude mcp add --transport http replay https://app.replay.sale/mcp
Or add it manually to your project’s .mcp.json: 
{
  "mcpServers": {
    "replay": {
      "type": "url",
      "url": "https://app.replay.sale/mcp"
    }
  }
}

​
Replay Skills Plugin (Optional)

Replay offers a skills plugin that teaches Claude best practices for creating Replay content like scorecards, personas, and roleplays. This is separate from the MCP server — the MCP server gives Claude the tools to interact with Replay, while the plugin gives Claude the knowledge to use those tools well. The plugin works with both Claude Desktop and Claude Code.
  1. Download the plugin: replay-skills-plugin.zip
  2. Install it:
    • Claude Desktop: Go to Settings → Plugins, click Upload Plugin, and select the downloaded zip file.
    • Claude Code: Run claude plugin add --file /path/to/replay-skills-plugin.zip
The plugin is updated periodically. To get the latest version, re-download the zip and reinstall.

​
Testing with MCP Inspector

MCP Inspector is a developer tool for testing MCP servers interactively. 
npx @modelcontextprotocol/inspector
When the Inspector opens in your browser:
  1. Set the URL to https://app.replay.sale/mcp
  2. Set Transport to Streamable HTTP
  3. Click Connect
  4. Complete the OAuth login flow when prompted
  5. Use the Tools tab to explore all available tools

​
Troubleshooting

Make sure your Replay account is active and you can log in at app.replay.sale. If you’re redirected back to the consent page repeatedly, try clearing your browser cookies for app.replay.sale and reconnecting.
Your access token may have expired. Disconnect and reconnect the MCP server in your client to trigger a fresh OAuth flow.
Verify the URL is exactly https://app.replay.sale/mcp. If you were previously using https://app.replay.sale/mcp/mcp, update to the new shorter URL.
If a tool responds with a list of affected roleplays and asks for confirm_shared_edit, this is the safety check. Review the listed roleplays, confirm with the user, then call the tool again with confirm_shared_edit: true.