Discogs MCP Server

Instructions

Implementation Reference

• src/tools/marketplace.ts:43-60 (handler)

  The MCP tool definition including the execute handler function that creates an order message using MarketplaceService.

  export const createMarketplaceOrderMessageTool: Tool<
    FastMCPSessionAuth,
    typeof OrderCreateMessageParamsSchema
  > = {
    name: 'create_marketplace_order_message',
    description: `Adds a new message to the order's message log`,
    parameters: OrderCreateMessageParamsSchema,
    execute: async (args) => {
      try {
        const marketplaceService = new MarketplaceService();
        const message = await marketplaceService.createOrderMessage(args);
  
        return JSON.stringify(message);
      } catch (error) {
        throw formatDiscogsError(error);
      }
    },
  };

• src/types/marketplace.ts:196-199 (schema)

  Zod schema defining the input parameters for the create_marketplace_order_message tool, extending OrderIdParamSchema with optional message and status.

  export const OrderCreateMessageParamsSchema = OrderIdParamSchema.extend({
    message: z.string().optional(),
    status: OrderStatusSchema.optional(),
  });

• src/tools/marketplace.ts:250-250 (registration)

  Registers the createMarketplaceOrderMessageTool with the FastMCP server instance.

  server.addTool(createMarketplaceOrderMessageTool);

• src/tools/index.ts:17-17 (registration)

  Calls registerMarketplaceTools which includes the marketplace order message tool registration.

  registerMarketplaceTools(server);