# Vendor Scorecard MCP

> The Vendor Scorecard Calculator uses weighted metrics to evaluate supplier health and performance. It lets you process complex vendor data—including OTIF, Quality, Flexibility, Cost, and Responsiveness—to compute aggregate scores. You can then rank your entire supplier base by excellence or flag partners that are approaching critical failure thresholds.

## Overview
- **Category:** business-intelligence
- **Price:** Free
- **Tags:** vendor-management, supplier-scorecard, performance-tracking, risk-detection, logistics

## Description

Managing a supply chain means dealing with hundreds of vendors. Knowing which ones are truly reliable is tough; performance isn't just one number. This MCP lets you build out a single view of vendor health, using weighted scoring across multiple metrics like quality and cost. You feed in the raw data and let your agent do the heavy lifting. Instead of manually sifting through spreadsheets to figure out who’s struggling, you calculate aggregate scores for every supplier based on how critical different factors are to your business. The system then sorts them by overall performance or flags specific partners that need immediate attention before they fall below a required threshold. Connecting this MCP via Vinkius means you get instant access to professional-grade vendor intelligence without having to build complex scoring models from scratch.

## Tools

### evaluate_supplier_scores
Calculates weighted performance scores for specific vendors based on defined metrics.

### generate_performance_ranking
Sorts all connected vendors into a ranked list according to their calculated scores.

### detect_at_risk_vendors
Flags any supplier whose performance score is near predefined critical thresholds.

## Prompt Examples

**Prompt:** 
```
Calculate the scores for vendors A and B with weights: otif=40, quality=30, flexibility=10, cost=10, responsiveness=10.
```

**Response:** 
```
Vendor A has a calculated score of 85.0 and Vendor B has a calculated score of 72.0.
```

**Prompt:** 
```
Rank my current list of evaluated vendors from highest to lowest performance.
```

**Response:** 
```
The ranked list is: 1. Vendor A (92), 2. Vendor C (85), 3. Vendor B (78).
```

**Prompt:** 
```
Are any of my suppliers at risk of falling into a lower tier if their score drops by 2%?
```

**Response:** 
```
Yes, Vendor B is currently at risk as their score is near the threshold for the Conditional tier.
```

## Capabilities

### Calculate weighted scores
Compute aggregate performance scores for any group of vendors based on multiple input metrics.

### Rank supplier tiers
Automatically sort your entire vendor list from highest overall performance to lowest.

### Identify critical risk partners
Flag vendors whose current scores indicate they are approaching a failure or warning tier.

## Use Cases

### The quarterly vendor review
A Procurement Manager needs to decide which vendors get contract extensions. They ask their agent to run `generate_performance_ranking` across all 200 suppliers, giving them an objective list of the top 10 performers for negotiation.

### Identifying potential sourcing failures
The Operations Director notices a slight dip in responsiveness scores. They use `detect_at_risk_vendors` to check if this minor issue flags any major partners, allowing them to pre-emptively find alternative sources.

### Onboarding new suppliers
A Supply Chain Analyst needs a baseline score for new vendors. They use `evaluate_supplier_scores` with the core metrics—Cost and Flexibility—to give them an initial, weighted score before they even ship their first product.

### Auditing performance after a major incident
After a quality recall event, the team needs to know which vendors were most affected. They calculate scores using `evaluate_supplier_scores`, giving specific weight to Quality metrics for immediate comparison.

## Benefits

- Know exactly where your weakest links are. Use `detect_at_risk_vendors` to get early warnings about suppliers dropping below acceptable performance tiers.
- Move beyond simple averages. The MCP calculates weighted scores, meaning it knows that Quality issues count more than Cost fluctuations for your specific business needs.
- Instantly compare your entire supplier base. Run a ranking using `generate_performance_ranking` to create an objective leaderboard of all vendors.
- Save time on manual analysis. Instead of building complex scoring logic in spreadsheets, you simply define the weights and let your agent calculate everything for you.
- `evaluate_supplier_scores` takes disparate metrics—like OTIF or responsiveness—and collapses them into one simple, useful number.

## How It Works

The bottom line is that you stop guessing about vendor reliability and start making decisions based on calculated risk data.

1. Input raw vendor data, defining the performance metrics and assigning weights (e.g., Quality = 40%, Cost = 20%).
2. Use your agent to run the calculation, which generates a weighted score for every supplier in the dataset.
3. Receive actionable insights: either a full performance ranking or a list of vendors flagged as high-risk.

## Frequently Asked Questions

**How do I use `evaluate_supplier_scores`?**
You provide the vendor name and then list the metrics and their importance weights. The tool calculates a single weighted score based on those inputs, giving you one number for comparison.

**What is the difference between `generate_performance_ranking` and scoring?**
`evaluate_supplier_scores` gives you a score per vendor. `generate_performance_ranking` takes all those individual scores and puts them in a sorted list, showing who ranks where.

**Can I use `detect_at_risk_vendors` for cost tracking?**
The tool is designed to track overall performance thresholds. While cost can be one input metric, the function flags vendors that are dropping below a general critical score level.

**Do I need clean data before running `evaluate_supplier_scores`?**
The MCP handles the calculation logic. You still need to ensure your raw inputs (the scores for OTIF, Quality, etc.) are present and accurate in the initial dataset.

**What happens if I run `evaluate_supplier_scores` with metrics that aren't weighted?**
The tool will prompt you for weights. You must provide a weighting percentage for every metric you include in the calculation to get an accurate score.

**How does `detect_at_risk_vendors` handle vendors with missing data points?**
It processes partial data without failing. Instead, it flags those specific metrics as incomplete and adjusts the risk assessment accordingly.

**Can I use `generate_performance_ranking` on different datasets than what I scored previously?**
Yep. You just provide a new list of vendor IDs or data inputs in your prompt context; the tool doesn't rely on previous runs.

**Does running `evaluate_supplier_scores` for thousands of vendors hit rate limits?**
The MCP is designed for high volume. For very large datasets, just break them into smaller batches or use the bulk upload feature in your AI client.

**How are vendor scores calculated?**
Scores are calculated by multiplying each performance metric (like OTIF or Quality) by its assigned weight and summing the results. All weights must total 100%.

**Can I identify vendors at risk of disqualification?**
Yes, by using the `detect_at_risk_vendors` tool, you can identify suppliers whose scores are approaching a lower performance tier based on a specified margin.

**What metrics are supported?**
The system supports OTIF, Quality, Flexibility, Cost, and Responsiveness.