get_marketplace_listing
Retrieve specific marketplace listings from Discogs using a listing ID and optional currency abbreviation to manage and search music catalog data efficiently.
Instructions
Get a listing from the marketplace
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| curr_abbr | No | ||
| listing_id | Yes |
Implementation Reference
- src/tools/marketplace.ts:84-98 (handler)Defines the MCP tool 'get_marketplace_listing' including its handler function that executes the logic by calling MarketplaceService.getListing(args).export const getMarketplaceListingTool: Tool<FastMCPSessionAuth, typeof ListingGetParamsSchema> = { name: 'get_marketplace_listing', description: 'Get a listing from the marketplace', parameters: ListingGetParamsSchema, execute: async (args) => { try { const marketplaceService = new MarketplaceService(); const listing = await marketplaceService.getListing(args); return JSON.stringify(listing); } catch (error) { throw formatDiscogsError(error); } }, };
- src/types/marketplace.ts:167-169 (schema)Zod schema defining the input parameters for the get_marketplace_listing tool (extends ListingIdParamSchema with optional currency).export const ListingGetParamsSchema = ListingIdParamSchema.extend({ curr_abbr: CurrencyCodeSchema.optional(), });
- src/tools/marketplace.ts:240-252 (registration)Function that registers the getMarketplaceListingTool (among others) to the FastMCP server using server.addTool().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); }
- src/tools/index.ts:15-24 (registration)Top-level tool registration function that calls registerMarketplaceTools(server), indirectly registering get_marketplace_listing.export function registerTools(server: FastMCP): void { registerDatabaseTools(server); registerMarketplaceTools(server); registerInventoryExportTool(server); registerUserIdentityTools(server); registerUserCollectionTools(server); registerUserWantlistTools(server); registerUserListsTools(server); registerMediaTools(server); }