# GrazeCart MCP > GrazeCart MCP lets you control your entire perishable food business from natural conversation. Track orders, update stock levels for specific products, and manage customer details without logging into a dashboard. It connects directly to your GrazeCart account so your AI agent handles fulfillment operations instantly. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** food-delivery, perishable-goods, farm-to-table, order-fulfillment, payment-processing, inventory-tracking ## Description Running a farm-to-table operation means juggling fresh inventory, tracking payments, and managing logistics—all while the orders roll in. This MCP lets you run those processes through plain conversation with your AI client. Instead of clicking into separate tabs for stock levels, customer records, and pending orders, you just tell your agent what you need. Your system handles checking product availability, updating order statuses, or even triggering payment charges when an item ships out. You can look up specific customer profiles to verify details or list all active delivery zones for planning routes. By connecting this MCP through Vinkius, your AI client becomes the central operational hub, letting you manage every step of the perishable supply chain from one place. ## Tools ### charge_order Triggers a payment charge for an order when it needs to be finalized. ### create_customer Creates a brand new customer profile within the store. ### get_customer Retrieves all contact and profile details for one specific existing customer. ### get_order Gets detailed information for a single, specified order number. ### get_product Retrieves full details about one specific product in the catalog. ### list_customers Provides a list of all customer accounts registered in the store. ### list_delivery_zones Outputs a list of all delivery zones currently configured for shipping. ### list_orders Generates a comprehensive list of all orders placed in the GrazeCart store. ### list_pickup_locations Lists every active physical location where customers can pick up items. ### list_products Shows a list of all products available in the store catalog. ### update_inventory Changes the stock count for any specific product or variant. ### update_order Makes changes to an existing order, such as changing the shipping address or status. ## Prompt Examples **Prompt:** ``` List my recent orders in GrazeCart ``` **Response:** ``` Retrieving your orders... I found 3 recent orders: #1001 ($145.00), #1002 ($82.50), and #1003 ($210.00). Would you like to see the details for the latest order? ``` **Prompt:** ``` Check the inventory for 'Grass-fed Ribeye' ``` **Response:** ``` Checking products... 'Grass-fed Ribeye' (ID: 452) has 12 units currently available in stock. There are also 5 units reserved for pending orders. ``` **Prompt:** ``` Process the payment for order #1001 ``` **Response:** ``` Processing payment... Success! I've triggered the payment charge for Order #1001. The transaction status is now 'Success'. ``` ## Capabilities ### Process Orders Check current orders, find specific details about a shipment, and update an order's status directly. ### Manage Inventory Levels See what products you have in stock and change the count for any product variant to prevent overselling. ### Handle Customers Search for customer profiles, get their contact info, or even create a new record if they don't exist. ### Charge Payments Trigger payment charges against specific orders to finalize transactions. ### Check Logistics List active pickup spots and delivery zones needed for planning the day's routes. ## Use Cases ### Stock Check Before Fulfillment A manager needs to process 50 orders for specialty cheeses. Instead of manually checking stock one by one, they ask their agent: 'What's the current count for all artisanal cheddars?' The agent uses `list_products` and checks inventory using `get_product` to confirm availability before allowing fulfillment. ### Handling a Payment Failure A customer's card fails during checkout. The support agent asks their agent to check the order details using `get_order`, confirms the failure, and then uses `update_order` to flag the shipment as pending payment. ### Onboarding a New Client A new corporate client calls for bulk orders. Instead of creating their account in a separate system, the agent uses `create_customer`, captures their details, and then immediately checks their zone eligibility using `list_delivery_zones`. ### Updating Product Info The farm receives a new harvest of berries. The owner tells their agent to update the stock level for 'Seasonal Berries' by 50 units, which runs the `update_inventory` tool instantly. ## Benefits - You save time by using `get_order` and `list_orders` to check order status quickly. You don't have to navigate deep into the dashboard just to see if an item was paid for. - Prevent costly mistakes in real-time. If you run low on product stock, use `update_inventory` immediately so your agent can flag it before accepting new orders. - Customer service is faster. With tools like `get_customer`, you pull up a full client profile and their order history instantly, without needing to search by name or email. - Complete the sale cycle effortlessly. After an item ships, running `charge_order` finalizes the payment process with just a conversational prompt. - Keep logistics simple. You can check all active zones using `list_delivery_zones` and confirm pickup spots via `list_pickup_locations`, making route planning straightforward. ## How It Works The bottom line is, you talk to your AI client and it executes complex e-commerce actions across GrazeCart's system for you. 1. First, subscribe to this MCP on Vinkius. Then, supply your GrazeCart Store URL and API Token from your admin panel. 2. Next, connect your preferred AI client (like Claude or Cursor) to the catalog using the provided credentials. 3. Your agent can then execute commands like listing orders, updating inventory counts, or looking up customer history simply through conversation. ## Frequently Asked Questions **How do I list orders using the GrazeCart MCP?** Use `list_orders` to get a rundown of every order placed. This tool gives you visibility across your entire order book, letting you quickly identify which shipments need attention. **What is the best way to update inventory with GrazeCart MCP?** You use `update_inventory` and must provide a specific product ID. Don't just say 'add stock'; tell your agent exactly which product variant needs the new count. **Can I check customer details with GrazeCart MCP?** Yes, use `get_customer` to retrieve a full profile for one specific client. You can also run `list_customers` if you need to see who is registered in the store. **Do I need multiple tools to process an order with GrazeCart MCP?** In practice, yes. To fully complete a sale, you'll likely use `get_order` for details, `update_inventory` to adjust stock, and `charge_order` to take payment. **Before I run list_orders, how do I get the necessary credentials for the GrazeCart MCP?** You must connect your API client using your unique Store URL and API Token. You find this token in your Admin Panel under Profile settings; it's required to authenticate all operations on this MCP. **If I need to check logistics boundaries, what does the list_delivery_zones tool provide?** list_delivery_zones returns a catalog of your configured delivery areas. This helps your agent determine if an order's address falls within a serviceable zone before attempting fulfillment. **When using the get_product tool, what specific details can my agent retrieve about a product?** The get_product tool retrieves detailed data points beyond just stock count. You can pull core product specifications, descriptions, and SKU information for accurate record-keeping. **How does the charge_order tool handle payment failures or errors during a transaction?** The tool returns the specific status code if a charge fails. Your agent can read this error message to diagnose issues, such as insufficient funds or an invalid card number. **Can my agent update the inventory levels in GrazeCart?** Yes. Use the 'update_inventory' tool. By passing the Product ID and the inventory update payload, the agent can programmatically adjust stock counts for your variants to prevent overselling fresh products. **How do I process pending payments for orders via chat?** You can use the 'charge_order' tool. Simply provide the Order ID, and the agent will trigger the payment charge request through GrazeCart's billing engine flawlessly. **Can I list active pickup locations for logistics planning through the agent?** Absolutely. Use the 'list_pickup_locations' tool. Your agent will retrieve a full list of configured pickup points, helping you organize your delivery routes or assist customers with pickup inquiries natively.