The Odds API
The Odds API provides real-time sports betting odds data from various bookmakers worldwide, covering multiple sports and betting markets.
Verdict
Common use cases
- Compare live odds across bookmakers before kickoff
- Pull final scores for recap posts
- Track line movement for betting analysis
- Identify arbitrage opportunities across markets
- Generate game previews with current spreads
Integration
- Vendor
- The Odds API
- Category
- other
- Auth
- API_KEY
- Tools
- 6
- Composio slug
the_odds_api
Tools
- Get Event Odds
Tool to retrieve odds for a specific event. use after confirming sport key and event id to obtain bookmaker and market details.
- Get Events
Tool to fetch live and upcoming events for a specified sport. use when you need event listings including odds.
- Get Odds
Tool to fetch live and upcoming event odds for a specified sport, including bookmakers, regions, and markets. use after retrieving sports via get sports; filter by region, market, or event ids.
- Get Participants
Tool to fetch list of participants (teams or players) for a specified sport. use after confirming you have a valid sport key.
- Get Scores
Tool to return live and recently completed event scores for a sport. use after selecting a sport key to inspect current and recent game scores.
- Get Sports
Tool to retrieve a list of in-season sports. use when you need sports data; set 'all' to true to include out-of-season sports.
Setup
Setup guide
- 11. Visit theoddsapi.com and sign up for an API key (free tier or paid plan depending on request volume). 2. Copy your API key from the dashboard. 3. In Switchy, open your workspace settings and navigate to the Integrations tab. 4. Find The Odds API in the MCP directory and click Connect. 5. Paste your API key when prompted and confirm. 6. Open any Space and type '@The Odds API get sports' to test — you should see a list of in-season sports. 7. To fetch odds for a specific sport, use '@The Odds API get odds' followed by a sport key like 'basketball_nba' or 'soccer_epl'. 8. Check your API usage in the vendor dashboard to avoid hitting rate limits mid-conversation.
What teammates see: by default, memories from The Odds API are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Tonight's NBA Lines
@The Odds API get odds for basketball_nba with regions=us and markets=spreads,h2h. Show me tonight's games with opening and current lines from DraftKings and FanDuel.Open in a Space →
Premier League Scores
@The Odds API get scores for soccer_epl. Give me final scores from this weekend's matches plus any games currently in progress.Open in a Space →
Best Underdog Value
@The Odds API get odds for baseball_mlb with markets=h2h and regions=us. Find the three biggest underdog payouts available right now and tell me which books are offering them.Open in a Space →
Line Movement Report
@The Odds API get event odds for the Chiefs vs Bills game this Sunday. Show me the current spread at five major books and note if the line has moved since it opened.Open in a Space →
Arbitrage Scan
@The Odds API get odds for tennis_atp with markets=h2h and regions=uk,us,au. Check if there are any two-way arbitrage opportunities in today's matches where I can bet both sides profitably.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@theoddsapi what are the current betting lines for tonight's NBA games?
Here are tonight's NBA matchups with odds from major sportsbooks: Lakers vs. Celtics (7:30 PM ET) — DraftKings has Lakers -3.5 at -110, over/under 225.5; FanDuel shows -3 at -108. Warriors vs. Nuggets (10 PM ET) — Consensus line sits at Nuggets -6, total 232. Heat vs. 76ers (7 PM ET) — Pick'em on most books, slight lean to Heat -1. All lines pulled from US-region bookmakers within the last 15 minutes.
This example combines Get Events and Get Odds to surface live betting markets. The MCP requires a valid API key with sufficient quota — free tiers typically cap at 500 requests/month. Odds refresh frequently; responses reflect a snapshot, not real-time streaming. Users should confirm their API plan covers the desired sport and region before relying on this for time-sensitive decisions.
@theoddsapi track the score for the Manchester United match and alert me when it finishes
I've queried the current score using Get Scores for soccer_epl (English Premier League). Manchester United is leading 2-1 in the 78th minute against Arsenal. However, The Odds API does not support push notifications or webhooks — I can only poll scores on demand. To monitor completion, you'd need to re-prompt me periodically (e.g., '@theoddsapi check that United score again') or set up a separate polling script outside this Space.
This example highlights a common limitation: the MCP is pull-based, not event-driven. Get Scores returns current and recently completed match data, but continuous monitoring requires repeated calls. Users should be aware of their API quota when polling frequently. The MCP works best for one-off score checks or post-game summaries, not live alerting workflows.
@theoddsapi compare the moneyline movement for tomorrow's MLB games and summarize which teams are seeing sharp money
I pulled odds from Get Odds for all upcoming MLB games and compared opening lines to current spreads. The Dodgers opened at -140 and have moved to -165 against the Padres — a 25-cent shift suggesting heavy favorite action. The Yankees line tightened from -120 to -110, indicating balanced two-way betting. The Astros saw reverse line movement: opened -130, now -115 despite 70% of public bets on Houston, which often signals sharp money on the underdog. This synthesis is illustrative; actual line movement depends on bookmaker feed timing and your API's historical data access.
This example pairs the MCP's odds retrieval with AI reasoning to identify betting trends. The Odds API does not natively track line history — you'd need to store snapshots over time or use a paid tier with historical endpoints. The AI can infer patterns from current vs. opening lines if both are returned, but true sharp-money detection requires external context. Best for exploratory analysis, not automated trading signals.
Use-case deep-dives
When this MCP helps a 6-person fantasy football group make smarter bets
A fantasy league group meets Sunday mornings to set lineups and side bets. One person shares their screen in Zoom, pulls live odds from The Odds API MCP, and the group compares spreads across three bookmakers before locking picks. The MCP's Get Odds and Get Scores tools surface real-time lines and injury-adjusted numbers faster than toggling browser tabs. This works if your group bets recreationally and wants a single source for odds comparison. If you're running a serious betting operation with custom models or need historical line movement, this MCP won't replace a dedicated analytics platform. For casual groups making 5-10 picks a week, it's the right call.
When a 3-person sports blog uses this MCP to write betting previews
A small sports blog publishes game previews twice a week. The writer uses The Odds API MCP to pull opening lines, participant rosters, and recent scores in one Switchy session, then drafts the preview without switching apps. The Get Events and Get Participants tools let them confirm team names and matchup details without manual lookups. This setup works if your content calendar is predictable and you're covering mainstream sports with consistent API coverage. If you're writing about niche leagues or need play-by-play data, the MCP's six tools won't cover it. For blogs publishing 8-12 previews a month, it cuts research time in half.
When a 2-person team uses this MCP to validate a betting app concept
A founder and a developer are prototyping a mobile app that aggregates odds for college basketball. They use The Odds API MCP in Switchy to test data quality and API response times before committing to a paid tier. The Get Sports and Get Event Odds tools let them simulate user flows and confirm bookmaker coverage without writing integration code. This works for early validation when you're still deciding if the API's region and market filters match your product vision. If you need sub-second latency or plan to scale past 500 requests a day, you'll outgrow the free tier fast. For pre-launch testing, it's the cheapest way to prove the concept.
Frequently asked
What does The Odds API MCP do in Switchy?
It pulls live sports betting odds, event schedules, scores, and participant data from The Odds API directly into your Switchy workspace. Your team can query odds across dozens of bookmakers, track line movements, and compare markets without leaving the chat. Useful for sports analytics teams, betting operations, or anyone building odds-comparison tools.
Do I need a paid Odds API account to connect this MCP?
Yes. You need an active Odds API subscription and a valid API key. The free tier gives you 500 requests per month, which burns fast if you're polling live odds. Switchy doesn't include Odds API credits—your usage counts against your own plan limits, so monitor your quota in their dashboard.
Can this MCP place bets or manage sportsbook accounts?
No. The Odds API is read-only—it fetches odds, scores, and event data but never touches your sportsbook accounts. If you want to place bets programmatically, you need direct integrations with individual bookmakers. This MCP is for analysis and comparison, not execution.
How is this better than scraping bookmaker sites directly?
The Odds API aggregates data from 40+ bookmakers in a single normalized format, so you skip the legal and technical mess of scraping. You get consistent field names, real-time updates, and no risk of IP bans. If you only care about one bookmaker, their API is simpler—but for multi-book comparison, this wins.
Who on my team should connect The Odds API MCP?
Whoever holds your Odds API key and understands your request budget. Since every tool call consumes API credits, you want someone who knows which sports and markets matter. If multiple people need access, share the Switchy workspace—don't create duplicate connections that waste quota.