# API-Football MCP MCP > API-Football connects your AI agent to real-time global football data. Get live scores, league standings, and detailed player stats for over 1,000 competitions instantly. It lets you audit match history, check team rankings, or track top scorers just by asking a question. Stop switching between multiple sports websites; get all the competitive details from one authorized source. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** football-stats, live-scores, match-fixtures, player-statistics, league-standings, sports-data ## Description Need to keep tabs on global football action? This MCP gives your agent access to professional-grade data for thousands of leagues. Instead of manually checking dozens of websites—one for scores, another for standings, and a third for player stats—you just talk to your AI client. Your agent acts like a dedicated sports coordinator, pulling together everything you need in one go. You can ask about live matches, check out the current league table, or even compare how two teams performed against each other historically. Everything comes from this single source of truth. If you're building anything that tracks sports data, connecting this MCP via Vinkius lets your agent run complex audits and keep up with fan engagement without ever needing to touch a dashboard. ## Tools ### get_fixtures Lists scheduled match fixtures for specific dates or leagues. ### get_league_topscorers Retrieves a list of the top scoring players in a given league. ### get_player_info Fetches detailed performance statistics and profile data for a specific player. ### get_standings Gets the current league table, showing points, wins, and ranking for all teams. ### get_team_info Retrieves general details about a specific football club or team. ### list_leagues Returns a list of all available football leagues you can query data for. ### list_live_fixtures Gets the details and scores for matches currently in progress globally. ### search_football_teams Searches the database to find teams by name or other criteria. ## Prompt Examples **Prompt:** ``` Show me all live football matches in the Premier League (ID: 39). ``` **Response:** ``` I've retrieved the live fixtures for the Premier League. Currently, 'Manchester United' is tied 1-1 with 'Chelsea' (65'). Would you like me to check the match statistics or the live standings? ``` **Prompt:** ``` Get the latest standings for the Brasileirão Serie A (ID: 71) season 2023. ``` **Response:** ``` I've retrieved the standings for Brasileirão 2023. 'Botafogo' is leading with 51 points, followed by 'Palmeiras' with 44 points. Should I show you the full top 10 or the top scorers for this league? ``` **Prompt:** ``` What is the H2H history between Flamengo (ID: 127) and Fluminense (ID: 124)? ``` **Response:** ``` I've analyzed the H2H history between Flamengo and Fluminense. In their last 10 encounters, Flamengo has won 4 times, Fluminense 3 times, and they have drawn 3 times. The average goals per game is 2.4. Would you like to see the details of their next scheduled derby? ``` ## Capabilities ### Check real-time match status Get the score and current status for live games across thousands of leagues worldwide. ### Review league rankings Access official, up-to-date tables showing which teams are leading in major competitions. ### Analyze historical matchups Compare the head-to-head results between any two specific teams to gauge their competitive history. ### Gather team and player profiles Retrieve detailed statistics and background information for individual players or entire clubs. ### Find upcoming game schedules List all scheduled matches or fixtures for a specific date range or league. ## Use Cases ### Tracking a sudden league shift A fan notices a team's form dropping. They ask their agent to run `get_standings` and then use `get_player_info` for the key players on that team, immediately understanding who might be underperforming. ### Pre-match analysis A developer needs pre-game stats. They first call `list_leagues` to confirm IDs, then use `get_fixtures` for the match details and finally run a detailed comparison using historical data. ### Fantasy league roster check A manager needs to know if their star player is performing. They ask about the player's stats, and the agent calls `get_player_info` to pull up goal counts, assist totals, and minutes played instantly. ### Verifying team details A researcher needs basic facts on a club. They use `search_football_teams` first to find the ID, then call `get_team_info` for their history, squad size, and stadium details. ## Benefits - Stop wasting time on manual research. Instead of checking multiple sites for scores, use the `list_live_fixtures` tool to get real-time updates in one query. - You can track team health without leaving your workspace. Just ask your agent to run a league audit using `get_standings`, and it provides accurate rankings immediately. - Need context on rivals? Running an H2H comparison is simple. You can use the data to compare two teams' competitive history instantly, rather than digging through archives. - Never guess about player performance again. The `get_player_info` tool gives you deep metrics—goals, assists, minutes played—all in one go for your fantasy team. - Planning ahead? Use `get_fixtures` to pull up a full list of upcoming matches. This helps you coordinate data gathering before the season even starts. ## How It Works The bottom line is that once connected, your agent handles all the API calls for you; you just ask the question. 1. Subscribe to the API-Football MCP and input your unique API key. 2. Connect this MCP to your preferred AI client (like Claude, Cursor, etc.) through Vinkius. 3. Ask your agent a natural language question, and it uses the available tools to fetch the specific data you need. ## Frequently Asked Questions **How do I find out what games are happening right now using list_live_fixtures?** You use `list_live_fixtures`. This tool gives you the details and scores for every match that is currently in progress, letting you know who's playing and what the current score is. **Can I check league standings using get_standings?** Yes. `get_standings` fetches the official league table for any major competition, listing every team's position, points, and goal difference. **How do I look up player statistics with get_player_info?** You call `get_player_info` and provide the specific player ID. It returns a detailed profile including minutes played, goals scored, assists, and other performance metrics. **Do I need to search_football_teams first before getting info?** It's helpful to use `search_football_teams` if you only know the team name. This helps confirm the exact ID required for reliable lookups using other tools. **How do I find out what games are scheduled next?** Use `get_fixtures`. This tool lets you list all matches that are planned for a specific date or set of dates, so you can plan your analysis ahead of time. **Before I use get_league_topscorers, how do I find out what leagues are available using list_leagues?** You must run list_leagues first. This tool gives you the necessary league IDs and names to filter your search accurately. Use the ID returned from this call when making subsequent requests for scorers or standings. **Does get_team_info give me more than just current season stats about a club?** Yes, it provides deeper metadata beyond active statistics. You can retrieve structural details like the team's stadium capacity, founding date, and full historical roster names for context. **How do I ensure that get_fixtures returns matches only within a specific date range?** You pass the required start and end dates as parameters. This limits the fixture list to your desired window, preventing you from getting irrelevant historical or future data.