# Perfect Order Rate Calculator MCP

> The Perfect Order Rate Calculator determines your fulfillment excellence by measuring order integrity, quantifying failure costs, and projecting loyalty impact. It calculates how improving logistics hits both your bottom line and customer retention metrics.

## Overview
- **Category:** supply-chain
- **Price:** Free
- **Tags:** kpi, logistics, supply-chain, nps, clv, business-intelligence

## Description

Logistics failures cost money—and they erode trust. This MCP helps you calculate the true state of your supply chain performance. You get three key numbers: your Perfect Order Rate percentage, a dollar figure for every failure type, and a projection showing how improving those rates boosts Net Promoter Score (NPS) and Customer Lifetime Value (CLV). It’s not just about hitting KPIs; it’s connecting operational failures to financial risk. When you use this MCP through Vinkius, your agent runs these analyses instantly, giving you the full picture of what's broken and how much fixing it is worth.

## Tools

### calculate_failure_cost
Determines the specific financial loss associated with various types of order failures, like damages or delays.

### calculate_loyalty_projection
Estimates how improvements in your fulfillment process will boost customer loyalty metrics like NPS and CLV.

### calculate_order_integrity
Calculates the Perfect Order Rate percentage based on specific operational criteria (on-time, complete, undamaged, documents).

## Prompt Examples

**Prompt:** 
```
What is my perfect order rate if my on-time, complete, undamaged, and document accuracy rates are all 98%?
```

**Response:** 
```
Your Perfect Order Rate is 92.24%.
```

**Prompt:** 
```
How much did 10 damaged orders cost me if each damage costs $50?
```

**Response:** 
```
The total failure cost for the damaged category is $500.
```

**Prompt:** 
```
If I improve my POR by 2 points, what happens to my CLV if the sensitivity factor is 5?
```

**Response:** 
```
Your projected CLV will increase by $10.
```

## Capabilities

### Assess Fulfillment Excellence
Calculates a single percentage score that measures if an order was processed correctly across all dimensions: on-time, complete, undamaged, and accurate documentation.

### Quantify Failure Costs
Translates logistics errors—like damaged goods or delays—into specific dollar amounts so you know the direct financial drag of poor fulfillment.

### Project Customer Loyalty Gains
Models how increasing your Perfect Order Rate affects future customer spending and overall satisfaction (NPS/CLV).

## Use Cases

### Justifying a new QA team
The Operations Manager needs proof that spending money on better quality control pays off. They use `calculate_failure_cost` to prove how much the current damage rate costs annually, then use `calculate_loyalty_projection` to show that fixing it will boost CLV by $X.

### Post-merger performance audit
A Supply Chain Analyst needs to compare two different warehouses. They run `calculate_order_integrity` against both sites to get a hard POR score, then use the failure cost tool to find out which site's process waste costs more money.

### Board presentation on KPIs
The Director of Customer Success needs to convince the board that minor improvements matter. They start by calculating their current POR, then use `calculate_loyalty_projection` to show a conservative but impressive lift in NPS.

## Benefits

- Instantly calculate your Perfect Order Rate (POR). Instead of manually compiling data from four different reports, `calculate_order_integrity` gives you one definitive percentage score for fulfillment excellence.
- Stop treating failure costs as abstract risks. Using `calculate_failure_cost`, you quantify the exact dollar burden of damaged goods or processing errors, letting you prioritize fixes by highest financial impact.
- See the future value in your current failures. The `calculate_loyalty_projection` tool translates a better POR into tangible boosts for CLV and NPS, securing buy-in from finance teams.
- Speed up executive reporting. Instead of spending days compiling KPI data across systems, you get all three key metrics—integrity, cost, and loyalty—from one single query.
- Prioritize capital spend correctly. By linking operational fixes to financial outcomes, you determine if improving documentation accuracy is worth more than speeding up delivery times.

## How It Works

The bottom line is you stop guessing about logistics costs and start working with hard data that connects operations to revenue.

1. Input the necessary operational metrics into your agent, such as on-time percentage, damage rate, or document accuracy percentages.
2. The MCP runs three separate calculations: first determining current order integrity; second calculating the cost of failures; and finally projecting future loyalty value based on improvement targets.
3. Your agent returns a full report detailing the POR score, the total failure expenditure, and the resulting projected increase in CLV.

## Frequently Asked Questions

**How does calculate_order_integrity work?**
It takes operational inputs (on-time, complete, undamaged, document accuracy) and outputs a single percentage score showing your overall fulfillment excellence. This rate is the foundation for all other calculations.

**Can I use calculate_failure_cost to determine my total loss?**
Yes. You provide the counts of specific failures (like damaged orders) and the associated cost per unit, and the tool aggregates this into a clear total financial burden figure.

**Does calculate_loyalty_projection need me to improve my POR first?**
Yes. This projection requires you to establish an improvement goal (e.g., 'improve POR by 2 points'). It then models the resulting boost in CLV and NPS based on that specific gain.

**What is a Perfect Order Rate?**
The POR is your core KPI for fulfillment excellence, calculated using `calculate_order_integrity`. It means measuring if an order was delivered perfectly across time, completeness, physical condition, and paperwork.

**What specific metrics must I provide when using calculate_order_integrity?**
You must input four distinct rates: on-time fulfillment, completeness rate, damage percentage, and document accuracy. These separate percentages are required to determine the overall Perfect Order Rate.

**If there are no logistics failures recorded, how does calculate_failure_cost handle the calculation?**
The tool handles zero input gracefully. If you provide zero failure data, it returns a $0 cost projection rather than throwing an error. You don't need to worry about null calculations.

**Does calculate_loyalty_projection require the POR improvement metric in a specific format?**
Yes, the input for projected improvements must be provided as a point increase or percentage change (the delta). The tool needs to know *how much* you're improving your rate before calculating the resulting CLV boost.

**Are there usage restrictions or rate limits when calling calculate_failure_cost?**
Vinkius manages API throttling, but high-volume users should check the documentation. If you exceed standard call rates, your agent will receive a clear 429 status code instructing you on when to retry.

**What is the Perfect Order Rate?**
The Perfect Order Rate is a metric that measures how many orders meet all four criteria: on-time, complete, undamaged, and with accurate documentation.

**How can I calculate the cost of errors?**
You can use the `calculate_failure_cost` tool by providing a JSON mapping of failure counts and their respective unit costs.

**Does this tool help with financial forecasting?**
Yes, the `calculate_loyalty_projection` tool allows you to estimate how improvements in your order rate will impact NPS and CLV.