get_master_release_versions
Retrieve all release versions for a specific master recording from Discogs, including different formats, labels, countries, and release dates.
Instructions
Retrieves a list of all Releases that are versions of this master
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| master_id | Yes | ||
| format | No | ||
| label | No | ||
| released | No | ||
| country | No | ||
| page | No | ||
| per_page | No | ||
| sort | No | ||
| sort_order | No |
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)}`); } }