# Zakeke MCP > Zakeke manages custom product designs, 3D configurations, and e-commerce orders. Your agent connects to Zakeke to list customer-created artwork, pull pricing for complex 3D compositions, monitor order status, and instantly retrieve print-ready ZIP files needed for fulfillment. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** 3d-configurator, product-customization, visual-merchandising, order-management, e-commerce-api, design-automation ## Description This MCP lets your agent handle the messy data flow that happens between a custom design being created and it actually shipping. Need to know what kind of wood was used on an order placed last week? Or do you need the high-res vector file for 50 units of a mug designed three months ago? Your agent handles those questions instantly, pulling details from customer designs, complex 3D compositions, and entire orders—all without you having to log into the Zakeke dashboard. When you combine this with other services via Vinkius, it gets powerful. For instance, if you have a separate inventory MCP and a messaging MCP, your agent can first check `list_products` for availability, then use that data to draft an order summary in the messaging platform—all from one conversation flow. This ability to chain multiple systems together means you build automations that span everything from design to billing, keeping all your custom goods operations running through a single AI chat interface. ## Tools ### get_cart_info Retrieves current information about a product in the shopping cart, specifically related to its 3D setup. ### list_compositions Lists all available 3D product configurations that can be built from base parts. ### get_design_print_files Downloads a ZIP archive containing all high-resolution, print-ready output files for a specified design. ### list_designs Retrieves a list of every customer-created design record in the system. ### get_composition_details Pulls detailed technical specifications and pricing for a specific combination of 3D products. ### get_design_details Fetches comprehensive details about any visual design created by the customer. ### get_order_details Gets the full record and details for a single customer order. ### list_orders Provides an overview and list of all customized product orders placed through the platform. ### list_products Lists every base product available for customization in the catalog. ## Prompt Examples **Prompt:** ``` Show me all visual designs created by customers today in Zakeke. ``` **Response:** ``` I've retrieved the latest designs. You have 12 new designs today, including a 'Custom Coffee Mug' and a 'Photo T-Shirt'. Would you like to see the details for any of them? ``` **Prompt:** ``` List my customized product orders from Zakeke. ``` **Response:** ``` I found 8 orders with customized items. Notable ones include Order #ZK-1001 and #ZK-1002. All are currently 'In Production'. ``` **Prompt:** ``` Get the print-ready ZIP for design ID 'DESIGN_12345'. ``` **Response:** ``` I've retrieved the production files for design 'DESIGN_12345'. You can download the ZIP archive containing high-resolution PDFs and vectors here. ``` ## Capabilities ### Review Product Lists Get lists of available products for customization or list every customer-created artwork. ### Check Order Status Retrieve full details on a specific order, letting you see what was bought and its current fulfillment stage. ### Inspect Custom Designs Pull detailed information about any visual design created by the customer to check specs and attributes. ### View 3D Composition Data Get pricing and technical details for complex product assemblies, like a chair with custom cushions. ### Generate Print Assets Instantly download a ZIP file containing all high-resolution output files needed to manufacture the design. ## Use Cases ### QC Check on Fulfillment A production manager needs to confirm if the materials specified in an order match the original customer design. The agent runs `get_order_details`, then uses that data to cross-reference with `get_design_details` to ensure accuracy before printing. ### Inventory Audit The operations team needs a quick count of all custom designs created this month. They ask the agent, which calls `list_designs`, getting an immediate summary without opening the main dashboard panel. ### Cart Validation A customer is trying to buy three different customized items on a single checkout page. The agent runs `get_cart_info` to validate that all necessary technical data and pricing are correct before proceeding with the sale. ### Historical Review A developer needs product specs for an old order. They ask the agent, which calls `list_orders`, then uses `get_order_details` to retrieve the exact composition data needed for a new app feature. ## Benefits - Fulfillment speeds up because you can instantly get the necessary print-ready files for manufacturing using `get_design_print_files`. No more manual file downloads or FTP transfers. - You avoid logging into multiple systems by letting your agent query both `list_designs` (customer intent) and `list_orders` (actual purchase data) in a single chat session. - The system handles complex pricing logic for assemblies. You can check the full cost structure using `get_composition_details` without needing to calculate it manually. - Because your agent uses Vinkius, you get full visibility into what happened: every tool call and piece of data flowing through is audited, so nothing happens in the dark. - You don't lose time cross-referencing. If a customer asks about an order, the agent can pull `get_order_details` and immediately check that design against `get_design_details` for validation. ## How It Works The bottom line is you get to manage complex product customization workflows using natural language conversation, not dashboard clicks or API calls. 1. Subscribe to this MCP and enter your Zakeke API Key and Secret. 2. Connect your preferred AI client (like Claude or Cursor) through Vinkius. The credentials pass through a zero-trust proxy, so they never sit on disk. 3. Ask your agent a question like, 'Find the print files for design ID XYZ,' and it executes the necessary steps. ## Frequently Asked Questions **How do I check if an order contains customized products using get_order_details?** Yes, the `get_order_details` tool provides a full record of the purchase. It tells you exactly what was bought and gives you enough context to cross-reference with design information. **Can I list all custom designs created by customers using list_designs?** Yep, `list_designs` is your go-to. It pulls a complete inventory of every visual design record that exists in the system for quick auditing or review. **What tool do I use to get pricing for complex products? Is it get_composition_details?** That's right. Use `get_composition_details`. It’s designed specifically to handle the pricing and attributes of product assemblies, which is much more granular than just checking a single product listing. **If I want print files for a design, do I use get_design_print_files?** Yes, `get_design_print_files` retrieves the necessary ZIP file of all high-resolution outputs. It’s built to hand off production assets directly. **How can I see what products are available for sale? Do I need list_products?** `list_products` is exactly what you need. It gives you a clean, current roster of all base items that customers can use to build custom goods. **If I want to see all available 3D product configurations, should I use list_compositions?** Yes. This function lists every standard composition available in the system. Use it first to validate IDs or check general inventory before trying to retrieve details for a specific item. **How do I get all the attributes for one specific customer design, should I use get_design_details?** It pulls every attribute and detail set for a single known design ID. This is better than just listing designs because you get structured data needed for immediate actions like pricing or material validation. **What does get_cart_info provide, and when should I use it?** This tool gives you real-time status on items added to a shopping cart. You run this just before checkout to ensure the 3D configuration is still valid and priced correctly for the current session. **How do I get the print-ready files for a customer design?** Use the `get_design_print_files` tool with the design ID to retrieve the production-ready ZIP file metadata and URL. **Can I check the price of a 3D configuration for a specific quantity?** Yes, the `get_composition_details` and `get_design_details` tools accept an optional `quantity` parameter to calculate updated pricing. **Is it possible to see all products available for customization?** Absolutely. Use the `list_products` tool to retrieve the full catalog of items currently configured for customization in your Zakeke account.