# Gelato MCP > Gelato manages your entire print-on-demand (POD) workflow directly through natural conversation. This MCP lets you list active orders, fetch detailed product catalogs, track real-time shipments globally, and calculate shipping quotes before placing a new order. Manage customs paperwork, verify API connections, and keep your custom merchandise production running without ever touching the dashboard. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** print-on-demand, fulfillment, dropshipping, inventory-management, global-shipping, custom-products ## Description Managing print-on-demand fulfillment usually means hopping between five different tabs: the order list, the product catalog, the tracking page, the pricing sheet, and the webhook logs. This MCP changes that. It connects to your Gelato account so you can handle every step of the custom merchandise lifecycle using just your agent's chat window. Need to know if an item is in stock or what a specific design costs to ship? Just ask. You can pull up current product catalogs and retrieve specifications instantly, then check the real-time shipping status for any order. It also lets you place new orders and even cancel them if something changes. Because this whole setup runs through Vinkius, your agent gets instant access to all these functions, letting you manage everything from initial quote requests to final shipment tracking without ever leaving your chat client. ## Tools ### verify_api_connection Checks your API access credentials to make sure the connection is live. ### create_print_order Places a brand new custom merchandise order with Gelato. ### cancel_print_order Cancels an existing print order if the customer changes their mind or the design is flawed. ### get_account_info Retrieves basic details about your Gelato account identity and setup. ### get_order_status Gets detailed information on a specific order's current fulfillment status. ### get_product_details Fetches comprehensive metadata for an individual product using its unique ID. ### get_shipping_quote Calculates the estimated cost of shipping and production for a potential order location. ### list_product_catalogs Shows all available product catalogs that Gelato supports, like T-shirts or mugs. ### list_print_orders Lists every print order currently recorded in your account. ### list_catalog_products Displays all the specific products available within a chosen catalog. ### get_order_shipments Tracks the real-time shipment details and carrier information for any order. ### list_print_webhooks Lists all webhooks you've configured to receive production updates from Gelato. ## Prompt Examples **Prompt:** ``` List all my active print orders and their current status. ``` **Response:** ``` Retrieving orders... I found 5 active print orders, including 'ORD-99' (Status: In Production) and 'ORD-101' (Status: Shipped). Would you like the tracking details for the shipped one? ``` **Prompt:** ``` Get the shipping details for order 'gelato_12345'. ``` **Response:** ``` Fetching shipments... Order gelato_12345 has been shipped via DHL. The tracking number is '1Z999...' and the estimated delivery is October 15th. ``` **Prompt:** ``` List all products in the 'Apparel' catalog (ID: cat_987). ``` **Response:** ``` Retrieving products... In the Apparel catalog, I found 12 items including 'Classic T-Shirt' (UID: shirt_001) and 'Premium Hoodie' (UID: hood_05). ``` ## Capabilities ### Reviewing Account Status You can verify the API connection and check account details to ensure continuous production flow. ### Managing Orders The agent can list existing orders, create new print jobs, or cancel an order if necessary. ### Product Research You retrieve product metadata and access available catalogs to see what items you can sell. ### Shipping & Pricing The MCP requests real-time quotes for shipping costs across different regions, or tracks the shipment details for any given order. ### System Monitoring You can list all configured webhooks and check account identity to keep your internal systems up-to-date with production changes. ## Use Cases ### The Support Team Needs Tracking Data A customer emails asking about their shipment. Instead of telling the customer to log in and check, you ask your agent to call `get_order_shipments` using the order ID. Your agent responds instantly with the carrier name, tracking number, and ETA. ### Launching a New Product Line A creative director needs to confirm if their new design works on both hoodies and shirts globally. They use `list_product_catalogs` first, then check specific item data using `get_product_details`, confirming availability before committing to an order. ### Handling Bulk Order Changes The marketing team needs to change or stop a pending large run. They ask the agent to list all active jobs with `list_print_orders`, identify the target job, and then call `cancel_print_order` immediately. ### Pre-Sale Pricing Check A client asks for a quote on 100 custom mugs to be shipped from Mexico. You use your agent to execute `get_shipping_quote`, providing the necessary region and quantity data to get an accurate, real-time price. ## Benefits - You instantly check order status by calling `get_order_status`, eliminating the need to navigate complex, multi-step dashboard menus just to see if an item is 'In Production'. - Instead of manually checking product guides, you use `list_product_catalogs` and then `list_catalog_products` to get a comprehensive overview of every available merchandise type. - When pricing a new custom run, you don't guess the cost. You call `get_shipping_quote` to instantly calculate real-time production and shipping rates for any region. - You keep your system accurate by using `list_print_webhooks`, ensuring that internal systems receive automated alerts whenever Gelato updates a job. - If an order needs adjusting, you can quickly call `create_print_order` or `cancel_print_order` right from the chat interface instead of logging into the dedicated fulfillment dashboard. ## How It Works The bottom line is you talk to your AI client, and it executes the complex logistics tasks across Gelato for you. 1. Subscribe to this MCP through the Vinkius Marketplace. 2. Enter your Gelato API Key into the connection settings (found in Developers > API keys). 3. Start chatting with your agent; it now has access to all your POD fulfillment tools. ## Frequently Asked Questions **How do I check if my API key is working with the Gelato MCP?** Call the `verify_api_connection` tool. This instantly checks your credentials and confirms that the connection between your agent and Gelato is active. **Can the Gelato MCP help me list all my past orders?** Yes, you can use `list_print_orders` to retrieve a complete list of every job recorded in your account. This is useful for auditing or finding old IDs. **What tool do I use if I need to know the shipping cost?** Use the `get_shipping_quote` tool. You provide the product type and destination, and it returns a real-time quote for both production and shipping. **Does Gelato MCP only track shipped items?** No, you can use `list_product_catalogs` first to see what's available. Then, if needed, you can use `get_order_status` to check the job status before it ships. **How do I add a new product type using Gelato MCP?** The MCP doesn't create products; it reads them. Use `list_product_catalogs` and then `list_catalog_products` to see every option available for you to use.