list_products

Implementation Reference

• src/index.ts:184-215 (registration)

  Registration of the 'list_products' MCP tool using server.tool(). Defines Zod schema for 'page' (optional, default 1) and 'limit' (optional, default 10) inputs, dynamically imports listProducts from the service, checks printifyClient, and delegates to the handler.

  server.tool(
    "list_products",
    {
      page: z.number().optional().default(1).describe("Page number"),
      limit: z.number().optional().default(10).describe("Number of products per page")
    },
    async ({ page, limit }): Promise<{ content: any[], isError?: boolean }> => {
      // Import the printify products service
      const { listProducts } = await import('./services/printify-products.js');
  
      // Check if client is initialized
      if (!printifyClient) {
        return {
          content: [{
            type: "text",
            text: "Printify API client is not initialized. The PRINTIFY_API_KEY environment variable may not be set."
          }],
          isError: true
        };
      }
  
      // Call the service
      const result = await listProducts(printifyClient, { page, limit });
  
      // Return the result
      if (result.success) {
        return result.response as { content: any[], isError?: boolean };
      } else {
        return result.errorResponse as { content: any[], isError: boolean };
      }
    }
  );

• src/services/printify-products.ts:10-66 (handler)

  The core handler function 'listProducts' that executes the tool logic. Validates a shop is selected, calls printifyClient.getProducts() with limit/page, and returns formatted success or error responses.

  export async function listProducts(
    printifyClient: PrintifyAPI,
    options: {
      limit?: number;
      page?: number;
    } = {}
  ) {
    try {
      // Validate shop is selected
      const currentShop = printifyClient.getCurrentShop();
      if (!currentShop) {
        throw new Error('No shop is currently selected. Use the list-shops and switch-shop tools to select a shop.');
      }
  
      // Set default options
      const limit = options.limit || 10;
      const page = options.page || 1;
  
      // Get products
      const products = await printifyClient.getProducts(limit, page);
  
      return {
        success: true,
        products,
        response: formatSuccessResponse(
          'Products Retrieved Successfully',
          {
            Count: products.length,
            Page: page,
            Limit: limit,
            Shop: currentShop
          }
        )
      };
    } catch (error: any) {
      console.error('Error listing products:', error);
  
      return {
        success: false,
        error,
        errorResponse: formatErrorResponse(
          error,
          'List Products',
          {
            Shop: printifyClient.getCurrentShop(),
            Limit: options.limit,
            Page: options.page
          },
          [
            'Check that your Printify API key is valid',
            'Ensure your Printify account is properly connected',
            'Make sure you have selected a shop'
          ]
        )
      };
    }
  }

• src/printify-api.ts:162-185 (helper)

  The PrintifyAPI.getProducts() helper method that performs the actual API call via the Printify SDK's products.list() method with pagination parameters, falling back to mock empty data on error.

  // Get a list of products
  async getProducts(page = 1, limit = 10) {
    if (!this.shopId) {
      throw new Error('Shop ID is not set. Call setShopId() first.');
    }
  
    try {
      try {
        // Use the products.list method with pagination parameters
        console.log(`Fetching products for shop ${this.shopId}, page ${page}, limit ${limit}`);
        const response = await this.client.products.list({ page, limit });
        return response;
      } catch (sdkError) {
        console.error('Error fetching products from Printify API:', sdkError);
  
        // Return mock products for testing
        console.log('Returning mock products...');
        return { data: [] };
      }
    } catch (error) {
      console.error('Error fetching products:', error);
      throw error;
    }
  }