# TheRundown MCP > TheRundown MCP Server pulls real-time sports data, betting odds, and schedules for NFL, NBA, MLB, NHL, and more directly into your AI client. You use it to check live scores, compare odds across books, or plan out entire season schedules without leaving your chat interface. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** sports-data, betting-odds, live-scores, nfl, nba, mlb, real-time-data ## Description You're hooking up **TheRundown** to your AI client, so you can pull real-time sports data—betting odds, scores, schedules for NFL, NBA, MLB, NHL, and more. You don't gotta leave your chat window to check a score or compare lines across books. To get started, you first need to know what we cover. Use `list_sports` to grab a list of all supported sports; that tells you the sport names and their unique IDs—like knowing NFL is ID 2. Need to track something today? You can use `list_events_by_sport` to pull up every single event happening for a specific sport on a given date. This tool doesn't just give you titles; it lets you optionally ask for scores or even period-by-period breakdowns of the action. If you zero in on one game, you have two deep dives. First, use `get_event` to pull detailed metadata about that specific sporting event using its unique ID. This gives you everything—like who's playing and where it is. Second, if you wanna know what the money says, run `get_event_odds`. This fetches the current betting lines and odds from multiple sportsbooks so you can compare spreads and totals instantly. For planning ahead or tracking a season, forget scrolling through ten different websites. Just ask for the full calendar by using `get_sport_schedule` to get the upcoming game schedule for an entire sport. This lets you map out the whole season progress right in your conversation thread. These tools let you check live scores and compare odds or plan out entire season schedules without leaving your chat interface. ## Tools ### get_event_odds Fetches the latest betting odds for an event from multiple sportsbooks. ### get_event Retrieves detailed metadata about a specific sporting event using its unique ID. ### list_events_by_sport Lists all events for a chosen sport on a given date, optionally including scores or period breakdowns. ### get_sport_schedule Retrieves the full calendar schedule for a specific sport. ### list_sports Returns a list of supported sports and their corresponding IDs (e.g., NFL=2). ## Prompt Examples **Prompt:** ``` List all available sports and their IDs from TheRundown. ``` **Response:** ``` I've retrieved the supported sports. Some key IDs include: NFL (2), NBA (4), MLB (3), and NHL (6). Which league would you like to explore? ``` **Prompt:** ``` Show me the NFL games scheduled for 2024-11-10. ``` **Response:** ``` Searching for NFL events on that date... I found several matchups, including 'Philadelphia Eagles vs. Dallas Cowboys' and 'Detroit Lions vs. Houston Texans'. Would you like the betting odds for any of these? ``` **Prompt:** ``` Get the latest odds for event ID 492031. ``` **Response:** ``` Fetching odds for event 492031... For this matchup, the Spread is currently -3.5 for the home team at Pinnacle and -3.0 at DraftKings. The Total is set at 48.5 points. ``` ## Capabilities ### Get Event Details Retrieve detailed metadata—like location or participants—for one specific sporting event using its ID. ### Check Betting Odds Fetch the current betting lines and odds from multiple sportsbooks for a given game or matchup. ### List Sports Leagues Get a list of all supported leagues (NFL, NBA, etc.) along with their unique IDs to target your searches. ### Find Events by Date Pull a list of all events happening for a specific sport on a given date, including scores or period-by-period breakdowns. ### Get Sport Schedules Retrieve the full upcoming game schedule for an entire sport to track season progress. ## Use Cases ### Need to know if the game was postponed. A user wants to check if an NFL matchup is still on. Instead of checking multiple news sites, they ask their agent: 'What's the status for the Eagles vs. Cowboys on 2024-11-10?'. The agent uses `list_events_by_sport` and then passes the resulting ID to `get_event`, giving them the current field status or postponement notice immediately. ### Betting before a game requires comparing lines. A bettor needs to know if the line on the NBA Finals changed. They first use `list_sports` to confirm the correct ID, then they call `get_event_odds` with the event ID. The agent returns the current spread and total from multiple sources in one block of text. ### Building a daily league briefing. A content creator needs to list all games happening across three different sports (MLB, NBA, NFL) next week. They use `list_sports` first to get the IDs, then run multiple calls to `get_sport_schedule` for each sport ID, compiling one master schedule. ### Checking a deep-cut event detail. A researcher needs specific details about an old MLB game. They use `list_sports` and then narrow down the date/sport to find the unique ID. Finally, they hit `get_event` with that ID to pull all available metadata for analysis. ## Benefits - Stop digging through multiple websites. You can check the status of an event using `get_event` or find out all matchups on a specific day with `list_events_by_sport`. It's all one prompt away. - Compare betting odds instantly. Instead of visiting five different sportsbook sites, just call `get_event_odds` and see the spread and total for multiple books in one shot. - Plan season-long strategies easily. Use `get_sport_schedule` to map out an entire league's calendar view—it saves you from manually tracking dates week after week. - Pinpoint exactly what data you need. If you only care about the NBA, use `list_sports` first to get the ID, then narrow your search using the other tools. It keeps your queries clean. - No more vague results. By calling `get_event`, you pull deep metadata for a specific event that tells you exactly where and when it happened, giving context beyond just the score. ## How It Works The bottom line is: your AI agent handles the multi-step querying process using specialized tools so you get a single, clean answer about sports data. 1. First, your AI client uses `list_sports` or `list_events_by_sport` to define the league and date you're interested in. 2. Next, you use the unique event ID to call `get_event` for basic details or `get_event_odds` if you need betting lines. 3. The server processes the request against real-time feeds and returns structured data containing scores, odds, or schedules. ## Frequently Asked Questions **How do I find out what sports TheRundown supports?** Use the `list_sports` tool. This call returns a structured list of every supported league (NFL, NBA, MLB, etc.) and their unique corresponding IDs for you to use in later queries. **Can I check betting odds for an event using get_event_odds?** Yes. You must first obtain the specific event ID—for example, from running `list_events_by_sport`—and then pass that exact number to the `get_event_odds` tool. **Is get_sport_schedule for live scores?** No. `get_sport_schedule` shows upcoming games across a whole season. For real-time or recent scores, you need to use `list_events_by_sport`, which accepts a specific date. **What if I only want the NBA schedule for next week?** You can run two tools back-to-back. First, confirm the sport ID with `list_sports`. Then, use the correct ID and the target date in `get_sport_schedule` to pull exactly what you need. **If I run get_event with an invalid ID, what error message do I receive?** The API returns a specific 'Not Found' error code. This means the unique event identifier you provided does not exist in TheRundown database or is malformed. **Are there rate limits when calling list_events_by_sport?** The server handles high-volume querying, but extremely rapid calls can trigger temporary throttling. We advise spacing out your requests for reliable performance. **What kind of detailed metadata does get_event provide beyond just the scores?** It pulls comprehensive data including venue details, period-by-period score breakdowns, and team statistics necessary for deep performance modeling. This goes far beyond simple final scores. **How do I use list_events_by_sport to find an event ID so I can check odds with get_event_odds?** First, run list_events_by_sport for the desired date and sport. Then, take one of the resulting unique IDs and input it directly into the get_event_odds tool. **How do I find the correct ID for a specific sport like NFL or NBA?** Use the `list_sports` tool. It will return a complete list of all supported sports along with their corresponding IDs (e.g., NFL is 2, NBA is 4). **Can I see the betting odds from different sportsbooks for a single game?** Yes! By using the `get_event_odds` tool with a specific event ID, the agent will fetch the latest lines and odds from various available sportsbooks. **How can I check the upcoming schedule for a specific league?** You can use the `get_sport_schedule` tool. Just provide the sport ID, and it will return the upcoming games and events scheduled for that sport.