# GameScorekeeper MCP > GameScorekeeper MCP gives your AI agent real-time, comprehensive data on global football and soccer. Get live scores, upcoming match schedules, full team lineups, detailed player performance history, and current team form for major competitions worldwide. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** football, live-scores, fixtures, player-stats, sports-data ## Description Use this connector to pull deep sports intelligence directly into your workflow. Instead of toggling between multiple league websites, your agent handles the complexity. You can check which tournaments are active using `list_competitions`, then instantly map out all upcoming games with `list_fixtures`. Need to know who played? Access full match lineups for any game or get a team's recent performance history via `get_team_form`. For deeper analysis, your agent pulls individual player metrics—everything from career totals to the most recent goal-scoring streak. If you find this data useful, you can connect it through Vinkius, which hosts thousands of other specialized MCPs, keeping all your external services in one place. You just ask for what you need, and your AI client figures out the rest. ## Tools ### get_competition_details Pulls detailed information for any specific tournament or league you name. ### get_fixture_lineup Gathers the complete list of players playing for each team in a specific match. ### get_fixture_details Retrieves full details about a single scheduled match, including dates and times. ### get_player_stats Retrieves historical performance metrics, showing how well a player has done over time. ### get_player_details Fetches a player's basic profile information, like their position and name. ### get_team_form Provides a summary of a team's recent results, showing their current performance streak. ### get_team_details Gets basic identifying information and logos for any given sports team. ### list_competition_stages Lists the different phases of a tournament, like 'Group Stage' or 'Knockouts'. ### list_competitions Gives you a full list of every supported football league and major competition. ### list_fixtures Lists all upcoming and past matches for an entire season or tournament. ## Prompt Examples **Prompt:** ``` Show me the upcoming Champions League fixtures. ``` **Response:** ``` Here are the next 4 Champions League fixtures: Real Madrid vs Bayern Munich (Apr 30, 21:00 CET), Arsenal vs PSG (Apr 30, 21:00 CET), Barcelona vs Dortmund (May 1, 21:00 CET), Inter vs Man City (May 1, 21:00 CET). Want lineups or team form for any match? ``` ## Capabilities ### Listing Global Tournaments Your agent lists all supported football leagues and competitions so you know exactly where to look. ### Tracking Match Schedules You pull fixture schedules, showing both upcoming matches and past game results for a specific competition. ### Analyzing Team Lineups Your agent retrieves the full player roster, including positions and numbers, for any scheduled match. ### Assessing Player Performance You retrieve a player's historical stats and individual profile data to track their career metrics. ### Gauging Team Health Your agent collects recent performance streaks for an entire team, helping you assess their current form against league rivals. ## Use Cases ### Need a comprehensive match day report A sports journalist needs to write an article comparing two teams. They ask their agent: 'What's the form for Team A and Team B, and who were the key players in their last three games?' The agent executes `get_team_form` and then uses `get_fixture_lineup` multiple times to assemble a complete draft. ### Tracking an individual player's career arc A scout wants to know if a promising young striker is improving. They ask their agent for the player’s stats, triggering `get_player_stats`. The agent returns data spanning multiple seasons and competitions, giving the scout actionable metrics. ### Building an automated league tracker A developer wants a dashboard that updates daily. They use their agent to run `list_competitions` first, then loop through all stages using `list_competition_stages`, and finally pull the next set of matches with `list_fixtures`. ### Checking tournament eligibility A fan needs to know if a team qualifies for the playoffs. They ask their agent about the league, which triggers `get_competition_details`. The agent then uses `list_competition_stages` to confirm that 'Knockouts' is the next phase. ## Benefits - Stop checking multiple websites. With `list_fixtures`, you get one comprehensive list of all upcoming matches for a whole season, not just the next round. - Never guess who plays where again. You can use `get_fixture_lineup` to pull full match rosters and player positions immediately after a game or before kickoff. - Go beyond simple scores. Running `get_player_stats` gives you measurable metrics for every key player, letting you track their true value over years of play. - Understand team momentum quickly. Instead of digging through decades of results, running `get_team_form` provides a clear snapshot of how well the squad is playing right now. - Build your own data pipelines. The MCP lets developers use natural language to access structured data via tools like `list_competitions`, saving hours of manual API calls. ## How It Works The bottom line is, you talk to your AI client in plain English, and it uses these tools to build the complete picture from start to finish. 1. First, tell your AI client which tournament or competition you're interested in so it can get the basic details. 2. Next, ask for a list of matches. This shows all the dates and opponents, letting your agent narrow down specific fixtures. 3. Finally, request the deep data: pull the lineups for an upcoming game or retrieve detailed stats for a player who played. ## Frequently Asked Questions **How do I check upcoming matches using list_fixtures?** You just tell your agent to list fixtures for the league you care about. It gives you all upcoming and past games in one view, letting you see what's coming up. **Can get_player_stats give me injury data?** The `get_player_stats` tool provides historical performance metrics like goals scored or appearances. It does not include real-time injury reports; for that, you need a dedicated medical MCP. **What if I want to know the next tournament phase?** Use `list_competition_stages`. This tool will list out phases like 'Group Stage' or 'Playoffs', letting you see how far along the competition is. **How do I authenticate my application when using `get_competition_details`?** You pass your unique API token in the request header. Vinkius handles the secure management of this key, ensuring only authorized agents can access detailed tournament metadata. **What are the rate limits if I use `get_player_stats` repeatedly?** Our standard tier allows 100 requests per minute. If you exceed this limit, your agent will receive a clear HTTP 429 error code, telling you exactly how long to wait before retrying. **What should I do if `get_fixture_details` fails for a specific match ID?** The function expects valid and active fixture IDs. If it returns an error, check the provided ID against a successful call to `list_fixtures`. The ID might be incorrect or the match may have been canceled. **Can I use `get_team_form` to compare performance across different sports?** No. This MCP is strictly for football (soccer) data only. You must call `list_competitions` first, then specify the league and team within that competition context. **When calling `get_player_details`, how do I handle missing or null fields?** The tool is designed to return structured JSON. If a specific metric like 'height' is unavailable for a player, the field will simply be null, allowing your agent to process the remaining data points. **Can I get live match lineups?** Yes! Use the `get_fixture_lineup` tool with a fixture ID to get the full starting lineup, substitutes, and formations for both teams.