add_release_to_user_collection_folder
Add a music release to a specific folder in your Discogs collection. Organize your vinyl records and CDs by categorizing them into designated collection folders.
Instructions
Add a release to a folder in a user's collection. The folder_id must be non-zero.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| username | Yes | ||
| folder_id | Yes | ||
| release_id | Yes |
Implementation Reference
- src/tools/userCollection.ts:21-38 (handler)MCP tool handler: defines the tool with name 'add_release_to_user_collection_folder', schema, description, and execute function that delegates to UserService.collection.addReleaseToFolderexport const addReleaseToUserCollectionFolderTool: Tool< FastMCPSessionAuth, typeof UserCollectionFolderReleaseParamsSchema > = { name: 'add_release_to_user_collection_folder', description: `Add a release to a folder in a user's collection. The folder_id must be non-zero.`, parameters: UserCollectionFolderReleaseParamsSchema, execute: async (args) => { try { const userService = new UserService(); const release = await userService.collection.addReleaseToFolder(args); return JSON.stringify(release); } catch (error) { throw formatDiscogsError(error); } }, };
- src/types/user/collection.ts:81-83 (schema)Input schema: UserCollectionFolderReleaseParamsSchema defining username, folder_id (min 1), release_idexport const UserCollectionFolderReleaseParamsSchema = UsernameInputSchema.merge( FolderIdParamSchema(1).merge(ReleaseIdParamSchema), );
- src/tools/userCollection.ts:320-335 (registration)Registration: registerUserCollectionTools function adds the tool to the FastMCP server instanceexport 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); }
- Core logic helper: UserCollectionService.addReleaseToFolder performs the POST request to Discogs API to add the release to the folder and validates responseasync addReleaseToFolder({ username, folder_id, release_id, }: UserCollectionFolderReleaseParams): Promise<UserCollectionReleaseAdded> { try { const response = await this.request<UserCollectionReleaseAdded>( `/${username}/collection/folders/${folder_id}/releases/${release_id}`, { method: 'POST', }, ); const validatedResponse = UserCollectionReleaseAddedSchema.parse(response); return validatedResponse; } catch (error) { if (isDiscogsError(error)) { throw error; } throw new Error(`Failed to add release to folder: ${String(error)}`); } }