# Gelato MCP for AI Agents AI Agent Connect > Gelato MCP lets you manage your print-on-demand business through your AI agent. You can create orders, check product catalogs, grab shipping quotes, and track fulfillment status without leaving your chat interface. It connects your Gelato account directly to tools like Claude or Cursor so you can handle the logistics of global production in real-time. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_AwikCo5SDU7YCKQtxtazisxcgQLfCg8YsFhfaYUg/ai-agent-connect - **Tags:** print-on-demand, fulfillment, dropshipping, inventory-management, global-shipping, custom-products ## Description This Connector lets you pull your entire print-on-demand operation into your AI's workspace. Instead of jumping between tabs to check if a batch of shirts is ready or where a package is currently located, you can just ask your agent for the latest update. It handles the heavy lifting of navigating the dashboard by letting you create new global orders, pull specific product specs, and get real-time shipping quotes for different regions. You'll see exactly what's in your catalogs and which webhooks are active, making it way easier to keep your internal systems synced. Whether you're trying to figure out production costs for a new merch drop or need to grab a tracking number for a frustrated customer, this connection gives your agent the eyes it needs to see your business. It's a big part of why Vinkius is the go-to for getting these kinds of specialized workflows running quickly. You get a clear view of your account metadata and fulfillment statuses, turning a manual logistics headache into a simple conversation. ## Tools ### create_print_order Place a new global print order for your custom products. Use this to kick off production for new sales. ### get_order_status Fetch specific details and status for a single order. Use this to get a deep dive on one shipment. ### verify_api_connection Check if your Gelato account is properly linked to the Connector. This ensures your agent has the correct permissions. ### cancel_print_order Stop a print order before it enters production. This helps you manage mistakes quickly. ### get_account_info View your account identity and basic metadata. It's useful for verifying your connection status. ### get_product_details Retrieve detailed specifications for a specific product UID. This gives you the exact specs for any item. ### get_shipping_quote Request a real-time quote for production and shipping costs. This helps you price your items accurately. ### list_product_catalogs See all available product categories and catalogs. This helps you see the full range of what you can sell. ### list_print_orders Get a full list of all orders in your account. Use this for a high-level overview of your current volume. ### list_catalog_products View the specific items available within a selected catalog. This is great for checking inventory variety. ### get_order_shipments Pull tracking numbers and real-time shipment data. Use this to give customers precise delivery updates. ### list_print_webhooks View the webhooks configured for your production updates. This ensures your external systems stay in sync. ## Prompt Examples **Prompt:** ``` I need to know the shipping cost for a heavy hoodie going to Germany. ``` **Response:** ``` ### Shipping Quote for Germany | Item | Production Cost | Shipping | Total Quote | | :--- | :--- | :--- | :--- | | Heavy Hoodie | $12.50 | $14.20 | **$26.70** | * **Estimated Production Time:** 3-5 business days * **Carrier:** DHL Express * **Note:** Prices are in USD and based on standard weight. ``` **Prompt:** ``` List my last 5 print orders and tell me which ones have shipped. ``` **Response:** ``` ### Recent Print Orders * **ORD-9921**: Shipped (Tracking: 1Z999...) ✅ * **ORD-9925**: In Production 🛠️ * **ORD-9920**: Shipped (Tracking: 1Z888...) ✅ * **ORD-9918**: Processing ⏳ * **ORD-9917**: Shipped (Tracking: 1Z777...) ✅ ``` **Prompt:** ``` What products are in the 'T-Shirts' catalog? ``` **Response:** ``` ### Apparel Catalog: T-Shirts I found the following items available for print: * **Classic Crewneck** (UID: shirt_001) * **V-Neck Tee** (UID: shirt_002) * **Oversized Heavy Tee** (UID: shirt_003) * **Pocket Tee** (UID: shirt_004) Would you like the specific metadata for any of these? ``` ## Capabilities ### Create new print orders Place global orders for your custom products directly through your chat. ### Fetch shipping quotes Get real-time pricing for production and delivery costs in different regions. ### Track shipment progress Retrieve tracking numbers and current shipment status for every order. ### Browse product catalogs See what items are available for printing across different categories. ### Monitor order statuses Get metadata and status updates for all active orders in your account. ### Manage webhooks View and verify the webhooks configured for your production updates. ## Use Cases ### Answering a customer about a lost package A customer asks where their hoodie is. Use get_order_shipments to grab the tracking number and share it immediately with the buyer. ### Pricing a new product for a specific country You need to price a new shirt for the UK. Use get_shipping_quote to see the production and shipping costs for that region instantly. ### Planning a new merchandise drop You're planning a new collection. Use list_product_catalogs and list_catalog_products to see what's available to print for your fans. ### Halting a mistaken production order You need to stop a wrong order from being printed. Use cancel_print_order to halt production before it's too late. ## Benefits - Get real-time shipping quotes using get_shipping_quote to price your products accurately before you sell. - Stop manual dashboard jumping by using list_print_orders to see every order in one view. - Speed up support by pulling tracking numbers with get_order_shipments for instant customer replies. - Build better merch plans by pulling specs with get_product_details and list_product_catalogs. - Keep your systems synced by checking your list_print_webhooks status to ensure data flows correctly. ## How It Works The bottom line is you get a direct line to your print-on-demand logistics without ever opening a browser tab. 1. Subscribe to the Gelato MCP via the Vinkius Marketplace. 2. Add your Gelato API key from the Developers section of your dashboard. 3. Ask your AI client to list orders, check catalogs, or get quotes. ## Frequently Asked Questions **Can the Gelato MCP help me manage my print-on-demand store?** Yes. It lets you handle your entire order lifecycle, from creating new print jobs to checking fulfillment status, directly through your AI agent. **How do I get shipping quotes with Gelato MCP?** You can simply ask your agent to check the shipping and production costs for any product in a specific region. It pulls live data to give you an accurate price. **Can I cancel orders using the Gelato MCP?** Yes, you can use the Connector to halt production on an order if you need to make a change or stop a shipment before it leaves the facility. **Does Gelato MCP work with my existing webhooks?** It does. You can use the Connector to view and verify your webhook configurations to make sure your store is receiving real-time updates. **Is Gelato MCP good for checking product specs?** Absolutely. It allows your agent to pull specific product UIDs and metadata, so you can quickly see what's available to print without manual searching. **How does Gelato MCP speed up my customer support?** It lets your team grab tracking numbers and order details instantly. Instead of looking them up in a dashboard, your agent can provide them in seconds. **How do I get an API Key for Gelato?** Log in to your Gelato dashboard, navigate to Developers > API keys, and you can generate a new production or test key there. **What is the difference between an Order ID and a Reference ID?** The Order ID is generated by Gelato, while the Reference ID is your own internal identifier passed during order creation to map the records. **Can I cancel an order via the agent?** Yes, use the 'cancel_print_order' tool. Note that cancellation is only possible if the order status is still 'created' and production hasn't started. **How do I find the correct product UID?** Use the 'list_catalog_products' tool to browse available items. The agent will return the unique 'productUid' needed for order creation.