# API-Football MCP for AI Agents AI Agent Connect > API-Football lets you feed your AI agent real-time football data from over 1,000 leagues worldwide. Instead of jumping between sports apps, your agent handles the heavy lifting of pulling live scores, team standings, and detailed player stats. It turns your chat into a command center for everything from fantasy league management to professional sports analysis. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_cApB7DmNDlCmEXnUzeh5d2paO78DlqsZ8W8iXnYR/ai-agent-connect - **Tags:** football-stats, live-scores, match-fixtures, player-statistics, league-standings, sports-data ## Description API-Football lets you feed your AI agent real-time football data from over 1,000 leagues worldwide. Instead of jumping between sports apps, your agent handles the heavy lifting of pulling live scores, team standings, and detailed player stats. It turns your chat into a command center for everything from fantasy league management to professional sports analysis. Imagine you're trying to track every movement of your favorite league. Usually, that means having twenty tabs open, refreshing scores every thirty seconds, and manually cross-referencing player stats with league tables. It's a mess. With API-Football, you just tell your agent what you need. You can ask for a head-to-head breakdown of two rivals or see who's leading the scoring charts in a specific country. It handles the data fetching so you can focus on the strategy. Whether you're building a custom dashboard or just want to keep up with the action, this Connector pulls from a single, authorized source to give you the facts. It fits right into your existing workflow on Vinkius, letting you connect your favorite AI client to the world's most reliable football data. You stop being a data collector and start being an analyst. ## Tools ### get_fixtures Pull a list of scheduled matches for a specific date or league. This helps you plan for upcoming games without manual searching. ### get_league_topscorers See which players are leading the goal charts in a specific competition. It helps you identify top performers quickly. ### get_player_info Get detailed performance statistics and profile data for any individual player. Use this to dig into specific athlete metrics. ### get_standings Retrieve the current league table, including points and rankings. This keeps you updated on every promotion and relegation. ### get_team_info Fetch comprehensive details and profile information for a specific football club. It gives you a solid overview of any team. ### list_leagues Get a full list of available football leagues from across the globe. See which competitions you can track in one list. ### list_live_fixtures Get a real-time list of all football matches currently in progress. Use this to stay on top of live action as it happens. ### search_football_teams Search for specific clubs to find their unique IDs and basic team data. This saves you from having to guess IDs for other tools. ## Prompt Examples **Prompt:** ``` Who are the top 3 scorers in the Spanish La Liga right now? ``` **Response:** ``` Here are the current top scorers for La Liga: | Player | Goals | | :--- | :--- | | [Player Name] | 15 | | [Player Name] | 13 | | [Player Name] | 12 | Would you like to see their full season stats or the current league standings? ``` **Prompt:** ``` Show me the live scores for the Premier League. ``` **Response:** ``` The Premier League is currently active. Here are the live scores: * **Manchester United** 2 - 1 **Chelsea** (74') * **Arsenal** 0 - 0 **Liverpool** (12') * **Newcastle** 1 - 1 **Aston Villa** (45') ``` **Prompt:** ``` What's the history between Real Madrid and Barcelona? ``` **Response:** ``` I've analyzed the head-to-head history between Real Madrid and Barcelona. **Last 10 Encounters:** * **Real Madrid wins:** 4 * **Barcelona wins:** 4 * **Draws:** 2 **Average Goals per Game:** 3.1 Would you like to see the details of their next scheduled derby? ``` ## Capabilities ### Get live match scores See what's happening on the pitch right now across thousands of games. ### Check league standings Pull up current rankings and points for any major competition. ### Pull player stats Get deep performance data for specific athletes instantly. ### Look up team details Access full profiles for clubs, including historical info. ### Find upcoming fixtures See scheduled matches for specific dates and leagues. ### Track top scorers Identify who's leading the goal charts in any league. ### Search for clubs Quickly find specific teams to get their IDs and basic info. ## Use Cases ### Fantasy Draft Prep A manager asks for the top scorers in the Bundesliga to decide on a striker. The agent pulls the data instantly to help them pick the best option. ### Live Match Reporting A creator asks for live scores in the Premier League to update their social feed. The agent provides real-time updates so they never miss a goal. ### Historical Research An analyst asks for the head-to-head history between two clubs to predict an upcoming derby. The agent summarizes the last 10 games in seconds. ### League Auditing A developer asks for all fixtures in a specific country to populate a local sports app. The agent gathers the full list for the database. ## Benefits - Stop manual searching: Use `list_live_fixtures` to see every game happening right now without opening multiple sports apps. It saves you from constant tab refreshing. - Instant H2H analysis: Compare team histories instantly using `get_team_info` to see how they stack up against rivals. It gives you a clear picture of historical dominance. - Automated scouting: Get deep player metrics with `get_player_info` to build better fantasy rosters or scouting reports. You can see stats that matter for your strategy. - Real-time league tracking: Keep tabs on every promotion and relegation with `get_standings` updated as matches finish. It ensures your data is always current and accurate. - Quick club discovery: Use `search_football_teams` to find any club in the world and get their specific data points immediately. It removes the friction of searching manually. ## How It Works The bottom line is you get instant access to global football data without ever leaving your chat interface. 1. Subscribe to the API-Football MCP on Vinkius. 2. Plug in your API-Sports (API-Football) API key in your client settings. 3. Ask your agent for scores, standings, or stats in plain English. ## Frequently Asked Questions **What leagues does the API-Football MCP cover?** It covers over 1,000 leagues globally, from major European divisions to smaller regional competitions. You can get data for almost any major football league in the world. **Can I use API-Football to track live scores?** Yes, you can get real-time updates for thousands of matches currently in progress. It's a great way to keep up with the action as it happens. **Does the API-Football MCP include player stats?** It provides detailed performance data for players, including goals and other key metrics. You can use it to track specific athletes across different seasons. **How do I get league standings with API-Football?** You can request the current table for any league, showing points, wins, and rankings. It's updated as matches finish to keep your data accurate. **Can I find specific team info using API-Football?** Yes, you can search for clubs to get their profiles, IDs, and basic team details. This makes it easy to gather info on any team in the world. **Is API-Football good for fantasy football?** It's perfect for tracking player stats and league trends to help you make better roster decisions. You can get the data you need to build a winning team. **How do I find my API-Football (API-SPORTS) Key?** Log in to the [API-SPORTS Dashboard](https://dashboard.api-football.com/), navigate to the 'API-Key' section, and copy your unique token. **Does the API provide real-time updates?** Yes! The `list_live_fixtures` tool retrieves results from the real-time match engine of API-Football, covering goals, cards, and status updates as they happen. **Can I filter leagues by country?** Yes! Use the `list_leagues` tool and provide the `country` parameter (e.g., 'Brazil', 'England') to see only the competitions available in that specific region.