Printify MCP Server

Implementation Reference

• src/services/printify-products.ts:71-117 (handler)

  Core handler function that executes the get_product tool logic: validates selected shop, fetches product details from Printify API client, formats success or error response.

  export async function getProduct(
    printifyClient: PrintifyAPI,
    productId: string
  ) {
    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.');
      }
  
      // Get product
      const product = await printifyClient.getProduct(productId);
  
      return {
        success: true,
        product,
        response: formatSuccessResponse(
          'Product Retrieved Successfully',
          {
            ProductId: productId,
            Title: product.title,
            Shop: currentShop
          }
        )
      };
    } catch (error: any) {
      console.error('Error getting product:', error);
  
      return {
        success: false,
        error,
        errorResponse: formatErrorResponse(
          error,
          'Get Product',
          {
            ProductId: productId,
            Shop: printifyClient.getCurrentShop()
          },
          [
            'Check that the product ID is valid',
            'Ensure your Printify account is properly connected',
            'Make sure you have selected a shop'
          ]
        )
      };
    }

• src/index.ts:218-248 (registration)

  Registers the 'get_product' MCP tool, defines input schema (productId: string), provides wrapper handler that initializes service and delegates to core handler.

  server.tool(
    "get_product",
    {
      productId: z.string().describe("Product ID")
    },
    async ({ productId }): Promise<{ content: any[], isError?: boolean }> => {
      // Import the printify products service
      const { getProduct } = 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 getProduct(printifyClient, productId);
  
      // 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:220-222 (schema)

  Zod input schema for get_product tool requiring productId as string.

  {
    productId: z.string().describe("Product ID")
  },

• src/printify-api.ts:188-200 (helper)

  Low-level helper method in PrintifyAPI client that calls Printify SDK to retrieve product by ID.

  async getProduct(productId: string) {
    if (!this.shopId) {
      throw new Error('Shop ID is not set. Call setShopId() first.');
    }
  
    try {
      // Use the products.getOne method with the product ID
      return await this.client.products.getOne(productId);
    } catch (error) {
      console.error(`Error fetching product ${productId}:`, error);
      throw error;
    }
  }