# InnoVint MCP > InnoVint MCP manages every step of the winemaking process—from initial harvest intake to bottling. It tracks specific wine lots, monitors tank capacity and contents, records detailed lab analyses (pH, SO2, Brix), and logs all cellar actions like rackings and pump-overs across multiple wineries through natural conversation. ## Overview - **Category:** erp-operations - **Price:** Free - **Tags:** winery-production, lot-tracking, lab-analysis, cellar-management, inventory-control, production-analytics ## Description You gotta say, managing a winery is massive; you're juggling chemistry reports, physical space logistics, and production history. This MCP connects your entire operation to any AI agent, letting you talk to the data instead of clicking through ten different dashboards. You can ask about specific batches—say, 'How did the 2023 Bordeaux blend do?'—and get a full report detailing its current location, all lab readings taken so far, and every single action performed on it. It handles everything from listing multiple facilities to cross-referencing additives against regulatory limits. Because you connect through Vinkius, your AI client sees the whole picture, giving your cellar team one reliable source of truth for lot tracking and inventory management. ## Tools ### search_lots Searches across all lots to find details on volume, vessel assignment, or current production status. ### list_wineries Lists all associated winery locations, allowing management of multiple facilities from one account. ### get_lot Retrieves the full, primary data record for any specific wine lot. ### list_vessels Lists all tanks and barrels, providing capacity, current contents, fill level, and location details. ### get_vessel Gets detailed information about a single storage vessel or barrel. ### list_wines Displays product information for every wine type, including appellations and varietal rules. ### list_vintages Provides an organized list to navigate the wine production data by year. ### list_analyses Presents the historical lab chemistry data for a specified wine lot over time. ### list_actions Retrieves the complete chronological record of cellar actions for a specific lot. ### list_additives Lists registered chemical additives, including current dosage guidelines and regulatory limits. ## Prompt Examples **Prompt:** ``` How is the 2025 Pinot Noir fermentation going? ``` **Response:** ``` 🍷 **Pinot Noir 2025 — Lot PN-25-01** 🧪 Latest lab analysis (Oct 14): - **pH**: 3.48 (within range) - **Brix**: 0.2° (fermentation nearly complete) - **Free SO₂**: 28 ppm - **TA**: 6.1 g/L 🛢️ **Vessel**: Tank T-07 (2,500L) — 92% full 📋 Recent actions: - Oct 12: Punchdown (2x daily) - Oct 10: SO₂ addition (25 ppm) - Oct 8: Inoculated with RC-212 yeast ✅ Fermentation is on track. Expect dryness in 2-3 days. ``` **Prompt:** ``` Record a new lab reading for the 2025 Chardonnay: pH is 3.32 and TA is 6.5 g/L. ``` **Response:** ``` I have successfully recorded the lab analysis for the 2025 Chardonnay lot. The pH is now updated to 3.32 and TA to 6.5 g/L. ``` **Prompt:** ``` Which vessels are currently empty and available for the upcoming harvest? ``` **Response:** ``` There are currently 6 empty vessels available: 4 stainless steel tanks (T-02, T-05, T-12, T-14) and 2 concrete eggs. Total available capacity is 18,500L. ``` ## Capabilities ### Track Specific Batches Get full details on a wine lot by searching using varietal, vintage, or lot code. ### Monitor Storage Capacity View the current contents, fill levels, and location of every tank, barrel, or concrete vessel in the cellar. ### Analyze Chemistry Over Time Review historical lab readings for critical metrics like pH, TA, and SO2 for any given lot. ### Audit Production History List every cellar action—punchdowns, fining, additions—that has ever been recorded against a specific wine lot. ### Manage Multiple Sites View and manage the data for several different wineries from one single connection point. ## Use Cases ### Urgent Space Planning The harvest is arriving tomorrow. Instead of calling the warehouse and waiting for them to check physical logs, you ask your agent which vessels are empty and available. The MCP runs `list_vessels` immediately, telling you precisely how much space you have (e.g., 'We got 18,500L free across T-02, T-05, and two concrete eggs'). ### Troubleshooting a Blend A winemaker suspects the blending ratio is off for a specific vintage. They ask to compare data, triggering the agent to run `list_analyses` on multiple lots and cross-reference that information against the details from `get_lot`, providing comparative chemistry reports. ### Audit Trail Requirement The compliance officer needs proof of every intervention done on a reserve lot. They ask to view all actions, and the MCP runs `list_actions` for that specific batch ID, generating a complete, time-stamped log of everything from fining to filtration. ### Multi-Site Overview The owner needs an end-of-quarter review. They ask the agent to pull all production metrics for the last three years across all facilities, which uses `list_wineries` and then coordinates calls like `list_vintages` to build a single comparative report. ## Benefits - Stop guessing about space. Using `list_vessels` gives you an immediate count of available tanks and barrels, telling you exactly where the new crop can go. - Get instant chemistry reads without walking back to the lab. You can use `list_analyses` to compare pH or SO2 readings for a lot taken last week versus yesterday. - Keep compliance tight. When planning treatments, check `list_additives` first; it provides dosage limits and regulatory warnings—you don't want an error on your final report. - Never lose track of a batch again. Running `search_lots` lets you find that specific 2019 vintage blend even if you only remember the varietal or approximate volume. - Manage growth without complexity. The `list_wineries` tool means you can monitor production across three different sites using one connection point, instead of logging into three separate systems. ## How It Works The bottom line is, you tell your agent what question to answer, and it finds the specific data point across your entire operation. 1. Tell your AI agent what you need to know, like 'Show me all vessels with less than 20% capacity.' 2. The MCP processes the request using specialized tools—for instance, calling `list_vessels` and filtering by fill level. 3. You get back a clear list of available tanks or barrels, complete with their location and current contents. ## Frequently Asked Questions **How do I check available tank space using list_vessels?** The `list_vessels` tool shows every tank and barrel, including its current fill level and capacity. You can use this to quickly see what's empty or nearly full across the whole cellar. **What is the difference between get_lot and search_lots?** `search_lots` is for finding a lot when you only know vague details, like varietal or vintage. `get_lot` requires a specific lot identifier to pull all its detailed records. **Can I see the chemistry history using list_analyses?** Yes, running `list_analyses` allows you to view historical readings for pH, TA, and SO2 on any specific wine lot over time. This is crucial for tracking fermentation progress. **Do I need to know the exact vessel ID before using get_vessel?** Yes, `get_vessel` requires a vessel identifier. If you don't know it, run `list_vessels` first to get a list of available IDs. **What information can I get about chemical additives using list_additives?** It provides regulatory limits and typical dosage guidelines. This is essential for compliance checks; you can verify approved chemicals or determine the correct amount needed before adding any fining agent to a lot. **How do I track all historical cellar activities using list_actions?** You get a complete timeline filtered by lot. This tracks every pump-over, rackings event, or addition history, giving you full traceability for quality review and regulatory compliance. **If I own several facilities, how do I manage them using list_wineries?** You first call `list_wineries` to see all connected locations. This allows your agent to manage operations across multiple wineries from a single AI connection point. **What specific metadata does list_wines provide about different varietals?** It lists wine products along with key details like appellation and specific varietal rules. This helps you reference the official product catalog information needed for blending or inventory planning. **How do I get InnoVint API access?** Contact InnoVint support at support@innovint.us to request a Personal Access Token. You'll need an active InnoVint account. **Can I record lab analysis results using this integration?** Yes, you can input new lab readings such as pH, TA, Brix, and free SO2 directly for a specific lot or vessel using natural language, and the AI will post them to the InnoVint API. **Does this support managing multiple wineries under the same account?** Yes, if your InnoVint integrator account has access to multiple wineries, you can scope your API requests to a specific Winery ID to manage lots and vessels across different properties.