# Possession Statistics Calculator AI Agent Connect

> Possession Statistics Calculator MCP gives your AI client the ability to process football match data with mathematical precision. It handles everything from simple time totals to complex chronological event sequences, ensuring your match timelines are accurate and your team dominance metrics are statistically sound.

## Overview
- **Category:** analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_7z4Ik3M0iubEyAQ4NBbUjBCJyF8wigtPUBqCjXi8/ai-agent-connect
- **Tags:** football, soccer, possession, match-stats, sports-analytics

## Description

You can stop manually calculating possession splits and timeline gaps. This MCP gives your AI agent the tools to ingest raw match data and output clean, actionable football analytics. Whether you have a simple list of seconds per team or a messy chronological log of possession changes, your agent can process it instantly. You can use it to find out which team actually controlled the game or to verify that your match data doesn't have missing chunks or overlapping periods. It's built for anyone who needs to turn raw event logs into professional-grade match reports without doing the math by hand.

## Tools

### get_team_performance_comparison
This tool compares possession metrics between two teams to show who controlled the match. It provides direct statistical comparisons of their performance.

### calculate_possession_from_events
This tool processes a chronological list of possession changes. It generates detailed stats based on the sequence of events.

### calculate_possession_from_seconds
This tool handles high-level possession math. It calculates percentages using pre-aggregated time totals.

### validate_match_timeline
This tool checks the integrity of your match data. It verifies that a sequence of events covers the entire match period without gaps or overlaps.

## Prompt Examples

**Prompt:** 
```
Calculate possession for a match with 5000s home, 4000s away, 500s disputed, and 9000s regulation time.
```

**Response:** 
```
The home team had 55.56% possession, the away team had 44.44% possession, and disputed time was 5.56%. The conservation check is valid.
```

**Prompt:** 
```
Compare the performance of a home team with 60% possession and an away team with 40% possession.
```

**Response:** 
```
The home team is dominant with a possession difference of 20% and a dominance ratio of 1.5.
```

**Prompt:** 
```
Check if these event durations [4500, 4500] cover a 90-minute match.
```

**Response:** 
```
The total match time is 5400 seconds, and the total event time is 9000 seconds. The timeline is overlapping.
```

## Capabilities

### Possession Calculation
Your agent calculates exact percentages from time totals or event sequences.

### Timeline Validation
The AI checks match data for missing time or overlapping event periods.

### Team Comparison
Your agent evaluates dominance ratios and possession differences between opponents.

### Event Processing
The AI converts chronological possession changes into structured statistical summaries.

## Use Cases

### Match Integrity Checks
Use the validation tool to ensure your data feed covers the full match duration.

### Post-Match Analysis
Generate dominance reports by comparing home and away possession metrics.

### Data Cleaning
Identify and fix overlapping time periods in messy event logs.

### Rapid Stat Generation
Get quick possession percentages from simple time totals for social media updates.

## Benefits

- Eliminates manual math errors in possession splits.
- Detects errors in match timelines like overlaps or gaps.
- Converts raw event sequences into clean percentage data.
- Provides instant dominance ratios for team comparisons.

## How It Works

Connect your client to Vinkius and start feeding match data to your agent.

1. Connect your preferred MCP-compatible client to Vinkius.
2. Provide your raw match data or time totals to your AI agent.
3. The agent calls the specific tool needed for your data type.
4. The MCP processes the math and returns structured results.
5. Your agent presents the final analytics or validation report.

## Frequently Asked Questions

**How do I use this MCP with Claude?**
You connect your Claude client to Vinkius once. After that, your agent can immediately use the possession tools.

**Can this MCP handle messy match data?**
Yes. The validation tool specifically checks for gaps or overlaps in your match timelines.

**What kind of data does the possession tool need?**
It can take either pre-aggregated time totals in seconds or a chronological list of possession events.

**Does this calculate dominance between teams?**
Yes. The comparison tool provides dominance ratios and possession differences.

**Do I need to host this myself?**
No. Vinkius hosts and manages the MCP for you. You just connect and use it.

**How do I calculate possession from a list of events?**
You can use the `calculate_possession_from_events` tool by providing a JSON string of the possession events along with the regulation and extra time durations.

**Can I check if my match data has missing time gaps?**
Yes, the `validate_match_timeline` tool is designed to verify if the provided event durations cover the entire match period without gaps or overlaps.

**How is team dominance determined?**
Dominance is calculated using `get_team_performance_comparison`, which compares the possession percentages of both teams to identify the dominant side and the dominance ratio.