get_user_collection_folder
Retrieve metadata for a specific folder in a user's Discogs music collection using their username and folder ID.
Instructions
Retrieve metadata about a folder in a user's collection
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| username | Yes | ||
| folder_id | Yes |
Implementation Reference
- src/tools/userCollection.ts:197-214 (handler)Full definition and execute handler for the 'get_user_collection_folder' MCP tool. Handles input validation via schema, calls UserService.collection.getFolder, and returns folder metadata as JSON.export const getUserCollectionFolderTool: Tool< FastMCPSessionAuth, typeof UserCollectionFolderParamsSchema > = { name: 'get_user_collection_folder', description: `Retrieve metadata about a folder in a user's collection`, parameters: UserCollectionFolderParamsSchema, execute: async (args) => { try { const userService = new UserService(); const folder = await userService.collection.getFolder(args); return JSON.stringify(folder); } catch (error) { throw formatDiscogsError(error); } }, };
- src/types/user/collection.ts:76-76 (schema)Zod schema definition for input parameters of get_user_collection_folder tool: combines username and folder_id (minimum 0).export const UserCollectionFolderParamsSchema = UsernameInputSchema.merge(FolderIdParamSchema());
- src/tools/userCollection.ts:323-323 (registration)Registers the getUserCollectionFolderTool with the FastMCP server within the registerUserCollectionTools function.server.addTool(getUserCollectionFolderTool);
- src/tools/index.ts:20-20 (registration)Calls registerUserCollectionTools to register all user collection tools, including get_user_collection_folder, to the main server.registerUserCollectionTools(server);
- src/types/user/collection.ts:9-15 (schema)Supporting schema for folder_id parameter used in UserCollectionFolderParamsSchema.export const FolderIdParamSchema = (min?: number) => z.object({ folder_id: z .number() .int() .min(min ?? 0), });