Discogs MCP Server

Instructions

Implementation Reference

• src/tools/marketplace.ts:103-117 (handler)

  MCP tool handler (execute function) for 'get_marketplace_order', which delegates to MarketplaceService.getOrder

  export const getMarketplaceOrderTool: Tool<FastMCPSessionAuth, typeof OrderIdParamSchema> = {
    name: 'get_marketplace_order',
    description: 'Get a marketplace order',
    parameters: OrderIdParamSchema,
    execute: async (args) => {
      try {
        const marketplaceService = new MarketplaceService();
        const order = await marketplaceService.getOrder(args);
  
        return JSON.stringify(order);
      } catch (error) {
        throw formatDiscogsError(error);
      }
    },
  };

• src/types/marketplace.ts:192-194 (schema)

  Input parameter schema for the tool: requires 'order_id' as a number.

  export const OrderIdParamSchema = z.object({
    order_id: z.number(),
  });

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

  Registration of the getMarketplaceOrderTool with the FastMCP server.

  server.addTool(getMarketplaceOrderTool);

• src/services/marketplace.ts:151-164 (helper)

  Implementation of getOrder in MarketplaceService, performs authenticated API request to Discogs /orders/{order_id} and validates response.

  async getOrder({ order_id }: OrderIdParam): Promise<OrderResponse> {
    try {
      const response = await this.request<OrderResponse>(`/orders/${order_id}`);
  
      const validatedResponse = OrderResponseSchema.parse(response);
      return validatedResponse;
    } catch (error) {
      if (isDiscogsError(error)) {
        throw error;
      }
  
      throw new Error(`Failed to get order: ${String(error)}`);
    }
  }