Printify MCP Server

Implementation Reference

• src/index.ts:676-745 (registration)

  Registration of the 'set_default' MCP tool, including input schema (option: string, value: any) and the inline handler function. The handler checks if replicateClient is initialized, calls replicateClient.setDefault(option, value), retrieves all defaults, formats a response with model details if applicable, and returns formatted text content.
  server.tool( "set_default", { option: z.string().describe("The option name to set (e.g., 'model', 'aspectRatio', 'raw', etc.)"), value: z.any().describe("The value to set for the option") }, async ({ option, value }) => { try { if (!replicateClient) { return { content: [{ type: "text", text: "Replicate API client is not initialized. The REPLICATE_API_TOKEN environment variable may not be set." }], isError: true }; } // Set the default value replicateClient.setDefault(option, value); // Get all current defaults for the response const allDefaults = replicateClient.getAllDefaults(); // Format the response based on the option type let detailedResponse = ""; if (option === 'model') { // For model option, provide more detailed information const models = replicateClient.getAvailableModels(); const selectedModel = models.find(model => model.id === value); if (selectedModel) { detailedResponse = `## ${selectedModel.name} ✓ SELECTED\n` + `- ID: \`${selectedModel.id}\`\n` + `- Description: ${selectedModel.description}\n` + `- Capabilities: ${selectedModel.capabilities.join(', ')}\n` + `- Status: **Currently selected as default model**\n\n`; } } // Format all current defaults as a table const defaultsTable = Object.entries(allDefaults) .map(([key, val]) => `| ${key} | ${typeof val === 'object' ? JSON.stringify(val) : val} |`) .join('\n'); return { content: [{ type: "text", text: `# Default Setting Updated\n\n` + `Successfully set default \`${option}\` to: \`${value}\`\n\n` + detailedResponse + `## Current Default Settings\n\n` + `| Option | Value |\n` + `|--------|-------|\n` + defaultsTable + `\n\nThese settings will be used by default for all image generation unless overridden in the tool call.` }] }; } catch (error: any) { return { content: [{ type: "text", text: `Error setting default: ${error.message}` }], isError: true }; } } );
• src/model-manager.ts:61-78 (handler)

  Core handler logic for setting defaults in DefaultsManager class. Validates the option/value pair, handles special cases for aspectRatio/width/height, stores the value in defaults object, and logs the change. Called by ReplicateClient.setDefault.
  setDefault(option: string, value: any): void { // Validate the option and value this.validateOption(option, value); // Special handling for aspectRatio, width, and height if (option === 'aspectRatio') { // When setting aspectRatio, clear width and height delete this.defaults.width; delete this.defaults.height; } else if (option === 'width' || option === 'height') { // When setting width or height, clear aspectRatio delete this.defaults.aspectRatio; } // Set the default value this.defaults[option] = value; console.log(`Default ${option} set to: ${value}`); }
• src/replicate-client.ts:35-37 (helper)

  ReplicateClient.setDefault method that delegates to the underlying DefaultsManager.setDefault, providing the interface used by the MCP tool handler.
  setDefault(option: string, value: any): void { this.defaultsManager.setDefault(option, value); }
• src/index.ts:678-681 (schema)

  Input schema for the set_default tool using Zod: option (string) and value (any).
  { option: z.string().describe("The option name to set (e.g., 'model', 'aspectRatio', 'raw', etc.)"), value: z.any().describe("The value to set for the option") },