# GrainSure MCP

> GrainSure connects your AI agent directly to silo monitoring data. Track grain fill levels, consumption rates, and sensor health across multiple storage units. Get predictive forecasts on when silos will run empty and manage delivery orders from a single conversation.

## Overview
- **Category:** iot-hardware
- **Price:** Free
- **Tags:** silo-monitoring, inventory-tracking, predictive-forecasting, supply-chain, delivery-management

## Description

Your agent reads the real-time status of every silo connected to GrainSure. You stop guessing about inventory by getting current fill percentages and remaining tonnes for immediate operational checks. Need to plan ahead? The system calculates predicted days until any given silo empties, giving you advance warning before stock runs low. It also monitors the actual sensors, telling you if a battery is dying or if calibration is needed. Furthermore, when it's time to order more grain, your agent can automatically create and track delivery orders for immediate replenishment. This entire supply chain overview—from current levels to ordering supplies—is accessible through any MCP-compatible client via Vinkius.

## Tools

### create_delivery_order
Places a new grain delivery order specifying the quantity, date, and recipient silo ID.

### get_current_level
Retrieves the precise fill percentage and remaining tonnage for any single silo in real time.

### update_silo_settings
Allows adjustment of monitoring parameters, such as changing the low stock threshold or updating the stored grain type.

### get_days_to_empty
Calculates the estimated number of days until a specific silo runs out based on current usage rates.

### get_farm_overview
Gathers and summarizes the total inventory status across every monitored storage unit on the farm.

### get_silo_details
Pulls static metadata about a specific silo, like its purpose or physical location.

### get_silos
Lists all monitored silos on the farm, including their name, type, and current basic status.

### get_fill_level_history
Provides a time-series chart of how a silo's fill level has changed over a specified lookback period.

### get_low_stock_alerts
Pulls all active alerts, flagging silos that are below their set thresholds or require attention.

### get_order_history
Retrieves a full log of past delivery orders and associated supplier details for auditing.

### get_sensor_health
Reports the operational status, battery level, and signal strength of the silo's monitoring hardware.

### get_usage_history
Provides a historical record of grain consumption rates (tonnes per day/week) for trend analysis.

## Prompt Examples

**Prompt:** 
```
Show me the current fill levels for all my silos.
```

**Response:** 
```
Fetching current silo levels... Silo 1 (Wheat): 78% full, 156 tonnes remaining, sensor updated 2 minutes ago. Silo 2 (Barley): 45% full, 90 tonnes remaining, updated 5 minutes ago. Silo 3 (Corn): 22% full, 44 tonnes remaining — LOW STOCK alert triggered, updated 1 minute ago. Silo 4 (Oats): 91% full, 182 tonnes remaining, updated 3 minutes ago. Total farm inventory: 472 tonnes across 4 silos. Priority action: Silo 3 is approaching critical levels — consider ordering delivery within the next 3-5 days. Would you like predicted days-to-empty for each silo?
```

**Prompt:** 
```
How many days until my wheat silo runs empty?
```

**Response:** 
```
Checking days-to-empty prediction for wheat silo (Silo 1)... Current fill: 78% (156 tonnes). Average daily usage: 3.2 tonnes/day. Predicted days to empty: 49 days. Predicted empty date: May 26, 2026. Confidence: 92%. Usage trend: Stable consumption over the past 30 days with slight increase during the last week. Recommendation: No immediate action required. Consider scheduling next delivery in approximately 35 days to maintain comfortable stock levels. Would you like to see the detailed usage history for this silo?
```

**Prompt:** 
```
Order 30 tonnes of barley for silo 2 with delivery next week.
```

**Response:** 
```
Creating delivery order for Silo 2 (Barley)... Order confirmed! Order ID: ORD-2026-0417. Quantity: 30 tonnes of Barley. Preferred delivery date: April 21, 2026. Estimated supplier response time: 24 hours. Current silo status: 45% full (90 tonnes), predicted to last 28 days. This delivery will bring the silo to approximately 90% capacity. You will receive confirmation from the supplier within 24 hours. Would you like to set up an automatic reorder threshold for this silo?
```

## Capabilities

### Get real-time inventory status
Immediately retrieves the fill percentage and remaining tonnage for any monitored silo.

### Forecast stock depletion timelines
Calculates how many days of grain remain based on current usage patterns, preventing unexpected runouts.

### Generate delivery orders
Creates formal delivery requests with specific quantities and preferred dates for inventory replenishment.

### Assess system hardware health
Checks the operational status, battery level, and signal strength of every connected monitoring sensor.

### Review historical usage data
Retrieves time-series records showing how much grain was consumed or stored over weeks or months.

## Use Cases

