Carbon Voice

Instructions

Implementation Reference

• src/server.ts:487-529 (registration)

  Full registration of the 'summarize_conversation' tool, including the inline anonymous handler function that implements the tool's logic by fetching messages if necessary and calling the AI response API to generate a summary.
  server.registerTool( 'summarize_conversation', { description: 'Summarize a conversation.', inputSchema: summarizeConversationParams.shape, annotations: { readOnlyHint: false, destructiveHint: false, }, }, async ( args: SummarizeConversationParams, { authInfo }, ): Promise<McpToolResponse> => { try { let message_ids: string[] = args.message_ids || []; // If no message ids are provided, get couple of messages from the conversation if (!args.message_ids) { const messages = await simplifiedApi.listMessages( args, setCarbonVoiceAuthHeader(authInfo?.token), ); message_ids = messages.results?.map((message) => message.id) || []; } const aiResponse = await simplifiedApi.aIResponseControllerCreateResponse( { prompt_id: args.prompt_id, message_ids: message_ids, channel_id: args.conversation_id, language: args.language, }, setCarbonVoiceAuthHeader(authInfo?.token), ); return formatToMCPToolResponse(aiResponse); } catch (error) { logger.error('Error summarizing conversation:', { error }); return formatToMCPToolResponse(error); } }, );
• src/server.ts:497-528 (handler)

  The anonymous async handler function that executes the core logic of the summarize_conversation tool: conditionally lists recent messages from the conversation, then invokes the AI response controller with a specific prompt to generate the summary.
  async ( args: SummarizeConversationParams, { authInfo }, ): Promise<McpToolResponse> => { try { let message_ids: string[] = args.message_ids || []; // If no message ids are provided, get couple of messages from the conversation if (!args.message_ids) { const messages = await simplifiedApi.listMessages( args, setCarbonVoiceAuthHeader(authInfo?.token), ); message_ids = messages.results?.map((message) => message.id) || []; } const aiResponse = await simplifiedApi.aIResponseControllerCreateResponse( { prompt_id: args.prompt_id, message_ids: message_ids, channel_id: args.conversation_id, language: args.language, }, setCarbonVoiceAuthHeader(authInfo?.token), ); return formatToMCPToolResponse(aiResponse); } catch (error) { logger.error('Error summarizing conversation:', { error }); return formatToMCPToolResponse(error); } },
• src/schemas/conversation.ts:3-11 (schema)

  Zod schema defining the input parameters for the summarize_conversation tool, including conversation_id, prompt_id, optional message_ids, language, date ranges, and limit.
  export const summarizeConversationParams = z.object({ conversation_id: z.string().nonempty(), prompt_id: z.string().nonempty(), message_ids: z.array(z.string()).optional(), language: z.string().optional(), start_date: z.string().datetime().optional(), end_date: z.string().datetime().optional(), limit: z.number().optional().default(50), });
• src/interfaces/conversation.interface.ts:8-10 (schema)

  TypeScript type definition for SummarizeConversationParams, inferred from the Zod schema for type safety in the handler.
  export type SummarizeConversationParams = z.infer< typeof summarizeConversationParams >;