# Match Statistics Aggregator AI Agent Connect

> Match Statistics Aggregator provides your AI agent with the ability to process complex football performance metrics. It handles the heavy lifting of calculating totals, averages, medians, and per-90 rates for players and teams. Instead of manual math, you just ask your AI client for the specific statistical breakdown you need.

## Overview
- **Category:** statistics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_qDfBs0g8VeDtJW5xpkzrZzHr8cnrqCVn0fj9O6me/ai-agent-connect
- **Tags:** soccer, football, stats, performance, analytics

## Description

You can stop manually crunching football numbers. This MCP gives your AI client direct access to deep performance metrics for players and teams. Whether you need to see how a specific player's scoring rate has shifted over a season or you want to compare team performance across different competitions, your agent handles the math. It calculates everything from simple totals to more complex per-90 rates and medians. You can use it to find the top performers in a league or track how a team's efficiency changes between two different timeframes. It turns your AI into a specialized football analyst that can pull specific trends from large datasets instantly.

## Tools

### aggregate_player_stats
This tool pulls together individual performance metrics for a specific player.

### aggregate_team_stats
Use this to gather statistics for a specific team over a set period or competition.

### compare_periods
This tool compares how an entity performed between two different timeframes.

### rank_entities
This tool ranks players or teams based on a specific metric you choose.

## Prompt Examples

**Prompt:** 
```
What were the total goals and average shots for Manchester City this season?
```

**Response:** 
```
Manchester City has scored 72 goals and averaged 14.5 shots per match this season.
```

**Prompt:** 
```
Who are the top 5 goal scorers in the Premier League right now?
```

**Response:** 
```
The top 5 goal scorers in the Premier League are Erling Haaland (18), Mohamed Salah (14), Ollie Watkins (13), Son Heung-min (12), and Alexander Isak (12).
```

**Prompt:** 
```
How has Kylian Mbappé's scoring rate changed between the first half and second half of the season?
```

**Response:** 
```
Kylian Mbappé's scoring rate increased by 12% in the second half of the season compared to the first.
```

## Capabilities

### Metric Aggregation
Your agent calculates totals, medians, and averages for any given football metric.

### Per-90 Calculations
The AI uses per-90 rates to normalize player performance data.

### Trend Analysis
Your agent compares performance across different timeframes to find shifts in form.

### Leaderboard Generation
The AI ranks players or teams based on specific statistical criteria.

## Use Cases

### Player Scouting
Compare a prospect's performance metrics against league averages to find outliers.

### Form Tracking
Check if a team's defensive efficiency has improved or declined over the last five matches.

### Match Previews
Generate a list of top performers to highlight before a big game.

### Seasonal Reviews
Summarize a player's entire season performance using aggregated totals and averages.

## Benefits

- Calculates per-90 rates and medians automatically.
- Eliminates manual math for team and player totals.
- Identifies performance shifts between different time periods.
- Ranks entities based on custom statistical metrics.

## How It Works

Connecting this MCP to your AI client gives your agent immediate access to football statistical tools.

1. Connect your AI client to the Vinkius hosted MCP.
2. Ask your agent a specific question about football stats.
3. The agent selects the right tool to aggregate the data.
4. The AI processes the math and provides the final answer.

## Frequently Asked Questions

**What kind of football stats can this MCP calculate?**
It handles totals, averages, medians, and per-90 rates for various performance metrics.

**Can I use this with Claude or Cursor?**
Yes, you can connect this MCP to any MCP-compatible client like Claude, Cursor, or Windsurf.

**How does it handle player comparisons?**
You can use the ranking and comparison tools to evaluate players or teams across different timeframes or metrics.

**Do I need to host the MCP myself?**
No, Vinkius hosts and manages the MCP for you, so it is ready to use immediately after connection.

**Can I track team performance over time?**
Yes, the compare_periods tool allows your agent to track how a team's performance changes between different periods.

**How are per-90 rates calculated?**
Per-90 rates are calculated by dividing the total metric value by the total minutes played, then multiplying by 90.

**Can I compare two different seasons?**
Yes, you can use `compare_periods` to see how performance changed between two specific timeframes.

**How are ties handled in rankings?**
Rankings use a deterministic secondary sort key, which is the entity name in ascending alphabetical order.