Carbon Voice

Instructions

Implementation Reference

• src/server.ts:720-745 (registration)

  Registration of the 'delete_folder' MCP tool, including schema reference, annotations (destructive), and handler that invokes simplifiedApi.deleteFolder

  server.registerTool(
    'delete_folder',
    {
      description:
        'Delete a folder by its ID. Deleting a folder will also delete nested folders and all the messages in referenced folders. ' +
        '(This is a destructive action and cannot be undone, so please be careful.)',
      inputSchema: deleteFolderParams.shape,
      annotations: {
        readOnlyHint: false,
        destructiveHint: true,
      },
    },
    async (args: GetByIdParams, { authInfo }): Promise<McpToolResponse> => {
      try {
        return formatToMCPToolResponse(
          await simplifiedApi.deleteFolder(
            args.id,
            setCarbonVoiceAuthHeader(authInfo?.token),
          ),
        );
      } catch (error) {
        logger.error('Error deleting folder:', { error });
        return formatToMCPToolResponse(error);
      }
    },
  );

• src/generated/carbon-voice-api/CarbonVoiceSimplifiedAPI.zod.ts:1364-1366 (schema)

  Zod input schema for delete_folder tool: requires a string 'id' for the folder to delete.

  export const deleteFolderParams = zod.object({
    "id": zod.string()
  })

• src/generated/carbon-voice-api.ts:609-617 (handler)

  Core handler function in generated API that performs the HTTP DELETE request to delete the folder and its contents.

  const deleteFolder = (
    id: string,
    options?: SecondParameter<typeof mutator>,
  ) => {
    return mutator<void>(
      { url: `/simplified/folders/${id}`, method: 'DELETE' },
      options,
    );
  };