# Points Per Game Calculator MCP. AI Agent Connect

> Points Per Game Calculator MCP gives your AI client the ability to process football match data instantly. It handles everything from calculating individual team PPG to generating full league summaries and validating scoring rules. Instead of manual math, you just feed your agent match results and get precise performance tables and projections.

## Overview
- **Category:** analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_EVlwv1D3TF874Q8NSy8qZYQDhzLesWF62hp8E68B/ai-agent-connect
- **Tags:** football, soccer, ppg, sports-stats, league-analysis

## Description

You can stop manually calculating league standings and performance trends. This MCP lets your AI client handle the heavy lifting of football data analysis. If you have a list of match results, your agent can immediately pull out specific team stats like total points and points per game. It goes beyond simple math by allowing you to compare how different teams are performing against each other through structured comparison tables. You can also get a bird's eye view of an entire league's activity to see how points are being distributed across the board. If you are designing a custom tournament or league, you can use it to check that your scoring rules actually work mathematically. It turns messy match logs into clean, structured insights for your analysis.

## Tools

### calculate_team_stats
This tool calculates specific performance metrics for a single team. It pulls total points, matches played, and PPG from your data.

### compare_teams_performance
Use this to generate comparison tables for multiple teams. It highlights how different squads stack up against one another.

### get_league_summary
This tool provides a high-level overview of an entire league. It summarizes match counts and total points distributed.

### validate_points_system
This tool checks your scoring configurations. It ensures your points rules are mathematically sound before you apply them.

## Prompt Examples

**Prompt:** 
```
What are the stats for team 'Arsenal' given these results: [{'homeTeam': 'Arsenal', 'awayTeam': 'Chelsea', 'homeScore': 2, 'awayScore': 1}, {'homeTeam': 'Chelsea', 'awayTeam': 'Arsenal', 'homeScore': 0, 'awayScore': 0}] and a standard points system (win: 3, draw: 1, loss: 0)?
```

**Response:** 
```
Arsenal has played 2 matches, earned 4 total points, and has a points per game (PPG) of 2.0.
```

**Prompt:** 
```
Compare the performance of 'Man City' and 'Liverpool' using these results: [{'homeTeam': 'Man City', 'awayTeam': 'Liverpool', 'homeScore': 1, 'awayScore': 1}, {'homeTeam': 'Liverpool', 'awayTeam': 'Man City', 'homeScore': 2, 'awayScore': 0}] and a standard points system (win: 3, draw: 1, loss: 0).
```

**Response:** 
```
Man City: 1 point, 1 match, 1.0 PPG. Liverpool: 4 points, 2 matches, 2.0 PPG.
```

**Prompt:** 
```
Give me a league summary for these matches: [{'homeTeam': 'A', 'awayTeam': 'B', 'homeScore': 1, 'awayScore': 0}, {'homeTeam': 'C', 'awayTeam': 'A', 'homeScore': 1, 'awayScore': 1}] with a standard points system (win: 3, draw: 1, loss: 0)?
```

**Response:** 
```
The league has 2 matches played, 3 unique teams, and a total of 4 points distributed.
```

## Capabilities

### Team Metric Calculation
Your agent calculates PPG and total points from raw match logs.

### Multi-Team Comparison
The AI generates comparison tables to rank team performance.

### League Overview
Your client summarizes total matches and points across a whole league.

### Scoring Rule Validation
The agent verifies that your points configuration is mathematically correct.

### Performance Projections
Your AI uses current performance data to project future points.

## Use Cases

### League Standings Generation
Feed a list of match results to your agent to get an instant league summary.

### Head-to-Head Analysis
Compare two specific teams to see who has the better PPG and total points.

### Rule Testing
Check if a new points system works correctly before implementing it in a tournament.

### Performance Tracking
Use current stats to project how many points a team might earn in future matches.

## Benefits

- Eliminates manual math for points per game calculations.
- Converts raw match lists into structured comparison tables.
- Provides instant validation for custom scoring rules.
- Summarizes entire league activity in one step.

## How It Works

Setting up this MCP is a one-time process that gives your AI client immediate access to football analytics.

1. Connect your AI client to Vinkius.
2. Select the Points Per Game Calculator MCP from the catalog.
3. Paste your match results or scoring rules into your AI chat.
4. The agent uses the tools to process the data and return the results.

## Frequently Asked Questions

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

**Do I need to host the MCP myself?**
No, Vinkius hosts and manages the MCP for you. You just connect and start using the tools.

**Can I use custom scoring rules?**
Yes, you can use the validation tool to ensure your specific scoring rules are mathematically sound.

**What kind of data does the MCP need?**
The MCP works best with match data containing home/away teams and scores, as well as your defined points system.

**Is this only for professional football?**
No, it works for any football or soccer league data you provide, from amateur tournaments to professional leagues.

**How is Points Per Game (PPG) calculated?**
PPG is calculated by dividing the total points earned by the number of matches played by the team.

**Can I project future points for a team?**
Yes, by using `calculate_team_stats` and providing a target match count, the tool will project points based on the current PPG.

**How do I validate my scoring rules?**
You can use the `validate_points_system` tool to check if your win, draw, and loss values follow a logical progression.