Printify MCP Server

Implementation Reference

• src/services/printify-blueprints.ts:161-207 (handler)

  The main handler function that fetches variants using the Printify API client, handles errors, and formats the MCP-compatible response.

  export async function getVariants(
    printifyClient: PrintifyAPI,
    blueprintId: string,
    printProviderId: 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 variants
      const variants = await printifyClient.getVariants(blueprintId, printProviderId);
      
      return {
        success: true,
        variants,
        response: {
          content: [{
            type: "text",
            text: `Variants for blueprint ID ${blueprintId} and print provider ID ${printProviderId}:\n\n${JSON.stringify(variants, null, 2)}`
          }]
        }
      };
    } catch (error: any) {
      console.error('Error getting variants:', error);
      
      return {
        success: false,
        error,
        errorResponse: formatErrorResponse(
          error,
          'Get Variants',
          {
            BlueprintId: blueprintId,
            PrintProviderId: printProviderId
          },
          [
            'Check that the blueprint ID is valid',
            'Check that the print provider ID is valid',
            'Check that your Printify API key is valid',
            'Ensure your Printify account is properly connected'
          ]
        )
      };
    }
  }

• src/index.ts:524-556 (registration)

  MCP server.tool registration for 'get_variants' including input schema (Zod) and thin wrapper handler that calls the main service handler.

  // Get variants tool
  server.tool(
    "get_variants",
    {
      blueprintId: z.string().describe("Blueprint ID"),
      printProviderId: z.string().describe("Print provider ID")
    },
    async ({ blueprintId, printProviderId }): Promise<{ content: any[], isError?: boolean }> => {
      // Import the printify blueprints service
      const { getVariants } = await import('./services/printify-blueprints.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 getVariants(printifyClient, blueprintId, printProviderId);
  
      // Return the result
      if (result.success) {
        return result.response as { content: any[], isError?: boolean };
      } else {
        return result.errorResponse as { content: any[], isError: boolean };
      }
    }
  );

• src/printify-api.ts:438-446 (helper)

  Helper method in PrintifyAPI class that wraps the Printify SDK call to retrieve blueprint variants for a specific print provider.

  async getVariants(blueprintId: string, printProviderId: string) {
    try {
      // Use the catalog.getBlueprintVariants method
      return await this.client.catalog.getBlueprintVariants(blueprintId, printProviderId);
    } catch (error) {
      console.error(`Error fetching variants for blueprint ${blueprintId} and print provider ${printProviderId}:`, error);
      throw error;
    }
  }