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;
  }