# Player Performance Index AI Agent Connect

> Player Performance Index MCP provides a deterministic engine to turn raw football statistics into standardized performance scores. It uses role-specific weighting for attackers, midfielders, and defenders to ensure that a tackle from a center-back carries different weight than a tackle from a striker. You can normalize data to a per-90-minutes basis to compare players fairly regardless of their total time on the pitch.

## Overview
- **Category:** analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_5nOmpqBxYwT4SKsT2rHnFWCdcGh9V1F2gFglq2qj/ai-agent-connect
- **Tags:** football, soccer, performance, metrics, data-analysis

## Description

You can stop guessing how much a specific stat actually matters for a player's impact. This MCP gives your AI client a mathematical way to grade football performance using weighted statistical components. Instead of treating every goal or tackle the same, the engine applies specific weights based on whether you are analyzing a defender, midfielder, or attacker. 

You can use it to normalize raw data, making it easy to compare a substitute who played 20 minutes against a starter who played 90. It handles the heavy lifting of calculating indices and adjusting for playing time, so your agent can focus on the scouting or tactical analysis. Whether you are looking at individual contributions or comparing seasonal trends, the math remains consistent and deterministic.

## Tools

### calculate_player_index
This tool calculates the final performance index and provides a full breakdown of how each stat contributed to the score.

### get_weight_configuration
Use this to pull the standard weight profiles for specific player roles like Attacker, Midfielder, or Defender.

### scale_by_efficiency
This tool adjusts a raw accumulated score to account for the actual duration of play.

### validate_component_ranges
This tool checks if the statistics you provided fall within the acceptable thresholds for calculation.

## Prompt Examples

**Prompt:** 
```
Calculate the performance index for a player with 2 goals, 1 assist, 3 key passes, 2 tackles, 1 interception, 0 errors, and 90 minutes played, using Attacker weights.
```

**Response:** 
```
The calculated performance index is 15.45. The breakdown is: goals: 0.8, assists: 0.4, key passes: 0.3, tackles: 0.1, and interceptions: 0.05.
```

**Prompt:** 
```
What are the standard weights for a Defender role?
```

**Response:** 
```
The Defender profile weights are: goalWeight: 0.1, assistWeight: 0.1, keyPassWeight: 0.1, tackleWeight: 0.4, interceptionWeight: 0.3, and errorWeight: -0.2.
```

**Prompt:** 
```
Adjust a raw score of 10.0 for a player who played only 45 minutes.
```

**Response:** 
```
The efficiency-adjusted score for 45 minutes played is 20.0.
```

## Capabilities

### Role-Based Weighting
Your agent applies different statistical weights depending on whether the player is a defender, midfielder, or attacker.

### Efficiency Scaling
The AI adjusts raw scores to a per-90-minutes basis to allow for fair comparisons.

### Statistical Validation
The engine checks your input data to ensure all stats fall within acceptable ranges before calculating.

### Contribution Breakdowns
Your agent receives a detailed list of how individual stats like goals or tackles influenced the final index.

## Use Cases

### Player Comparison
Compare a high-minute starter against a high-efficiency substitute using per-90-minute scaling.

### Scouting Reports
Generate standardized performance scores for potential transfer targets based on their raw match data.

### Tactical Evaluation
Evaluate how well a player is performing within their specific role by using role-specific weight profiles.

### Data Cleaning
Use the validation tool to ensure incoming player statistics are within logical bounds before processing.

## Benefits

- Removes subjectivity by using deterministic math for player scoring.
- Allows fair comparisons between players with different minutes played.
- Adapts scoring logic to specific player positions automatically.
- Provides a granular breakdown of how every stat affects the total score.

## How It Works

Connect the MCP to your client and start sending player stats for instant scoring.

1. Connect the MCP to your AI client via Vinkius.
2. Provide the player's raw statistics and their specific role.
3. The engine validates the stats and applies the correct role weights.
4. The AI receives the final index and a detailed breakdown of the score.

## Frequently Asked Questions

**How does the MCP handle players with different playing times?**
It uses the scale_by_efficiency tool to adjust raw scores to a standard per-90-minutes basis.

**Can I use different weights for different positions?**
Yes, you can retrieve specific weight profiles for Attackers, Midfielders, and Defenders using the get_weight_configuration tool.

**What happens if the player stats are invalid?**
The validate_component_ranges tool checks the statistics to ensure they fall within acceptable thresholds.

**Is the scoring deterministic?**
Yes, the engine uses a deterministic mathematical approach to ensure consistent results for the same inputs.

**Which AI clients can use this MCP?**
You can use this MCP with any compatible client like Claude, Cursor, or Windsurf.

**How is the performance score calculated?**
The score is calculated by normalizing raw statistics, applying weights defined by player roles, and then scaling the result based on minutes played using `scale_by_efficiency`.

**Can I use different weights for different player roles?**
Yes, you can use `get_weight_configuration` to retrieve standard weight profiles for roles like Attacker, Midfielder, or Defender.

**What happens if a player's stats are outside the normal range?**
You can use `validate_component_ranges` to check if statistics are within acceptable thresholds before performing calculations.