Carbon Voice

Instructions

Implementation Reference

• src/server.ts:665-689 (handler)

  The registration and inline handler function for the MCP tool 'get_folder_with_messages'. It authenticates using the provided token and calls the generated simplifiedApi.getFolderMessages with the folder ID to retrieve the folder and its direct messages.
  server.registerTool( 'get_folder_with_messages', { description: 'Get a folder including its messages by its ID. (Only messages at folder level are returned.)', inputSchema: getFolderMessagesParams.shape, annotations: { readOnlyHint: true, destructiveHint: false, }, }, async (args: GetByIdParams, { authInfo }): Promise<McpToolResponse> => { try { return formatToMCPToolResponse( await simplifiedApi.getFolderMessages( args.id, setCarbonVoiceAuthHeader(authInfo?.token), ), ); } catch (error) { logger.error('Error getting folder with messages:', { error }); return formatToMCPToolResponse(error); } }, );
• src/generated/carbon-voice-api/CarbonVoiceSimplifiedAPI.zod.ts:1129-1131 (schema)

  Zod input schema definition for the getFolderMessages API endpoint, used as inputSchema for the tool: requires a folder 'id' string.
  export const getFolderMessagesParams = zod.object({ "id": zod.string() })
• src/interfaces/get-by-id.interface.ts:1-3 (schema)

  TypeScript interface GetByIdParams used in the tool handler function arguments, defining the expected input shape { id: string }.
  export interface GetByIdParams { id: string; }