delete_item_in_wantlist

Remove a music release from a Discogs user's wantlist by specifying the username and release ID.

Instructions

Delete a release from a user's wantlist

Input Schema

TableJSON Schema

Name	Required	Description	Default
`username`	Yes
`release_id`	Yes
`notes`	No
`rating`	No

Implementation Reference

src/tools/userWantlist.ts:68-85 (handler)

MCP tool object for 'delete_item_in_wantlist' including the handler execute function that delegates to UserService.wants.deleteItem

export const deleteItemInWantlistTool: Tool<
  FastMCPSessionAuth,
  typeof UserWantlistItemParamsSchema
> = {
  name: 'delete_item_in_wantlist',
  description: `Delete a release from a user's wantlist`,
  parameters: UserWantlistItemParamsSchema,
  execute: async (args) => {
    try {
      const userService = new UserService();
      await userService.wants.deleteItem(args);

      return 'Release deleted from wantlist';
    } catch (error) {
      throw formatDiscogsError(error);
    }
  },
};

src/types/user/wants.ts:31-36 (schema)

Zod schema defining input parameters for the tool: username, release_id, optional notes and rating

export const UserWantlistItemParamsSchema = UsernameInputSchema.merge(
  ReleaseIdParamSchema.extend({
    notes: z.string().optional(),
    rating: z.number().int().min(0).max(5).optional(),
  }),
);

src/tools/userWantlist.ts:87-92 (registration)

Registration function that adds the delete_item_in_wantlist tool (and related wantlist tools) to the FastMCP server

export function registerUserWantlistTools(server: FastMCP): void {
  server.addTool(getUserWantlistTool);
  server.addTool(addToWantlistTool);
  server.addTool(editItemInWantlistTool);
  server.addTool(deleteItemInWantlistTool);
}

src/tools/index.ts:21-21 (registration)
Invocation of registerUserWantlistTools in the main registerTools function, which registers all tools including delete_item_in_wantlist
```
registerUserWantlistTools(server);
```

src/services/user/wants.ts:125-139 (helper)

UserWantsService.deleteItem method that performs the actual Discogs API DELETE request to remove the release from the wantlist

async deleteItem({ username, release_id }: UserWantlistItemParams): Promise<void> {
  try {
    await this.request(`/${username}/wants/${release_id}`, {
      method: 'DELETE',
    });
  } catch (error) {
    // If it's already a Discogs error, just rethrow it
    if (isDiscogsError(error)) {
      throw error;
    }

    // For other unexpected errors, wrap them
    throw new Error(`Failed to delete from wantlist: ${String(error)}`);
  }
}

Discogs MCP Server