create_marketplace_listing
Create a new marketplace listing on Discogs by specifying release details, condition, price, and status to sell music items.
Instructions
Create a new marketplace listing
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| release_id | Yes | ||
| condition | Yes | ||
| sleeve_condition | No | ||
| price | Yes | ||
| comments | No | ||
| allow_offers | No | ||
| status | Yes | ||
| external_id | No | ||
| location | No | ||
| weight | No | ||
| format_quantity | No |
Implementation Reference
- src/tools/marketplace.ts:23-38 (handler)The FastMCP Tool definition and handler (execute function) for the 'create_marketplace_listing' tool. It instantiates MarketplaceService and calls createListing with the input args.
export const createMarketplaceListingTool: Tool<FastMCPSessionAuth, typeof ListingNewParamsSchema> = { name: 'create_marketplace_listing', description: 'Create a new marketplace listing', parameters: ListingNewParamsSchema, execute: async (args) => { try { const marketplaceService = new MarketplaceService(); const listing = await marketplaceService.createListing(args); return JSON.stringify(listing); } catch (error) { throw formatDiscogsError(error); } }, }; - src/types/marketplace.ts:171-183 (schema)Zod schema defining the input parameters for the create_marketplace_listing tool (ListingNewParamsSchema).
export const ListingNewParamsSchema = z.object({ release_id: z.number().int(), condition: ConditionSchema, sleeve_condition: SleeveConditionSchema.optional(), price: z.number(), comments: z.string().optional(), allow_offers: z.boolean().optional(), status: SaleStatusSchema, external_id: z.string().optional(), location: z.string().optional(), weight: z.number().optional(), format_quantity: z.number().optional(), }); - src/tools/marketplace.ts:243-243 (registration)Registration of the createMarketplaceListingTool via server.addTool in the registerMarketplaceTools function.
server.addTool(createMarketplaceListingTool); - src/services/marketplace.ts:44-60 (helper)The MarketplaceService.createListing method, which performs the HTTP POST request to the Discogs API endpoint '/marketplace/listings' with the provided parameters, handling errors and validation.
async createListing(params: ListingNewParams): Promise<ListingNewResponse> { try { const response = await this.request<ListingNewResponse>(`/listings`, { method: 'POST', body: params, }); const validatedResponse = ListingNewResponseSchema.parse(response); return validatedResponse; } catch (error) { if (isDiscogsError(error)) { throw error; } throw new Error(`Failed to create listing: ${String(error)}`); } } - src/tools/marketplace.ts:240-252 (registration)The registerMarketplaceTools function that registers all marketplace-related tools, including create_marketplace_listing.
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); }