Discogs MCP Server

Instructions

Implementation Reference

• src/tools/database.ts:157-174 (handler)

  Tool handler implementation for 'get_master_release_versions'. Creates MasterReleaseService instance and calls getVersions method with input args, serializes response to JSON.

  export const getMasterReleaseVersionsTool: Tool<
    FastMCPSessionAuth,
    typeof MasterReleaseVersionsParamSchema
  > = {
    name: 'get_master_release_versions',
    description: 'Retrieves a list of all Releases that are versions of this master',
    parameters: MasterReleaseVersionsParamSchema,
    execute: async (args) => {
      try {
        const masterReleaseService = new MasterReleaseService();
        const masterReleaseVersions = await masterReleaseService.getVersions(args);
  
        return JSON.stringify(masterReleaseVersions);
      } catch (error) {
        throw formatDiscogsError(error);
      }
    },
  };

• src/types/master.ts:22-27 (schema)

  Input schema (parameters) for the get_master_release_versions tool using Zod validation, extending MasterReleaseIdParamSchema with optional filters.

  export const MasterReleaseVersionsParamSchema = MasterReleaseIdParamSchema.extend({
    format: z.string().optional(),
    label: z.string().optional(),
    released: z.string().optional(),
    country: z.string().optional(),
  }).merge(QueryParamsSchema(['released', 'title', 'format', 'label', 'catno', 'country']));

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

  Registration function that adds the get_master_release_versions tool (line 260: server.addTool(getMasterReleaseVersionsTool)) to the FastMCP server.

  export function registerDatabaseTools(server: FastMCP): void {
    server.addTool(getReleaseTool);
    server.addTool(getReleaseRatingTool);
    server.addTool(editReleaseRatingTool);
    server.addTool(deleteReleaseRatingTool);
    server.addTool(getReleaseCommunityRatingTool);
    server.addTool(getMasterReleaseTool);
    server.addTool(getMasterReleaseVersionsTool);
    server.addTool(getArtistTool);
    server.addTool(getArtistReleasesTool);
    server.addTool(getLabelTool);
    server.addTool(getLabelReleasesTool);
    server.addTool(searchTool);
  }

• src/services/master.ts:51-69 (helper)

  Core helper method in MasterReleaseService that performs the HTTP request to Discogs API for master release versions and validates the response.

  async getVersions({
    master_id,
    ...options
  }: MasterReleaseVersionsParam): Promise<MasterReleaseVersionsResponse> {
    try {
      const response = await this.request<MasterReleaseVersionsResponse>(`/${master_id}/versions`, {
        params: options,
      });
  
      const validatedResponse = MasterReleaseVersionsResponseSchema.parse(response);
      return validatedResponse;
    } catch (error) {
      if (isDiscogsError(error)) {
        throw error;
      }
  
      throw new Error(`Failed to get master release versions: ${String(error)}`);
    }
  }