OpenReplay MCP Server

Instructions

Implementation Reference

• src/index.ts:378-390 (handler)

  The handler function implementing the logic for the get_session_details tool. It notes that full details are unavailable with API key auth and recommends alternatives.

  private async getSessionDetails(args: any) {
    const { sessionId } = args;
    // Session replay details not available via v1 API
    // Only events are available
    return {
      content: [
        {
          type: "text",
          text: "Session replay details are not available via API key authentication. Use get_session_events instead or use JWT authentication for full access.",
        },
      ],
    };
  }

• src/index.ts:113-119 (schema)

  Input schema for the get_session_details tool, defining a required 'sessionId' string parameter.

  inputSchema: {
    type: "object",
    properties: {
      sessionId: { type: "string", description: "The session ID to retrieve" }
    },
    required: ["sessionId"]
  }

• src/index.ts:110-120 (registration)

  Registration of the get_session_details tool in the ListTools response, including name, description, and input schema.

  {
    name: "get_session_details",
    description: "Get detailed information about a specific session including all events, errors, network requests, console logs, custom events, and performance metrics",
    inputSchema: {
      type: "object",
      properties: {
        sessionId: { type: "string", description: "The session ID to retrieve" }
      },
      required: ["sessionId"]
    }
  },

• src/index.ts:280-281 (registration)

  Dispatch case in the CallToolRequestHandler that routes calls to the getSessionDetails handler method.

  case "get_session_details":
    return await this.getSessionDetails(args);