Discogs MCP Server

Instructions

Implementation Reference

• src/tools/userCollection.ts:43-60 (handler)

  MCP tool object defining the 'create_user_collection_folder' tool, including its execute handler that delegates to UserService.collection.createFolder
  export const createUserCollectionFolderTool: Tool< FastMCPSessionAuth, typeof UserCollectionFolderCreateParamsSchema > = { name: 'create_user_collection_folder', description: `Create a new folder in a user's collection`, parameters: UserCollectionFolderCreateParamsSchema, execute: async (args) => { try { const userService = new UserService(); const folder = await userService.collection.createFolder(args); return JSON.stringify(folder); } catch (error) { throw formatDiscogsError(error); } }, };
• src/types/user/collection.ts:66-68 (schema)

  Zod schema defining the input parameters for the create_user_collection_folder tool (username and optional folder name)
  export const UserCollectionFolderCreateParamsSchema = UsernameInputSchema.extend({ name: z.string().optional(), });
• src/tools/userCollection.ts:320-335 (registration)

  Registration function that adds the create_user_collection_folder tool (and others) to the FastMCP server via server.addTool(createUserCollectionFolderTool)
  export 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); }
• src/services/user/collection.ts:78-98 (helper)

  Core helper method in UserCollectionService that performs the actual Discogs API POST request to /${username}/collection/folders to create the folder
  async createFolder({ username, ...body }: UserCollectionFolderCreateParams): Promise<UserCollectionFolder> { try { const response = await this.request<UserCollectionFolder>(`/${username}/collection/folders`, { method: 'POST', body, }); // Validate the response using Zod schema const validatedResponse = UserCollectionFolderSchema.parse(response); return validatedResponse; } catch (error) { if (isDiscogsError(error)) { throw error; } throw new Error(`Failed to create folder: ${String(error)}`); } }
• src/services/user/index.ts:9-21 (helper)

  UserService class that composes UserCollectionService as 'collection' property, used by the tool handler to access createFolder method
  export class UserService { public collection: UserCollectionService; public lists: UserListsService; public profile: UserProfileService; public wants: UserWantsService; constructor() { this.collection = new UserCollectionService(); this.lists = new UserListsService(); this.profile = new UserProfileService(); this.wants = new UserWantsService(); } }