delete_user_collection_folder
Remove an empty folder from a user's Discogs collection by specifying the username and folder ID. Ensure the folder is vacant before deletion.
Instructions
Delete a folder from a user's collection. A folder must be empty before it can be deleted.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| folder_id | Yes | ||
| username | Yes |
Implementation Reference
- src/tools/userCollection.ts:87-104 (handler)The MCP Tool object defining the 'delete_user_collection_folder' tool, including its execute handler which delegates to UserService.collection.deleteFolderexport const deleteUserCollectionFolderTool: Tool< FastMCPSessionAuth, typeof UserCollectionFolderParamsSchema > = { name: 'delete_user_collection_folder', description: `Delete a folder from a user's collection. A folder must be empty before it can be deleted.`, parameters: UserCollectionFolderParamsSchema, execute: async (args) => { try { const userService = new UserService(); await userService.collection.deleteFolder(args); return 'Folder deleted successfully'; } catch (error) { throw formatDiscogsError(error); } }, };
- Core implementation of the deleteFolder method in UserCollectionService, performing the Discogs API DELETE request to delete the collection folderasync deleteFolder({ username, folder_id }: UserCollectionFolderParams): Promise<void> { try { await this.request<void>(`/${username}/collection/folders/${folder_id}`, { method: 'DELETE', }); } catch (error) { if (isDiscogsError(error)) { throw error; } // For unexpected errors, wrap them throw new Error(`Failed to delete folder: ${String(error)}`); } }
- src/types/user/collection.ts:76-77 (schema)Zod schema for the input parameters of the delete_user_collection_folder tool (username and folder_id)export const UserCollectionFolderParamsSchema = UsernameInputSchema.merge(FolderIdParamSchema());
- src/tools/userCollection.ts:325-325 (registration)Registration of the delete_user_collection_folder tool with the FastMCP serverserver.addTool(deleteUserCollectionFolderTool);
- src/tools/userCollection.ts:320-335 (helper)Function that registers all user collection tools, including deleteUserCollectionFolderTool, to the MCP serverexport function registerUserCollectionTools(server: FastMCP): void { server.addTool(getUserCollectionFoldersTool); server.addTool(createUserCollectionFolderTool); server.addTool(getUserCollectionFolderTool); server.addTool(editUserCollectionFolderTool); server.addTool(deleteUserCollectionFolderTool); server.addTool(findReleaseInUserCollectionTool); server.addTool(getUserCollectionItemsTool); server.addTool(addReleaseToUserCollectionFolderTool); server.addTool(rateReleaseInUserCollectionTool); server.addTool(moveReleaseInUserCollectionTool); server.addTool(deleteReleaseFromUserCollectionFolderTool); server.addTool(getUserCollectionCustomFieldsTool); server.addTool(editUserCollectionCustomFieldValueTool); server.addTool(getUserCollectionValueTool); }