# Promotion & Relegation Calculator AI Agent Connect > Promotion & Relegation Calculator is a specialized MCP for football analytics. It gives your AI client the ability to process league tables, identify teams at risk of relegation, and simulate how point changes affect the entire standings structure. ## Overview - **Category:** data-analysis - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_97XtDX9HJTGkmP9Mkj7MiCbNdVOueOGerSl8Hutp/ai-agent-connect - **Tags:** football, soccer, league-standings, promotion, relegation, sports-analytics ## Description You can use this MCP to turn raw league data into actionable football intelligence. Instead of manually checking tables, you give your AI client the current points, goal differences, and league thresholds. It handles the math to determine exactly who is moving up, who is dropping down, and who is sitting in the danger zone. You can pinpoint teams on the edge of a status change by looking at the narrow gaps between promotion and safety zones. If you want to see how a specific weekend's results might shift the landscape, you can run simulations to see how a single win or loss ripples through the standings. It's built for anyone who needs to model league dynamics without doing the manual arithmetic themselves. ## Tools ### calculate_status This tool determines the final standing status for every team in a league based on current points and thresholds. ### filter_teams_by_status This tool pulls a specific list of teams that fall into a chosen category like promotion or relegation. ### get_boundary_analysis This tool finds teams sitting on the edge of a status change and calculates the exact points needed to move. ### simulate_status_change This tool predicts how a specific change in a team's performance impacts their own status and the rest of the league. ## Prompt Examples **Prompt:** ``` Calculate the status for these teams: Team A (10 pts, 5 GD), Team B (10 pts, 2 GD), Team C (5 pts, 0 GD). Thresholds: 1 promotion, 1 relegation. Tiebreak: GD. ``` **Response:** ``` Team A is in the automatic promotion position, Team B is in the safety zone, and Team C is in the relegation zone. ``` **Prompt:** ``` Who is at the boundary between safety and relegation for this league? ``` **Response:** ``` The boundary is between Team X (15 pts) and Team Y (14 pts). Team Y needs 1 more point to reach the safety zone. ``` **Prompt:** ``` What happens to the league if Team Alpha gains 3 points? ``` **Response:** ``` Team Alpha will move from the playoff position to the automatic promotion position, and Team Beta will drop from the last promotion spot to the playoff zone. ``` ## Capabilities ### Status Determination Your agent uses this to assign promotion, playoff, or relegation labels to every team in a dataset. ### Boundary Detection The AI identifies teams that are only a few points away from a different league status. ### Outcome Simulation Your agent predicts how a specific team's points change will shift the entire league table. ### Targeted Filtering The AI extracts specific groups of teams, such as only those currently in the relegation zone. ## Use Cases ### Relegation Battle Tracking Identify exactly how many points a team needs to escape the drop zone. ### Promotion Race Modeling Simulate how a win for a top team affects the playoff hunt for teams below them. ### Tiebreak Analysis Determine how goal difference shifts affect team rankings when points are equal. ### League Summary Generation Get a full breakdown of every team's status from a raw list of points and goals. ## Benefits - Removes manual math errors when calculating league standings. - Provides instant visibility into the points gap between different league zones. - Allows for rapid 'what-if' testing of match results. ## How It Works You connect the MCP to your AI client and then provide the league data. 1. Connect your AI client to the Vinkius hosted MCP. 2. Provide the current league standings and status thresholds to your agent. 3. Ask the agent to calculate statuses or simulate specific match outcomes. 4. Receive the processed league analysis directly in your chat interface. ## Frequently Asked Questions **What AI clients can I use with this MCP?** You can use any MCP-compatible client including Claude, Cursor, Windsurf, and VS Code. **Do I need to host this myself?** No, Vinkius hosts and manages the MCP for you. You just connect and start using the tools. **Can I use this for leagues other than the Premier League?** Yes, the tool works for any football league as long as you provide the points, goal differences, and status thresholds. **How does the simulation tool work?** The simulation tool takes a hypothetical change in a team's points and recalculates the entire league table to show the new status of all teams. **Can it handle tiebreaks?** Yes, you can define tiebreak rules like goal difference when you provide the data to the agent. **How does the tool handle tiebreaks?** You can specify a `tiebreakOrder` in the tool inputs. The engine will use these metrics in the provided order to rank teams with equal points. **Can I predict what happens if a team wins their next match?** Yes, use the `simulate_status_change` tool to apply a points adjustment to a specific team and see how it affects their rank and the status of others. **What information is needed to calculate league status?** You need the current standings (JSON), the threshold counts for each status (JSON), and the list of tiebreak metrics (JSON array).