Discogs MCP Server

Instructions

Implementation Reference

• src/tools/database.ts:179-193 (handler)

  MCP tool handler for 'get_release': instantiates ReleaseService and calls its get method to fetch release data, serializes to JSON.

  export const getReleaseTool: Tool<FastMCPSessionAuth, typeof ReleaseParamsSchema> = {
    name: 'get_release',
    description: 'Get a release',
    parameters: ReleaseParamsSchema,
    execute: async (args) => {
      try {
        const releaseService = new ReleaseService();
        const release = await releaseService.get(args);
  
        return JSON.stringify(release);
      } catch (error) {
        throw formatDiscogsError(error);
      }
    },
  };

• src/types/release.ts:147-156 (schema)

  Input schema for get_release tool: requires release_id, optional curr_abbr.

  export const ReleaseIdParamSchema = z.object({
    release_id: z.number().min(1, 'The release_id must be non-zero'),
  });
  
  /**
   * Schema for release parameters
   */
  export const ReleaseParamsSchema = ReleaseIdParamSchema.extend({
    curr_abbr: CurrencyCodeSchema.optional(),
  });

• src/tools/database.ts:254-254 (registration)

  Registers the getReleaseTool with the FastMCP server instance.

  server.addTool(getReleaseTool);

• src/tools/index.ts:16-16 (registration)

  Calls registerDatabaseTools which includes adding the get_release tool to the server. (Indirect registration)

  registerDatabaseTools(server);