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);
}

Discogs MCP Server