MCP App Store
by KeenEthics
TheStatsAPI Football icon

TheStatsAPI Football MCP Server for Claude and ChatGPT

By TheStatsAPI

Overview

Ask Claude about football (soccer) and get answers from TheStatsAPI's data: fixtures and results, live scores, league tables, team and player season stats, squads, injuries and suspensions, lineups, player ratings, referees, shot maps with expected goals (xG) and touch heatmaps. Scoreboards, match cards, player ratings, league tables, shot maps and heatmaps appear as interactive views in the conversation. From a scoreboard you can open a match, from a table a team's matches, and from a match its ratings or shot map. Live matches refresh while you watch. Example prompts: • "Show me the Premier League table." • "When does Arsenal play next?" • "How is Erling Haaland doing this season?" • "Show the shot map from Liverpool's last match." • "Who were the best-rated players in Real Madrid's last game?" Who it's for: fans, fantasy players, analysts, journalists and developers working with TheStatsAPI's data. Requirements: a TheStatsAPI account. Sign in once to connect; requests then run on your own account. You can disconnect at any time from the API Keys page on thestatsapi.com. Limitations: football only. The connector is read-only and can't change anything in your account. It doesn't provide betting odds. Which competitions and seasons have which data (for example xG or heatmaps) depends on coverage; ask "What data do you have for the Premier League?" to check.

How to connect

  1. Claude: Open the TheStatsAPI Football listing in the Claude connectors directory and choose Connect. Claude listing TheStatsAPI Football exposes 17 tools here.
  2. ChatGPT: Open the TheStatsAPI Football listing in the ChatGPT app directory and choose Connect. ChatGPT listing TheStatsAPI Football exposes 17 tools here.

Tools

find_matches

ChatGPT
List football matches (fixtures, results, live games) as a scoreboard. Filter by date, competition, team, status or matchday. With no date it defaults to today, or for a team/competition to the 7 days either side of today. Next fixtures: team_id + status 'scheduled'. Recent results: team_id + status 'finished'. Live now: status 'live'. Pass the user's utc_offset so 'today' means their today. Prefer filtering by competition: a whole day worldwide can be hundreds of matches.

get_competition

ChatGPT
Details for one competition plus its seasons (newest first), including which season is current. Use it to find the season_id for a past season, e.g. '2022/23 Premier League'. For group-stage tournaments it also lists the groups of the chosen season (default: current).

get_data_coverage

ChatGPT
Which competitions and seasons TheStatsAPI has data for, and how complete it is (fixtures, team stats, xG, lineups, player stats, standings). With competition_id: a season-by-season breakdown. With search or data_type: matching competitions. With neither: overall totals. Use it for 'do you have data for X?' or 'which leagues have xG?'.

get_match

ChatGPT
Everything about one match as a match card: score, live minute, goals and cards, key stats (possession, xG, shots, corners…), venue and referee. Works for upcoming, live and finished matches; upcoming matches include the predicted or confirmed lineups. Get match IDs from find_matches.

get_match_player_stats

ChatGPT
Per-player statistics for one match: rating, minutes, goals, assists, shots, xG, xA, passes, tackles, duels, saves and cards, shown as player ratings by team. Works live (running totals) and after full time. Use it for 'who was the best player', 'how did X play' or comparing players in a game. Players who did not play are left out.

get_match_referee

ChatGPT
The referee assigned to a match, with career totals (games, yellow cards, red cards) and cards per game. Useful before a match for 'is this referee strict?'.

get_player

ChatGPT
A player's profile, season statistics (appearances, goals, assists, rating, shooting, passing, defending, discipline) and any current injury or suspension. Season defaults to the current season of the player's club league; pass season_id and/or competition_id for others (e.g. Champions League stats). Set include_past_injuries for the player's injury and suspension history.

get_player_heatmap

ChatGPT
Where on the pitch a player touched the ball, drawn as a heatmap. Pass match_id for one match; otherwise it covers a whole season in one competition (defaults to the current season of the player's club league).

get_profile

ChatGPT
Return the TheStatsAPI account represented by this request's authenticated credentials. The opaque id is unique within this app and remains unchanged across token refresh, reconnection, and display-metadata changes.

get_shotmap

ChatGPT
Every shot in a match drawn on the pitch, sized by expected goals (xG), with xG totals per team and the best chances. Pass player_id to show one player's shots. Only for matches that have been played. Some matches have shot locations but no xG (xg_quality 'none'): then xG fields are null, not zero.

get_squad

ChatGPT
A team's full squad: every player with position, shirt number, age, nationality, height, preferred foot, market value and contract end date, goalkeepers first.

get_standings

ChatGPT
League table (standings) for a competition season, shown as an interactive table. Defaults to the current season. For group-stage tournaments (World Cup, EURO) every group is returned; pass group for one. Knockout-only cups have no table.

get_team

ChatGPT
A team's profile, its season record in its league (position, points, form) and who is currently injured or suspended. Season defaults to the current season of the team's main league.

get_team_seasons

ChatGPT
Every competition and season in which a team has a league table (newest first), with the season IDs. Use it for a team's past league finishes: pick a season here, then call get_standings or get_team with it.

search_competitions

ChatGPT
Find football competitions (leagues, cups, international tournaments) by name or country. Returns competition IDs (comp_…) needed by get_standings, get_competition and find_matches. Use this first whenever the user names a league or cup, e.g. 'Premier League', 'La Liga', 'Champions League'.

search_players

ChatGPT
Find football players by name (accent-insensitive: 'odegaard' finds 'Ødegaard'). Returns player IDs (pl_…) needed by get_player and get_player_heatmap. Use this whenever the user names a player.

search_teams

ChatGPT
Find football clubs or national teams by name. Returns team IDs (tm_…) needed by get_team, find_matches and other tools. Use this whenever the user names a team.

find_matches

Claude

get_competition

Claude

get_data_coverage

Claude

get_match

Claude

get_match_player_stats

Claude

get_match_referee

Claude

get_player

Claude

get_player_heatmap

Claude

get_profile

Claude

get_shotmap

Claude

get_squad

Claude

get_standings

Claude

get_team

Claude

get_team_seasons

Claude

search_competitions

Claude

search_players

Claude

search_teams

Claude

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/thestatsapi"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/thestatsapi)