list_products
Retrieve a paginated list of products from Printify's print-on-demand platform. Specify page number and limit to filter results for efficient product management.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of products per page | |
| page | No | Page number |
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") },