# Broadage Sports MCP > Broadage Sports delivers real-time sports data directly into your workflow. Track live scores, retrieve detailed match statistics, analyze team lineups, and monitor tournament schedules using natural conversation from any AI agent. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** sports-data, live-scores, match-statistics, real-time-updates, sports-analytics, event-tracking ## Description Connect your Broadage Sports account to any AI client and get a full picture of what's happening on the field. Instead of jumping between scoreboards and stat sheets, you tell your agent exactly what you need—from seeing which soccer matches are live right now to getting deep dives into possession counts or goal timelines for past games. You can also plan coverage by listing all tournaments available globally. This means reporters get stats instantly, analysts monitor scores in real-time, and fans get the score without leaving their chat window. By connecting this MCP through Vinkius, you treat sports data like conversation; you just ask your agent to build the narrative for you. ## Tools ### get_match_events Pulls the timeline of key match events, like goals and yellow cards. ### get_match_lineup Retrieves which players are starting and who is on the bench for a specific game. ### get_match_stats Gets detailed match statistics, including possession percentage and total shots taken. ### get_match_summary Provides an immediate overview and the final score for a specific completed or current match. ### list_live_matches Shows all soccer matches that are currently in play right now. ### list_matches_by_date Finds all soccer matches scheduled for a specific calendar date. ### list_team_players Retrieves the roster details for all players on a given team. ### list_sports Provides a directory of every sport supported by the API. ### list_match_statuses Lists the predefined types of match status codes available (e.g., pre-game, half-time). ### list_tournaments Lists every major sports tournament that is supported by Broadage. ## Prompt Examples **Prompt:** ``` Show the live soccer scores for today. ``` **Response:** ``` I've checked the live matches. Currently, Arsenal is leading 2-1 against Chelsea (75'), and Real Madrid is drawing 0-0 with Barcelona (20'). ``` **Prompt:** ``` What's the starting lineup for the match with ID 12345? ``` **Response:** ``` Retrieving lineup for match 12345... Team A is playing a 4-3-3 formation with Smith in goal. Team B is using a 4-4-2. Would you like the list of substitutes? ``` **Prompt:** ``` Show match statistics for match 12345. ``` **Response:** ``` Retrieving stats for match 12345... Possession is 55% for Team A, they have 12 shots total (5 on target), and 6 corners. Team B has 45% possession. ``` ## Capabilities ### Track Live Scores List which soccer matches are currently in progress and retrieve their live score updates. ### Analyze Match Details Get detailed match statistics, including possession percentages, shots on target, and total corner kicks. ### Review Event Timelines Retrieve a minute-by-minute list of critical events for any match, such as goals scored or cards issued. ### Check Team Formations Get the starting XI and substitute players for upcoming matches to analyze team strategy. ### Plan Coverage Schedules List all matches happening on a specific date or browse the directory of supported sports and tournaments. ## Use Cases ### Drafting Pre-Game Analysis A content creator needs to write an article comparing two rivals. They ask their agent, 'What's the starting lineup for both teams and what tournaments are they in?' The agent uses `get_match_lineup` and `list_tournaments` to give them all the necessary context instantly. ### Live Score Reporting A journalist is live-blogging a game. Instead of refreshing a website, they ask their agent, 'What's the current score and what have the major events been?' The agent uses `list_live_matches` and `get_match_events` to deliver up-to-the-minute facts. ### Post-Game Deep Dive A betting analyst needs to assess a team's performance. They ask, 'Show me the detailed stats for that match.' The agent uses `get_match_stats`, which provides possession and shot data, allowing them to grade the quality of play. ### Tournament Planning A team manager needs to build a schedule. They ask, 'What soccer matches are happening next Tuesday?' The agent uses `list_matches_by_date` and confirms if the league is in one of the supported tournaments using `list_tournaments`. ## Benefits - Stop manually tracking scores. Use `list_live_matches` to get an immediate list of all games currently in play, giving you the real-time status at a glance. - Deepen your analysis with `get_match_stats`. Instead of just knowing who won, you know *how* they won by checking possession percentages and total shots taken. - Build narrative context using `get_match_events`. You don't just get the score; you get the timeline—when the goals happened and when cards were issued. - Plan coverage days ahead. Run `list_matches_by_date` or check `list_tournaments` to build a full schedule overview before writing a single word. - Understand team strategy by calling `get_match_lineup`. This instantly shows you which players are starting and who the coaches plan to use as subs. ## How It Works The bottom line is that you talk to your agent like you're talking to a sportscaster; it pulls the required data and spits out the report. 1. Subscribe to this MCP, then enter your Broadage API Subscription Key and Language ID. 2. Connect the service to your preferred AI client (like Claude or Cursor). 3. Ask your agent a natural language question—for example, 'What were the stats for yesterday's match?'—and it executes the necessary data calls. ## Frequently Asked Questions **How do I check if a tournament is supported using Broadage Sports MCP?** You use the `list_tournaments` tool to get an exhaustive list of all available sports and tournaments. This confirms if your target league is within the system's scope before you try fetching data. **Can I see scores for yesterday using Broadage Sports MCP?** Yes, you can use `list_matches_by_date` and then follow up with `get_match_summary` to get the final score and overview of a match that already happened. **What is the difference between `get_match_stats` and `get_match_events`?** `get_match_stats` provides numerical totals, like possession or shots. `get_match_events` gives a chronological list of actions—goals and cards—telling you *when* things happened. **How do I find out what sports are available?** Run the `list_sports` tool. This provides a complete directory, letting you know which types of athletics the MCP supports right out of the gate. **What happens if I use an invalid match ID with `get_match_lineup`?** The system returns a specific error code and no data. This means you'll need to verify the match ID against the results from `list_live_matches` or another source before calling the function. **How often does `list_live_matches` update score information?** The data is near real-time, but updates depend on Broadage's feed frequency. We recommend running subsequent calls every minute or two to catch the latest changes in action. **If I need roster details for multiple teams, should I use `list_team_players` repeatedly?** Yes, currently, you must call `list_team_players` once for each specific team ID. There isn't a function to query all players across several different teams at the same time. **What is the best way to get match data when I only know the tournament name, not the ID?** First, run `list_tournaments` to find the correct directory and associated IDs. Then use those specific IDs to narrow down your search before trying any other data retrieval tools. **Can I check the live score of an ongoing match?** Yes! Use the `list_live_matches` tool. Your agent will fetch all soccer matches currently in progress along with their real-time scores. **How early are match lineups available?** Match lineups are typically available 45 to 60 minutes before kickoff. Use the `get_match_lineup` tool with the specific Match ID to retrieve them. **Does the integration support sports other than soccer?** While the current toolset is optimized for soccer (football) match data, the Broadage API supports many sports. Use the `list_sports` tool to see all available sports in your subscription.