get_blueprint
Retrieve detailed product blueprint data from Printify's print-on-demand platform by specifying a blueprint ID. Enables AI assistants to integrate and manage product information effectively.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| blueprintId | Yes | Blueprint ID |
Implementation Reference
- Main handler function implementing the get_blueprint tool logic: fetches blueprint from Printify API, handles errors, formats MCP-compatible response.export async function getBlueprint( printifyClient: PrintifyAPI, blueprintId: 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 blueprint const blueprint = await printifyClient.getBlueprint(blueprintId); return { success: true, blueprint, response: { content: [{ type: "text", text: `Blueprint details for ID ${blueprintId}:\n\n${JSON.stringify(blueprint, null, 2)}` }] } }; } catch (error: any) { console.error('Error getting blueprint:', error); return { success: false, error, errorResponse: formatErrorResponse( error, 'Get Blueprint', { BlueprintId: blueprintId }, [ 'Check that the blueprint ID is valid', 'Check that your Printify API key is valid', 'Ensure your Printify account is properly connected' ] ) }; }
- src/index.ts:459-489 (registration)MCP tool registration for 'get_blueprint': defines schema, thin wrapper handler that calls the service function.server.tool( "get_blueprint", { blueprintId: z.string().describe("Blueprint ID") }, async ({ blueprintId }): Promise<{ content: any[], isError?: boolean }> => { // Import the printify blueprints service const { getBlueprint } = 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 getBlueprint(printifyClient, blueprintId); // 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:461-463 (schema)Zod input schema for the get_blueprint tool: requires blueprintId string.{ blueprintId: z.string().describe("Blueprint ID") },
- src/printify-api.ts:416-424 (helper)PrintifyAPI helper method that wraps the Printify SDK catalog.getBlueprint call.async getBlueprint(blueprintId: string) { try { // Use the catalog.getBlueprint method return await this.client.catalog.getBlueprint(blueprintId); } catch (error) { console.error(`Error fetching blueprint ${blueprintId}:`, error); throw error; } }