get_marketplace_release_stats
Retrieve detailed marketplace statistics for a specific music release on Discogs by providing the Release ID and currency abbreviation. Analyze pricing trends and availability.
Instructions
Retrieve marketplace statistics for the provided Release ID
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| curr_abbr | No | ||
| release_id | Yes |
Implementation Reference
- src/tools/marketplace.ts:163-178 (handler)The main handler (execute function) for the 'get_marketplace_release_stats' tool. It creates a MarketplaceService instance and calls getReleaseStats with the arguments, returning the JSON-stringified statistics or formatted error.export const getMarketplaceReleaseStatsTool: Tool<FastMCPSessionAuth, typeof ReleaseParamsSchema> = { name: 'get_marketplace_release_stats', description: 'Retrieve marketplace statistics for the provided Release ID', parameters: ReleaseParamsSchema, execute: async (args) => { try { const marketplaceService = new MarketplaceService(); const stats = await marketplaceService.getReleaseStats(args); return JSON.stringify(stats); } catch (error) { throw formatDiscogsError(error); } }, };
- src/types/release.ts:147-156 (schema)ReleaseParamsSchema defines the input parameters for the tool: requires release_id (number >0), optional curr_abbr (currency code).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/marketplace.ts:240-252 (registration)The registerMarketplaceTools function registers the getMarketplaceReleaseStatsTool (along with other marketplace tools) to the FastMCP server.export function registerMarketplaceTools(server: FastMCP): void { server.addTool(getUserInventoryTool); server.addTool(getMarketplaceListingTool); server.addTool(createMarketplaceListingTool); server.addTool(updateMarketplaceListingTool); server.addTool(deleteMarketplaceListingTool); server.addTool(getMarketplaceOrderTool); server.addTool(editMarketplaceOrderTool); server.addTool(getMarketplaceOrdersTool); server.addTool(getMarketplaceOrderMessagesTool); server.addTool(createMarketplaceOrderMessageTool); server.addTool(getMarketplaceReleaseStatsTool); }