FootballBin Match Predictions

Get AI-powered predictions for Premier League and Champions League matches via the FootballBin MCP API.

Quick Start

Run scripts/footballbin.sh with the following commands:

Get current matchweek predictions

scripts/footballbin.sh predictions premier_league
scripts/footballbin.sh predictions champions_league

Get specific matchweek

scripts/footballbin.sh predictions premier_league 27

Filter by team

scripts/footballbin.sh predictions premier_league --home arsenal
scripts/footballbin.sh predictions premier_league --away liverpool
scripts/footballbin.sh predictions premier_league --home chelsea --away wolves

List available tools

scripts/footballbin.sh tools

Supported Leagues

Input	League
`premier_league`, `epl`, `pl`, `prem`	Premier League
`champions_league`, `ucl`, `cl`	Champions League

Supported Team Aliases

Common aliases work: united (Man Utd), city (Man City), spurs (Tottenham), wolves (Wolverhampton), gunners (Arsenal), reds (Liverpool), blues (Chelsea), villa (Aston Villa), forest (Nottingham Forest), palace (Crystal Palace), barca (Barcelona), real (Real Madrid), bayern (Bayern Munich), psg (PSG), juve (Juventus), inter (Inter Milan), bvb (Dortmund), atleti (Atletico Madrid).

Response Data

Each match prediction includes:

Half-time score (e.g., "1:0")
Full-time score (e.g., "2:1")
Next goal scorer (e.g., "Home,Salah")
Corner count (e.g., "7:4")
Key players with form-based reasoning

External Endpoints

URL	Data Sent	Purpose
`https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp`	League, matchweek, team filters	Fetch match predictions

Security & Privacy

No API key required (public endpoint, rate-limited)
No user data collected or stored
Read-only: only fetches prediction data
No secrets or environment variables needed

footballbin-predictions