# The Odds API MCP > The Odds API connects real-time sports market data directly to your AI agent. It gives you instant access to live odds from dozens of bookmakers across major leagues like the NFL, NBA, and EPL. Your agent can check scores, compare betting prices across regions (US, UK, EU, AU), or audit historical game results without leaving your chat interface. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** sports-betting, real-time-data, market-intelligence, odds-comparison, sports-analytics, api-data ## Description Listen up. This Odds API connects real-time sports market data straight to your agent. You get instant access to live odds from dozens of bookmakers covering major leagues like the NFL, NBA, and EPL. Your AI client basically turns into a dedicated sports analyst right in your chat window. You don't gotta jump between a dozen betting sites; your agent handles all that cross-referencing for you. Need to know what data's even available? You can ask the API to list every sport and league it tracks using `list_sports`. It spits out a complete rundown of everything supported right now, so you know exactly what kind of stats you're playing with. That keeps your bets focused and doesn't waste time. When you wanna see current odds, you use `get_odds`. This tool pulls the live betting prices for any specific game or sport you name. The agent compares these prices from multiple sources, so you always see the absolute best market available across different bookmakers. You can check upcoming games or even drill down into a niche league; it'll give you the whole picture. Need to know if the game is actually happening? Use `get_scores`. This gets both live and final scores for any athletic event you pick. It keeps you up-to-the-minute on active games, so you don't miss a single play or status change. Once it’s wrapped, you still get the final tally. Beyond just what's happening right now, you can audit historical data too. You run the agent to pull past game results and market movements. This helps you track trends over time—you can analyze how odds shifted during previous seasons or see if a team’s performance correlates with their betting lines. It gives you the deep dive numbers, not just today's hype. So, here's the deal: You tell your agent what you need—whether it's comparing prices across US, UK, and EU markets for basketball, or auditing every score from last year’s football playoffs. The API handles fetching and structuring all that complex data instantly. It means whatever sports data task you throw at it, your AI client gets the raw, actionable numbers back to you right away. You just talk to it like you're talking to a teammate; it does the heavy lifting of checking scores, comparing odds, and digging up old records without making you leave your chat interface. ## Tools ### get_odds Retrieves the current betting odds for a specific sport or game. ### get_scores Gets live and final scores for selected sporting events. ### list_sports Returns a list of all sports and leagues currently supported by the API. ## Prompt Examples **Prompt:** ``` Show me the current odds for the next NFL games. ``` **Response:** ``` Retrieving NFL odds... I've found several upcoming games. For example, the Chiefs vs Raiders match has odds ranging from 1.45 to 1.55 for a home win across different bookmakers. Would you like to see more markets like spreads or totals? ``` **Prompt:** ``` Check the live scores for the English Premier League. ``` **Response:** ``` Fetching live scores for soccer_epl... Liverpool is currently leading 2-1 against Chelsea at the 75th minute. Arsenal vs Man City is still 0-0. Would you like to see the stats or current live odds for these matches? ``` **Prompt:** ``` List all sports available on The Odds API. ``` **Response:** ``` Retrieving the sports list... I've identified over 100 sports and leagues, including American Football (NFL, NCAA), Basketball (NBA, WNBA), Soccer (EPL, La Liga, Serie A), and even eSports. Which one would you like to focus on? ``` ## Capabilities ### Compare Odds Across Bookmakers The agent fetches and compares betting prices for a specific game from multiple sources so you see the best market available. ### Track Live Scores and Status You get immediate, up-to-the-minute scores and status updates for any active or recently finished game. ### Audit Historical Data The agent retrieves past game results and market movements to help you analyze trends over time. ### Identify Supported Sports You ask the API to list all sports leagues available, letting you know exactly what data is accessible right now. ## Use Cases ### Tracking a Potential Bet A bettor needs to know the odds for next week's NFL game. Instead of checking five separate websites, they ask their agent: 'What are the current odds for Chiefs vs Raiders?' The agent calls `get_odds`, pulls the data from multiple sources, and gives a clear range (e.g., 1.45 to 1.55) so they know exactly what they're getting. ### Building a Live Score Dashboard An app developer needs real-time data for a custom dashboard. They use `list_sports` first, then loop through the result to call `get_scores` for every major league (EPL, NBA). The API feeds structured, consistent score updates directly into their application pipeline. ### Researching Market Value A financial analyst wants to model market risk. They ask the agent to summarize 'historical odds and game results' for a specific sport over the last month. The API pulls past data, allowing them to analyze patterns that raw score feeds wouldn't catch. ### Quick Pre-Game Check A user is getting ready for a match and just wants to know if it’s still happening and what the current status is. They ask, 'What's the score for soccer_epl?' The agent calls `get_scores` and immediately reports the live minute and differential. ## Benefits - Stop jumping between bookmaker sites. When you use `get_odds`, your agent compares prices from multiple sources automatically, showing you the best bet right away. - Need to know what's happening *now*? Use `get_scores` to pull live updates for any sport—from a 2-1 lead at minute 75 to a halftime score. It’s instant status checks. - The API handles market comparison across regions (US, UK, EU). You don't have to know which bookmaker has the best odds; just ask your agent. - Analyze trends with historical data. The server lets you review past game results and market movements so you can build out models on what worked before. - Figure out what data is available immediately by running `list_sports`. It tells you if the NBA, EPL, or another league even has data today. ## How It Works The bottom line is: You talk to your agent once. It does all the cross-referencing and fetching across dozens of external sports sites for you. 1. First, tell your AI client what you want. You might start by asking it to run `list_sports` to narrow down the leagues. 2. Next, if you need odds, the agent uses `get_odds`, specifying the sport and game. If you just need status, it calls `get_scores`. 3. The API client processes the request, pulls the live data from multiple sources, and presents a single, structured answer back to your conversation. ## Frequently Asked Questions **Can I get odds for the Premier League?** Yes! Use the `get_odds` tool with the sport key `soccer_epl`. It will return the latest odds from various bookmakers. **How do I see results for recently finished games?** Use the `get_scores` tool and provide the sport key. It will return the scores for live games and those that have recently ended. **What bookmaker regions are supported?** The Odds API supports 'us' (United States), 'uk' (United Kingdom), 'eu' (Europe), and 'au' (Australia). Use the `regions` parameter to filter odds. **What is required to use `get_odds` from The Odds API?** You must provide a valid API Key with every request. You grab this key directly from the de-odds-api site and pass it through your AI client connection. This key authenticates you and tracks your usage limits. **Are there rate limits when calling The Odds API tools?** Yes, the service enforces usage caps to ensure fair access for all users. Always check the official documentation linked in our setup guide for current request quotas and how they reset. **What does `list_sports` show about available leagues?** `list_sports` provides a comprehensive list of every sport and league supported by the API. This includes major global sports like NFL, NBA, and EPL, plus smaller niche markets. **If I get an error calling The Odds API, what should I check first?** First, verify your API key is correctly implemented in the request headers. Then, check the specific tool parameters—you might have misspelled a league name or requested unsupported data for that sport. **Does `get_scores` provide detailed box scores or just the final score?** `get_scores` provides both live and completed game status. The response includes more than just the final tally; it gives context on the current quarter, half, or minute marker for ongoing games.