# Aggregate Score Calculator AI Agent Connect

> Aggregate Score Calculator handles the math for two-legged football ties. It determines aggregate winners, identifies if a match is level, and flags when extra time or penalty shootouts are required. Your AI client uses these tools to process match scores and provide immediate tiebreak status.

## Overview
- **Category:** utilities
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_6PMHB8YlSQnk33prbwmJxeDTfAniDCZQ094grolH/ai-agent-connect
- **Tags:** football, soccer, aggregate, tiebreak, sports-stats

## Description

If you track two-legged football ties, you know how quickly things get complicated when scores are level. This MCP takes the guesswork out of aggregate math. You can feed match scores into your AI client, and it will immediately tell you who won the tie or if the match is heading toward extra time or a penalty shootout. It handles the logic for total goals and tiebreak necessity so you don't have to manually track every leg. Whether you are analyzing tournament progression or just keeping up with a specific cup competition, this tool gives your agent the specific logic needed to interpret two-legged results accurately.

## Tools

### calculate_tie_result
This tool calculates the total goals and identifies the winner of a two-legged tie. It also flags if the result requires further tiebreak procedures.

### check_shootout_eligibility
This tool checks if a tie has reached the specific state where a penalty shootout is the next logical step.

### evaluate_tiebreak_necessity
This tool determines if a tie needs extra time or penalties based on the current aggregate scores.

### get_team_aggregate_summary
This tool provides a focused summary of a single team's performance across both legs of a tie.

## Prompt Examples

**Prompt:** 
```
Team One scored 2 in the first leg and 1 in the second. Team Two scored 1 in the first leg and 1 in the second. What is the result?
```

**Response:** 
```
Team One is the aggregate winner with 3 total goals compared to Team Two's 2 total goals.
```

**Prompt:** 
```
The aggregate score is 2-2 after both legs. Has extra time been played?
```

**Response:** 
```
If extra time has not been played, the next step is Extra Time. If extra time has been played, the next step is a Penalty Shootout.
```

**Prompt:** 
```
Team One has 3 goals total and Team Two has 3 goals total. They just finished extra time. What happens next?
```

**Response:** 
```
The tie is level and the required next step is a Penalty Shootout.
```

## Capabilities

### Aggregate Winner Identification
Your agent uses this to find the winner based on total goals across two legs.

### Tiebreak Logic
The AI determines if a match needs extra time or a shootout.

### Team Performance Summaries
Your agent generates a simplified view of one team's scoring across the tie.

### Shootout Validation
The tool checks if a tie is ready for a penalty shootout.

## Use Cases

### Tournament Tracking
Use the tool to track how teams progress through knockout stages in cup competitions.

### Live Match Reporting
Check if a tie is heading to extra time immediately after the second leg ends.

### Statistical Analysis
Summarize how a specific team performed across a two-legged series.

### Tiebreak Verification
Confirm if a penalty shootout is the correct next step after extra time concludes.

## Benefits

- Eliminates manual math errors in aggregate scoring.
- Provides instant clarity on tiebreak requirements.
- Automates the identification of penalty shootout eligibility.

## How It Works

Connecting this MCP to your AI client gives your agent immediate access to football tiebreak logic.

1. Connect the MCP to your client like Claude or Cursor via Vinkius.
2. Provide the scores from the first and second legs to your agent.
3. The agent calls the necessary tools to process the aggregate math.
4. You receive the winner, total goals, or tiebreak requirements instantly.

## Frequently Asked Questions

**How do I use this MCP with Claude?**
You connect to the MCP through the Vinkius platform. Once connected, your Claude client can call the tools directly to calculate scores.

**Can this tool handle penalty shootouts?**
Yes. The tool identifies if a tie is in a state where a penalty shootout is the logical next step.

**Does it work for single leg matches?**
No. This MCP is specifically designed for two-legged ties and aggregate scoring.

**What happens if the aggregate score is tied?**
The tool evaluates the necessity of extra time or a penalty shootout based on the current score and match status.

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

**How does the tool handle penalty shootouts?**
The tool treats penalty shootout results separately. Shootout goals are used to identify the winner but are not added to the aggregate goal count.

**Can I check if a match needs extra time?**
Yes, you can use `evaluate_tiebreak_necessity` to determine if the current aggregate score requires extra time or a penalty shootout.

**What information is returned for a tie result?**
The `calculate_tie_result` tool returns total goals for both teams, the aggregate winner, the tie status, and the required next tiebreak procedure.