# Football-Data.org MCP MCP > Football-Data.org MCP gives your AI agent instant access to global football stats. Need live scores, league standings for La Liga or the Premier League, or a player's goal tally? This MCP connects all major international leagues (Bundesliga, Serie A, etc.) directly through structured data calls. Stop checking ten different sports websites—get deep team and player analytics instantly. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** real-time-scores, sports-analytics, api-integration, league-standings, match-tracking ## Description Connecting this MCP lets you talk to global football databases using natural language. You can ask your agent for anything from a specific match's final score to the complete league table for any major competition. It pulls raw data on everything: who scored, which teams are fighting for promotion, and how certain players perform under pressure. Whether you need to track upcoming fixtures or analyze historical results across continents, this connector handles it. You just ask your AI client what you want, and the agent builds the query using the necessary tools. If you're building a sports-focused application, Vinkius makes connecting this data flow simple. It’s about getting complex, multi-layered sporting information—like correlating a player's goals with their team’s standing—without writing a single line of backend code. ## Tools ### get_area Gets detailed information for a specific geographical region in football. ### get_competition_standings Pulls the official league table for any given competition, letting you filter by home or away performance. ### get_competition Retrieves details about a single sports competition, like the Premier League. ### get_match Gets all the core details for one specific football match, from participants to results. ### get_player Fetches a complete profile and history for any professional player. ### get_team Gets the full roster, details, and general info for a specific club or team. ### list_areas Lists all available geographical areas where football competitions take place. ### list_competition_matches Retrieves a list of matches for an entire competition, letting you narrow it down by date or stage. ### list_competition_scorers Lists the goal-scoring leaders for any supported tournament. ### list_competition_teams Gives you a roster of all teams that participated in a specific competition. ### list_competitions Lists every available football league or tournament, filtering by season or ID. ### list_matches Provides a broad list of matches that happen across multiple different competitions. ### list_player_matches Retrieves all the matches that a specific player participated in. ### list_team_matches Lists every match played by a single team, letting you filter by date or opponent. ## Prompt Examples **Prompt:** ``` Show me the current Premier League standings. ``` **Response:** ``` I've retrieved the latest Premier League standings. Manchester City is currently in 1st place with 24 points, followed by Liverpool with 22 points. Would you like to see the full table? ``` **Prompt:** ``` Who are the top scorers in the Champions League right now? ``` **Response:** ``` In the current Champions League season, Harry Kane leads with 5 goals, followed by Raphinha and Erling Haaland with 4 goals each. Do you want details on a specific player? ``` **Prompt:** ``` What are the next 3 matches for Real Madrid? ``` **Response:** ``` Real Madrid's upcoming matches are: 1. vs AC Milan (Champions League), 2. vs Osasuna (La Liga), and 3. vs Leganés (La Liga). Would you like the exact dates and times? ``` ## Capabilities ### Get league standings Retrieves real-time league tables for major competitions, filtered by home, away, or total performance. ### Track match details Fetches specific information about any game, including scores, participants, and basic stats. ### List upcoming fixtures Retrieves a list of matches for an entire competition or for a single team over time. ### Identify top scorers Finds the leading goal-scorers and their totals within any supported tournament. ### View player profiles Pulls detailed biographies, performance history, and squad roles for specific players. ## Use Cases ### Preparing for a pre-match report A sports analyst needs to write about Manchester United. They ask their agent: 'Give me the current standings, the last five matches they played, and who scored most often this season.' The agent uses `get_competition_standings`, then `list_team_matches`, and finally `list_competition_scorers` to build a complete report in one go. ### Building a fantasy sports dashboard A developer needs reliable data for an app. They use the MCP's tools like `get_player` and `get_match` to pull raw stats for every player and game, making sure their application has accurate, structured inputs. ### Checking a favorite team's schedule A dedicated fan asks: 'What are Real Madrid’s next three games?' The agent uses `list_team_matches` to provide the opponent and date immediately, so they don't have to navigate through multiple league calendars. ### Analyzing a specific competition A journalist wants all data for Serie A. They ask the agent to list all available competitions first (`list_competitions`), then request the standings using `get_competition_standings` and top scorers via `list_competition_scorers`. ## Benefits - You pull structured league data—like full standings using `get_competition_standings`—instead of wading through poorly formatted website tables. - Instead of manually checking multiple sites for fixtures, you use `list_team_matches` to get a single timeline of a team's schedule and opponents. - You instantly know who the league leaders are. Running `list_competition_scorers` gets you all top goal-getters in one call, no matter the league. - Need deep context? Use `get_player` to get full career stats on a player. This is way faster than searching through Wikipedia and multiple data sites. - The ability to cross-reference everything—say, linking a team’s performance (`get_team`) with its historical match record (`list_matches`)—makes advanced analysis simple. ## How It Works The bottom line is that it turns complex web scraping and API calling into simple conversation. 1. Subscribe to this MCP and paste your Football-Data.org API Token into your client. 2. Tell your AI agent exactly what you need: 'What are the top scorers in La Liga?' 3. The agent runs the necessary data calls, receives the structured results, and presents you with a clean answer. ## Frequently Asked Questions **How do I find out which leagues are supported using list_competitions?** Run the `list_competitions` tool. This will give you a master list of all available tournaments, allowing you to select exactly what data you want next. **Can I check standings for multiple areas with get_area?** No, the `get_area` tool only retrieves details for one specific area at a time. You'll need to run this tool iteratively if you are checking multiple regions. **How do I find out the top scorers using list_competition_scorers?** Simply ask your agent to use `list_competition_scorers` and specify which competition you're interested in. It pulls all goal data for you. **What is the best way to check a team’s recent activity using list_team_matches?** Use `list_team_matches`, making sure to filter by status or date range. This gives you a chronological feed of every game that team has played. **Do I need multiple tools to get match details using get_match?** No, the `get_match` tool bundles all core data for one specific fixture—scores, participants, and results—into a single output. **What do I need to provide when using the get_team tool?** You must supply a unique team ID or an exact name. The MCP uses this identifier to pull all associated data, ensuring you don't have to guess complex parameters. **How can I use list_matches when I need fixtures across multiple competitions?** You filter the results by specific date ranges or geographical areas. This tool allows querying matches that aren't tied to one primary league structure, giving you a broader view. **What kind of deep stats does the get_player tool provide?** The tool delivers comprehensive profiles for an individual player. You retrieve not just recent activity, but also career statistics and historical performance metrics from previous seasons. **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.