# Fill Rate Calculator MCP for AI Agents AI Agent Connect

> Fill Rate Calculator helps you track supply chain health by turning raw fulfillment data into actionable metrics. It calculates Order, Line, and Unit Fill Rates while quantifying the actual cost of out-of-stock items. Use it to see where your logistics are lagging and how much unfulfilled demand is hurting your bottom line and customer trust.

## Overview
- **Category:** supply-chain
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_OE2N24XvYYTngbPExAiHfE3LFL7g5EJ924FMAQe6/ai-agent-connect
- **Tags:** fill-rate, stockout, nps, benchmarking, inventory

## Description

This Connector provides the logic needed to turn raw fulfillment data into clear supply chain performance metrics. Instead of jumping between spreadsheets to figure out why customers aren't getting their orders on time, you can let your agent do the heavy lifting. It handles the math for Order, Line, and Unit Fill Rates, giving you a clear picture of fulfillment accuracy across different levels of your operation. It goes beyond just showing percentages by quantifying the real-world impact of stockouts, moving from "out of stock" labels to actual dollar amounts and potential damage to your brand's reputation. You can even see how your numbers stack up against what's standard in sectors like retail or pharmaceuticals. It's a practical way to get a handle on inventory health without the manual math. Finding these kinds of specialized tools in the Vinkius catalog makes it easy to plug this logic directly into your existing AI workflow.

## Tools

### calculate_fill_rate_metrics
Calculates Order, Line, and Unit Fill Rates from raw data to show fulfillment accuracy. This helps you pinpoint exactly where the breakdown is happening in your chain.

### compare_to_benchmarks
Evaluates your current performance against standard targets in retail, pharma, and other sectors. It provides context for whether your numbers are actually good.

### estimate_stockout_impact
Quantifies the financial loss and brand damage caused by unfulfilled customer demand. Use this to turn logistics problems into clear financial data.

## Prompt Examples

**Prompt:** 
```
My warehouse just processed 200 orders with 170 completed. We had 300 lines total with 280 completed. Can you calculate my fill rates?
```

**Response:** 
```
Based on the data provided, here are your fulfillment metrics:

*   **Order Fill Rate:** 85.0%
*   **Line Fill Rate:** 93.3%
*   **Unit Fill Rate:** (Requires total unit count for final calculation)

Your line fill rate is significantly higher than your order fill rate, suggesting that most orders are being fulfilled partially rather than being completely missed.
```

**Prompt:** 
```
We had 15 stockouts today. Each one cost about $40 in lost sales and we're seeing some angry tweets. What's the impact?
```

**Response:** 
```
Here is the estimated impact of today's stockouts:

*   **Total Financial Loss:** $600.00
*   **Reputational Risk:** High
*   **NPS Impact:** Significant risk of brand damage due to high-severity unfulfilled demand.
```

**Prompt:** 
```
Our current unit fill rate is 88%. How does that look for a pharmaceutical company?
```

**Response:** 
```
Comparing your 88% unit fill rate against the pharmaceutical industry benchmark:

*   **Status:** Critical Failure
*   **Context:** The pharmaceutical sector requires a significantly higher fill rate to maintain safety and supply standards. You are currently performing below the required threshold.
```

## Capabilities

### Calculate order-level fulfillment percentages
Determine what percentage of total orders were completed successfully.

### Measure line-item completion rates
See how many individual lines within an order were fulfilled.

### Track unit-level delivery accuracy
Get a granular view of how many individual units reached the customer.

### Estimate financial losses from stockouts
Convert unfulfilled demand into a specific dollar amount for your reports.

### Predict NPS degradation
Identify the risk of brand damage and lower customer satisfaction scores.

### Compare performance against industry standards
See how your logistics metrics stack up against specific sector benchmarks.

## Use Cases

### Identifying a warehouse bottleneck
A retail manager sees a dip in sales and asks the agent to calculate fill rates for the last month to see if it's a shipping issue or a stock issue.

### Calculating the cost of a stockout
An electronics company wants to know the cost of a recent stockout. They use the tool to find the financial hit and NPS risk.

### Proving industry compliance
A pharma company needs to prove they meet standards. They use the benchmark tool to compare their unit fill rates against industry targets.

### Benchmarking e-commerce growth
An e-commerce owner wants to see if their 85% fill rate is good. They ask the agent to check it against the food & beverage benchmark.

## Benefits

- Stop manual math by using calculate_fill_rate_metrics to get instant percentages for every order level.
- Protect your brand by using estimate_stockout_impact to see how much unfulfilled demand hurts your NPS.
- Justify budget requests by using compare_to_benchmarks to show exactly how your logistics lag behind industry standards.
- Identify specific bottlenecks by separating line-item failures from total order failures in your data.
- Make faster inventory decisions by seeing the direct dollar cost of every out-of-stock item.

## How It Works

The bottom line is you get instant, accurate logistics metrics and cost analysis without manual spreadsheets.

1. Provide your raw fulfillment data, including total orders, completed orders, and unit counts, to your AI client.
2. Specify the industry sector you want to benchmark against or the severity of your stockouts.
3. Receive a breakdown of your fill rates, the estimated financial impact of missing items, and your performance status.

## Frequently Asked Questions

**What does the Fill Rate Calculator do for my supply chain?**
It turns your raw fulfillment data into clear metrics like Order, Line, and Unit Fill Rates. It helps you see exactly how well your warehouse is performing and where you need to improve.

**How can I use the Fill Rate Calculator to see stockout costs?**
You can provide your unfulfilled order data to your agent. It will calculate the total financial loss and the potential damage to your brand's reputation.

**Can the Fill Rate Calculator compare my data to other industries?**
Yes. It can check your performance against specific targets for sectors like retail, electronics, pharma, and food & beverage.

**Does the Fill Rate Calculator handle different types of orders?**
It handles various levels of fulfillment, including total orders, individual lines within those orders, and the specific units delivered.

**How does the Fill Rate Calculator help with my NPS?**
It identifies unfulfilled demand and classifies the severity of those stockouts, helping you predict and mitigate risks to your customer satisfaction scores.

**Is the Fill Rate Calculator good for retail logistics?**
It is perfect for retail. It allows you to monitor your fill rates against retail-specific benchmarks and see the real-time cost of out-of-stock items.

**What is the difference between Order, Line, and Unit Fill Rate?**
Order Fill Rate tracks complete orders; Line Fill Rate measures accuracy at the SKU level; and Unit Fill Rate calculates the total volume of items delivered versus requested.

**How can I estimate the cost of unfulfilled orders?**
Use the `estimate_stockout_impact` tool by providing the number of unfilled orders, the estimated cost per failed order, and the severity level of the service failure.

**Does this tool support industry benchmarking?**
Yes, the `compare_to_benchmarks` tool compares your current unit fill rate against standard targets for sectors such as retail, pharmaceutical, electronics, and food & beverage.