Possession Statistics Calculator

Possession Statistics Calculator MCP Connector for Claude

A+

Calculate football possession percentages, average durations, and match timeline integrity.

4 tools Official Updated Oct 1, 2026 Official Vinkius Partner

This MCP server provides precise football possession analytics. It allows AI agents to process match data to determine home and away possession percentages, identify the longest continuous possession sequences, and calculate average possession durations. Use calculate_possession_from_seconds for quick totals or calculate_possession_from_events for detailed chronological analysis. It also includes validate_match_timeline to ensure all match periods are accounted for without gaps or overlaps, and get_team_performance_comparison to evaluate dominance between teams.

footballsoccerpossessionmatch-statssports-analytics

4 tools expose this connector's capabilities to your AI agent.

get_team_performance_comparison

Provides a direct comparison of the two teams' possession metrics

calculate_possession_from_events

Generates detailed statistics by processing a chronological list of possession changes

calculate_possession_from_seconds

Calculates high-level possession metrics based on pre-aggregated time totals

validate_match_timeline

Verifies if a sequence of possession events accurately covers the entirety of the match periods

See how to talk to your AI agent using Possession Statistics Calculator.

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

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.

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

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

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

The total match time is 5400 seconds, and the total event time is 9000 seconds. The timeline is overlapping.

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.

Related Connectors