# Vinsight MCP > Vinsight lets you manage the entire lifecycle of beverage production—from grapes to bottle. It handles inventory tracking for wine, beer, and spirits; monitors every batch code and vessel level in the cellar; and tracks sales orders from initial customer contact through final shipment. You can run your whole operation, including quality control checks and purchase order logging, using only natural conversation. ## Overview - **Category:** erp-operations - **Price:** Free - **Tags:** production-management, supply-chain, batch-tracking, winery-software, inventory-control, sales-orders ## Description You connect your beverage business to an AI agent and manage everything with plain talk. Need to know what's going on in the cellar? It tracks every vessel—tanks, barrels, fermenters—reporting capacity, current contents, and fill levels instantly. You can monitor production runs by reviewing inputs and outputs for specific batches or track raw materials incoming via purchase orders. The system keeps tight tabs on inventory across all warehouses, differentiating between available stock, committed sales, and items already ordered. When a sale happens, you pull up the order details using the customer's name or ID. Furthermore, you can always check quality control by pulling the latest lab results—pH, alcohol content, dissolved oxygen—against specific batches. Because this system handles critical financial movements and inventory changes, every single action is logged with a cryptographically signed audit trail on Vinkius, giving your team total visibility into exactly what happened and when. This means you don't have to trust spreadsheets; the record is verifiable. ## Tools ### search_stock_items Searches for product information across wine, beer, spirits, and raw materials using keywords or SKUs. ### list_stock_levels Provides the current total inventory count across multiple locations for quick reorder planning. ### list_lab_results Provides a list of quality control analyses, sorted by date for compliance checks. ### list_warehouses Provides a list of all physical storage locations if you operate across multiple sites. ### get_stock_item Retrieves the definitive product record, including pricing and compliance codes. ### list_sales_orders Lists core revenue records, giving a high-level view of all customer sales orders. ### get_sales_order Pulls specific details for one customer order using its ID. ### search_contacts Finds customer or supplier profiles, giving access to addresses and order history details. ### list_purchase_orders Tracks supply chain movements for materials like bottles, corks, and chemicals coming into the facility. ### list_production_orders Shows the history and status of all major winemaking or brewing production runs. ### list_batches Lists all individual production lots, tracking them through every stage of the process. ### list_vessels Lists all tanks and barrels, detailing capacity, current contents, and fill level for space planning. ## Prompt Examples **Prompt:** ``` What's our current Chardonnay 2024 inventory? ``` **Response:** ``` 🏭 **Chardonnay 2024 — Inventory Report** 📦 **Stock levels**: - Available: **4,200 bottles** (350 cases) - Committed (orders): 1,800 bottles - On-hand total: 6,000 bottles 🛢️ **Bulk stock**: 2,400L in Tank S-12 📍 **Warehouse**: Main Cellar (bonded) 📊 **Sales velocity**: ~600 bottles/month ⏰ **Stock duration**: ~7 months at current rate 💡 Consider scheduling next bottling run in Q1 2026. ``` **Prompt:** ``` Create a new production order to blend 500L of 'Batch 44' into Tank 12. ``` **Response:** ``` Executing `create_production_order`... Production Order #PO-9912 successfully registered. Action: Transfer & Blend Source: Batch 44 (500L) Destination: Tank 12 Status: Pending execution by Cellar Team. ``` **Prompt:** ``` Check the latest lab results for the Pinot Noir fermentations in Tank B. ``` **Response:** ``` Fetching QC analysis ('get_lab_results')... Tank B (Pinot Noir 2025 - Fermentation): - pH: 3.45 - TA: 6.2 g/L - Temp: 24°C - Brix: 4.5° (Dropping steadily) - Residual Sugar: Not tested yet. ``` ## Capabilities ### Check current stock levels Get a real-time count of products across all warehouses, showing available, committed, and on-order quantities. ### Track production progress Review details about production runs, including materials used and the final output product assignments for specific batches. ### Manage incoming supplies Log and track material purchases like bottles, corks, or chemicals using purchase orders. ### Monitor cellar resources List tanks, barrels, and other vessels, providing details on capacity, current volume, and physical location. ### Review quality control data Access recent lab analyses for specific batches, including critical readings like pH, Total Acidity, and alcohol content. ### Search customer profiles Pull up contact information, payment terms, and order history for any known client or supplier. ## Use Cases ### The End-of-Day Inventory Audit It's 5 PM, and the ops team needs a final count before closing. They ask their agent for 'total inventory available.' The agent uses list_stock_levels and list_warehouses to provide a single number, preventing manual spreadsheet reconciliation. ### Pre-Sale Stock Check A sales rep promises a client 50 cases of Merlot. Instead of guessing, they ask the agent for 'available stock.' The agent runs search_stock_items against the current inventory and confirms availability instantly. ### Investigating a Production Delay A brewmaster hears about a delay in bottling. They ask the agent to check 'production history for Batch 42.' The agent uses list_batches and list_production_orders to trace exactly where the batch stopped. ### Onboarding a New Client A sales team member needs to know everything about a new distributor. They ask for 'details on Acme Imports.' The agent uses search_contacts and list_sales_orders to provide a full background, including payment terms. ## Benefits - Know where everything is. Instead of checking multiple tabs for stock levels, list_stock_levels gives you an immediate count across all sites, critical for fulfilling orders. - Track every drop. You can monitor your cellar space using list_vessels and track the life cycle of product lots with list_batches, ensuring nothing gets lost in transit or production. - Manage raw materials flow. Use list_purchase_orders to keep tabs on incoming goods—whether it's grapes, bottles, or chemicals—so you never run short right before a big sale. - See the full customer picture. Search contacts pulls not just addresses but also payment terms and order history for any client, saving research time. - Verify quality instantly. Need to know if a batch passed QC? list_lab_results gives you immediate access to pH, TA, and alcohol readings for compliance checks. - Streamline fulfillment planning. Combining the data from list_sales_orders with search_stock_items lets your agent calculate exactly what needs to be reserved. ## How It Works The bottom line is that you talk to your agent like you're talking to an employee; it pulls all the necessary data from Vinsight to give you a single answer. 1. Start by telling your agent what you need. For example, 'What's the current inventory of Chardonnay 2024?' 2. Your agent interprets that request and makes calls to multiple endpoints—like listing stock levels and checking batch data—to gather all relevant numbers. 3. It compiles a single, readable summary for you: the available bottles, where they are stored, and how many are already reserved for pending orders. ## Frequently Asked Questions **How does the Vinsight MCP handle inventory tracking for multiple warehouses?** The MCP uses list_warehouses first to identify all your physical sites. It then runs list_stock_levels against those locations, giving you a consolidated view of stock availability across every site. **Can I use the list_sales_orders tool to check if a customer has pending orders?** Yes. You can run list_sales_orders to get a high-level overview of all active sales, which helps you quickly identify customers with recent or open purchases. **What is the difference between search_stock_items and get_stock_item?** search_stock_items searches broadly using keywords (e.g., 'Chardonnay'). get_stock_item pulls the complete, definitive record for one specific product ID. **Does list_vessels help with cellar space planning?** Yes. It lists all your tanks and barrels along with their capacity, current fill level, and location, making it easy to plan where the next big batch needs to go. **When I use list_lab_results, what security measures protect sensitive quality control data?** The results are stored within a cryptographically signed audit trail. Vinkius ensures that every call generates an immutable record (SHA-256 hash) of the analysis performed and who accessed it. **How does list_purchase_orders help me track incoming materials like grapes or corks?** It gives you full visibility into your supply chain inputs. You can monitor expected material arrivals, linking purchase orders directly to when those raw items hit your inventory. **If I use get_stock_item and the SKU doesn't exist, what error message do I receive?** The system returns a standardized 'Item Not Found' status code. This clear failure signal lets your agent know immediately that you need to check the product catalog or correct the input. **When I call list_batches, can the system handle querying multiple vintages and decades of production?** Yes, it's designed for scale. You can apply date range filters and pagination to efficiently pull batch data across many years without timing out. **Does Vinsight work for breweries too?** Yes! Vinsight manages wine, beer, and spirits production. The same API covers all beverage types — wineries, breweries, and distilleries.