# Football-Data.org MCP for AI Agents AI Agent Connect > Football-Data.org MCP gives your AI agent direct access to live football scores, league tables, and player stats from major global leagues like the Premier League and La Liga. It lets you pull real-time match data and historical results without leaving your chat interface. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_WWb5oS7C5rpojGUd0ybzk0FrYuqCmfJigHs8UOHJ/ai-agent-connect - **Tags:** real-time-scores, sports-analytics, api-integration, league-standings, match-tracking ## Description This Connector lets your agent handle the heavy lifting of gathering league standings, match results, and individual player histories on the fly. If you need to know who's leading the goal count in the Champions League or see the current Premier League table, you just ask. The agent fetches the latest numbers from Football-Data.org and puts them right in front of you. It's a huge time saver for anyone who needs to stay on top of global soccer without the constant tab-switching. You can connect this through the Vinkius catalog to get your agent up to speed on any major league in minutes. Instead of digging through archives, you're just getting the answers you need to make decisions or write reports faster. It replaces the need to manually copy and paste data from multiple sports websites into your own documents. Whether you're building a custom app or just want to know how your team is doing this weekend, you get clean, structured data in a single chat window. It's about getting the facts you need to do your job faster, without the friction of manual research. You can pull everything from full squad lists to specific match details for any competition. It makes it simple to keep your eyes on the ball by putting the stats where you actually work. ## Tools ### get_competition Pull specific details for a competition like the Premier League. This provides the core context for a league. ### get_match Retrieve specific details for a single match. It gives you the breakdown of a specific game. ### get_player Get a detailed profile and performance history for a specific player. It's perfect for checking individual form. ### get_team Pull a full team profile and current squad list. Use this to see the roster at a glance. ### list_competition_scorers Find the top goal scorers for a specific tournament. Use this to identify the league's leading hitters. ### list_competition_teams See all teams participating in a specific competition. This provides a full list of participants for a league. ### get_competition_standings Fetch league tables filtered by total, home, or away results. Use this to see who's leading the pack. ### list_competitions List available competitions with filters for specific seasons. Use this to see what leagues are currently active. ### list_matches Get a list of matches across various competitions. This is a broad way to see what's happening in the football world. ### list_player_matches See all matches played by a specific individual player. This is useful for checking a player's recent activity. ### list_team_matches List all matches for a specific team with venue or date filters. Use this to see a team's full schedule. ### get_area Get specific details for a geographical area. This is useful for identifying regional coverage. ### list_areas See a list of all geographical areas covered by the API. This helps you understand the global scope of the data. ### list_competition_matches List all matches for a competition with filters for season or date. This is great for finding specific fixtures. ## Prompt Examples **Prompt:** ``` Show me the current Premier League standings. ``` **Response:** ``` I've retrieved the latest Premier League standings. | Position | Team | Points | Played | | :--- | :--- | :--- | :--- | | 1 | **Manchester City** | 24 | 25 | | 2 | **Liverpool** | 22 | 25 | | 3 | **Arsenal** | 21 | 25 | Manchester City is currently leading the pack. Would you like to see the full table or the details for a specific team? ``` **Prompt:** ``` Who are the top scorers in the Champions League right now? ``` **Response:** ``` In the current Champions League season, the leading goal scorers are: * **Harry Kane**: 5 goals * **Raphinha**: 4 goals * **Erling Haaland**: 4 goals Would you like to see more details on any of these players or their recent match history? ``` **Prompt:** ``` What are the next 3 matches for Real Madrid? ``` **Response:** ``` Here are the upcoming fixtures for Real Madrid: 1. **vs AC Milan** (Champions League) 2. **vs Osasuna** (La Liga) 3. **vs Leganés** (La Liga) I can get the exact dates and kick-off times for these matches if you need them. ``` ## Capabilities ### Fetch live league standings Get updated tables for major competitions including total, home, and away results. ### Query past and upcoming match results Look up specific fixtures or historical scores for teams and competitions. ### Identify top goal scorers Find the leading scorers in any supported tournament instantly. ### Pull detailed player performance history Access individual player profiles and their career match data. ### Retrieve full team squad lists Get complete team profiles and current player rosters. ### Explore geographical area data View available football data across different continents and regions. ## Use Cases ### Match Preview Prep An analyst asks for the next 3 matches for Real Madrid and the current standings to write a pre-game summary. ### Top Scorer Tracking A blogger asks who is leading the Champions League goals to create a top 10 list for their audience. ### Player Form Analysis A scout pulls a specific player's match history to see how they've performed in the last five games. ### Sports App Development A developer uses the tool to pull live scores and standings to populate a custom web app. ## Benefits - Get live league standings from get_competition_standings without leaving your chat window. - Pull historical match results for any team using list_team_matches to see past trends. - Identify top scorers instantly with list_competition_scorers for tournament tracking. - Access deep player profiles via get_player to see individual performance metrics. - Quickly grab full squad lists with get_team when preparing match previews. - Explore global coverage across different continents using list_areas for diverse data. ## How It Works The bottom line is you get real-time soccer data delivered directly into your chat. 1. Subscribe to the Football-Data.org MCP via the Vinkius catalog. 2. Input your Football-Data.org API token into the configuration. 3. Ask your agent for live scores, league tables, or specific player stats. ## Frequently Asked Questions **Can the Football-Data.org MCP get scores for the Premier League?** Yes, it covers major global leagues including the Premier League. You can ask for live scores, final results, and full match details. **Does the Football-Data.org MCP provide player stats?** Yes, it pulls individual performance history and detailed profiles for specific players in supported competitions. **Can I use the Football-Data.org MCP to see league tables?** Yes, it can fetch current standings and league tables for various competitions, including filters for home and away results. **Is the Football-Data.org MCP good for sports research?** It is specifically built for research. It allows you to pull raw data for match previews, post-match reports, and statistical comparisons. **Does the Football-Data.org MCP cover different countries?** Yes, it provides geographical coverage across different continents and major leagues worldwide. **Can I see the current league table for a specific competition like the Premier League?** Yes. Use the `get_competition_standings` tool with the competition code (e.g., 'PL' for Premier League). It will return the full standings including points, goals, and form. **How do I find the top goal scorers for the current Champions League season?** Simply use the `list_competition_scorers` tool and provide the competition ID or code (e.g., 'CL'). The agent will list the top players and their goal counts. **Is it possible to check the match history or upcoming fixtures for a specific team?** Yes, you can use `list_team_matches` by providing the Team ID. You can also filter by status (e.g., 'FINISHED' or 'SCHEDULED') to see past or future games.