Printify MCP Server

Implementation Reference

• src/services/printify-shops.ts:120-168 (handler)

  The core handler function `switchPrintifyShop` that performs shop validation, switches the current shop using the Printify client, and formats the response.

  export async function switchPrintifyShop(printifyClient: PrintifyAPI, shopId: string) {
    try {
      // Validate client is initialized
      if (!printifyClient) {
        throw new Error('Printify API client is not initialized. The PRINTIFY_API_KEY environment variable may not be set.');
      }
      
      // Get shops and find the requested shop
      const shops = await printifyClient.getShops();
      const shop = shops.find((s: any) => s.id.toString() === shopId);
      
      if (!shop) {
        throw new Error(`Shop with ID ${shopId} not found. Use the list-shops tool to see available shops.`);
      }
      
      // Switch to the requested shop
      printifyClient.setShopId(shopId);
      
      return {
        success: true,
        shop,
        response: {
          content: [{
            type: "text",
            text: `Switched to shop: ${shop.title} (ID: ${shop.id}, Channel: ${shop.sales_channel})`
          }]
        }
      };
    } catch (error: any) {
      console.error('Error switching Printify shop:', error);
      
      return {
        success: false,
        error,
        errorResponse: formatErrorResponse(
          error,
          'Switch Printify Shop',
          {
            ShopId: shopId
          },
          [
            'Check that the shop ID is valid',
            'Use the list-shops tool to see available shops',
            'Ensure your Printify account is properly connected'
          ]
        )
      };
    }
  }

• src/index.ts:149-179 (registration)

  MCP server registration of the 'switch_shop' tool, defining the input schema (shopId: string) and wrapper that imports and calls the handler function.

  server.tool(
    "switch_shop",
    {
      shopId: z.string().describe("The ID of the shop to switch to")
    },
    async ({ shopId }): Promise<{ content: any[], isError?: boolean }> => {
      // Import the printify shops service
      const { switchPrintifyShop } = await import('./services/printify-shops.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 switchPrintifyShop(printifyClient, shopId);
  
      // 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:152-153 (schema)

  Zod input schema for the switch_shop tool, requiring a shopId string.

    shopId: z.string().describe("The ID of the shop to switch to")
  },