sentry_capture_session

Capture session data for application monitoring by recording session identifiers, user activity, duration, and error counts to track performance and health.

Instructions

Manually capture a session for server-mode/request-mode

Input Schema

TableJSON Schema

Name	Required	Description	Default
`sessionId`	Yes	Unique session identifier
`distinctId`	No	User identifier
`status`	No	Session status	ok
`duration`	No	Session duration in seconds
`errors`	No	Number of errors in session

Implementation Reference

src/index.ts:966-999 (handler)

The handler function for the 'sentry_capture_session' tool. It extracts parameters, constructs session data, adds a breadcrumb to Sentry for monitoring, and returns a confirmation message.

case "sentry_capture_session": {
  const { sessionId, distinctId, status = "ok", duration, errors = 0 } = args as any;
  
  // Capture session data manually (useful for server-mode)
  const sessionData = {
    sid: sessionId,
    did: distinctId,
    status,
    duration,
    errors,
    timestamp: Date.now() / 1000,
    attrs: {
      release: config.release,
      environment: config.environment || "production",
    },
  };
  
  // Log session for monitoring
  Sentry.addBreadcrumb({
    category: "session",
    message: `Session ${sessionId} captured`,
    level: "info",
    data: sessionData,
  });
  
  return {
    content: [
      {
        type: "text",
        text: `Session captured: ${sessionId} (status: ${status}, duration: ${duration}s, errors: ${errors})`,
      },
    ],
  };
}

src/index.ts:355-387 (schema)

The input schema definition for the 'sentry_capture_session' tool, defining parameters like sessionId, distinctId, status, duration, and errors.

{
  name: "sentry_capture_session",
  description: "Manually capture a session for server-mode/request-mode",
  inputSchema: {
    type: "object",
    properties: {
      sessionId: {
        type: "string",
        description: "Unique session identifier",
      },
      distinctId: {
        type: "string",
        description: "User identifier",
      },
      status: {
        type: "string",
        enum: ["ok", "exited", "crashed", "abnormal", "errored"],
        description: "Session status",
        default: "ok",
      },
      duration: {
        type: "number",
        description: "Session duration in seconds",
      },
      errors: {
        type: "number",
        description: "Number of errors in session",
        default: 0,
      },
    },
    required: ["sessionId"],
  },
},

src/index.ts:355-387 (registration)

Registration of the 'sentry_capture_session' tool in the ListTools response, including name, description, and schema.

{
  name: "sentry_capture_session",
  description: "Manually capture a session for server-mode/request-mode",
  inputSchema: {
    type: "object",
    properties: {
      sessionId: {
        type: "string",
        description: "Unique session identifier",
      },
      distinctId: {
        type: "string",
        description: "User identifier",
      },
      status: {
        type: "string",
        enum: ["ok", "exited", "crashed", "abnormal", "errored"],
        description: "Session status",
        default: "ok",
      },
      duration: {
        type: "number",
        description: "Session duration in seconds",
      },
      errors: {
        type: "number",
        description: "Number of errors in session",
        default: 0,
      },
    },
    required: ["sessionId"],
  },
},

MCP Sentry para Cursor