get_master_release_versions
Retrieve a list of releases linked to a specific master by providing master ID, format, label, release date, country, and sorting options for organized results.
Instructions
Retrieves a list of all Releases that are versions of this master
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | ||
| format | No | ||
| label | No | ||
| master_id | Yes | ||
| page | No | ||
| per_page | No | ||
| released | No | ||
| sort | No | ||
| sort_order | No |
Implementation Reference
- src/tools/database.ts:157-174 (handler)MCP tool handler definition for get_master_release_versions, which delegates to MasterReleaseService.getVersions().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:15-27 (schema)Zod schemas defining the input parameters for the tool: base MasterReleaseIdParamSchema and extended MasterReleaseVersionsParamSchema.export const MasterReleaseIdParamSchema = z.object({ master_id: z.number().int(), }); /** * Schema for a master release versions parameter */ 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/services/master.ts:51-69 (helper)Core service method getVersions() that performs the API request to Discogs /masters/{master_id}/versions endpoint.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)}`); } }
- src/tools/database.ts:253-266 (registration)Registration function for database tools, including server.addTool(getMasterReleaseVersionsTool).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/tools/index.ts:15-24 (registration)Top-level tool registration function that invokes registerDatabaseTools(server), indirectly registering the tool.export function registerTools(server: FastMCP): void { registerDatabaseTools(server); registerMarketplaceTools(server); registerInventoryExportTool(server); registerUserIdentityTools(server); registerUserCollectionTools(server); registerUserWantlistTools(server); registerUserListsTools(server); registerMediaTools(server); }