### Planning for seasonal shortages
A Farm Manager needs to know if they'll make it through the winter feed cycle. They ask their agent, 'What is our total capacity and how long will we last?' The agent uses get_farm_overview and then calls get_days_to_empty multiple times to give a complete picture of resource availability.

### Responding to an unexpected audit
A Supply Chain Coordinator needs proof of the last three shipments. They ask, 'Show me all deliveries for silo 4 over the last year.' The agent uses get_order_history and gets a clean log, saving hours of manual record-checking.

### Troubleshooting data gaps
The Feed Manager notices consumption rates seem erratic. They ask, 'Show me usage trends for silo 2.' The agent uses get_usage_history to provide a clear graph and identifies the sudden dip in activity.

### Setting up new inventory protocols
A consultant needs better safety margins. They ask, 'Raise the low stock threshold for all corn silos to 15%.' The agent uses update_silo_settings to adjust the system rules immediately.

## Benefits

- Stop reacting to crises. Use get_days_to_empty and get_low_stock_alerts to predict when a supply issue is coming, giving you time to plan deliveries instead of scrambling for emergency orders.
- Never manually compile farm reports again. The get_farm_overview tool gives executive-level summaries of total inventory across all silos instantly, just by asking your agent.
- Keep the whole system running smoothly. Don't wait until a sensor fails; use get_sensor_health to check battery life and signal strength proactively, ensuring continuous data flow.
- Perfect for auditing or disputes. Get_order_history lets you review past delivery records instantly, confirming quantities and dates without digging through supplier portals.
- Fine-tune your system rules using update_silo_settings. You can change the low stock percentage or the grain type stored in a silo to keep data accurate as conditions change.

## How It Works

The bottom line is you get a single, conversational interface to control complex industrial logistics systems without needing dedicated software dashboards.

1. Subscribe to this MCP and enter your unique GrainSure API key and base URL into the Vinkius catalog.
2. Your AI agent calls the tool, providing necessary context like which silo ID or what action (e.g., 'order 50 tonnes').
3. The system executes the command against the live monitoring hardware and returns structured data—like current levels or order confirmation numbers—to your conversation.

## Frequently Asked Questions

**How do I check my current fill levels using get_current_level?**
You simply ask your agent for 'the current level of silo 2.' The tool returns the exact percentage and remaining tonnes, plus a timestamp so you know how fresh the data is.

**What is the difference between get_usage_history and get_fill_level_history?**
get_usage_history tracks *how much* grain was consumed over time (tonnes per day). Meanwhile, get_fill_level_history shows the actual percentage change in the silo's physical level.

**Can I use create_delivery_order to order multiple silos at once?**
Yes. You can list several delivery orders and specify different quantities for each silo ID in a single request, streamlining complex logistics planning.

**I need an overall summary of the whole farm; which tool should I use? (get_farm_overview)**
Use get_farm_overview. This tool aggregates data from every silo to give you a single, high-level inventory summary for management reporting.

**When I use get_days_to_empty, how reliable are the predictions if my usage rate changes?**
The prediction relies on the current average usage rate and stored capacity. If your consumption pattern shifts significantly (e.g., due to weather or feed change), you'll need to manually update the assumptions in get_silo_details for better accuracy.

**If I use get_sensor_health, what does a 'needs calibration' status mean for my data?**
It means the sensor needs physical maintenance. The system reports this to ensure you don't make decisions based on faulty readings; check your site manual immediately.

**How do I adjust alert thresholds using update_silo_settings if my standard low-stock level changes?**
You use update_silo_settings to set new critical or warning levels for a specific silo. This prevents unnecessary alerts and keeps your inventory monitoring aligned with current needs.

**When I need to check supplier performance, should I use get_order_history?**
Yes, get_order_history provides all past delivery records for a silo. You can track specific quantities and compare the actual received dates against the expected ones.

**Can my AI predict when my silo will run empty based on current usage?**
Yes! Use the `get_days_to_empty` tool with your silo ID. GrainSure AI analyzes current fill levels and historical usage patterns to predict exactly how many days until the silo runs empty, with a confidence score. For deeper analysis, combine with `get_usage_history` to see the consumption trends that drive the prediction. This gives you proactive warning to schedule deliveries before running out.

**How do I set up low stock alerts for my silos?**
Use the `update_silo_settings` tool to configure your low stock threshold percentage (e.g., 20% means alert when silo drops below 20% full). Then use `get_low_stock_alerts` to check for any active alerts. GrainSure will automatically monitor fill levels and trigger alerts when thresholds are breached, giving you timely warning to plan deliveries.

**Can I create a delivery order directly through the API?**
Yes! Use the `create_delivery_order` tool with the silo ID, quantity in tonnes, and optionally a preferred delivery date and supplier. The API will confirm your order with an order ID and estimated delivery date. You can also use `get_days_to_empty` predictions to automatically trigger orders when silos reach critical levels.