Printify MCP Server

Implementation Reference

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

  The core handler function that implements the list_products tool logic: validates shop selection, fetches paginated products from Printify API, handles errors, and formats success/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/index.ts:184-215 (registration)

  MCP server registration of the 'list_products' tool, including input schema validation with Zod, dynamic import of the handler, client checks, and response formatting.

  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/index.ts:187-189 (schema)

  Zod input schema for the list_products tool defining optional page and limit parameters with defaults and descriptions.

    page: z.number().optional().default(1).describe("Page number"),
    limit: z.number().optional().default(10).describe("Number of products per page")
  },