Live sports betting odds from 265+ bookmakers across 34 sports, with value bets and arbitrage.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Capabilities & Tool Schemas (22)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Odds API MCP Server.
get_sportsList all available sports with slugs
get_leaguesGet leagues for a sport (with optional `all` flag for inactive leagues)
get_bookmakersList all supported bookmakers
get_selected_bookmakersGet your currently selected bookmakers
select_bookmakersAdd bookmakers to your selection
clear_selected_bookmakersClear all selected bookmakers (once per 12h)
Documentation Overview
Odds-API.io MCP Server
Model Context Protocol (MCP) server for Odds-API.io - providing AI tools like Claude, Cursor, and VS Code with direct access to sports betting odds data.
Full AI-tooling docs: docs.odds-api.io/ai-vibe-coding
Features
- 22 API tools covering the full Odds-API.io v3 surface: sports, events, odds, historical data, value bets, arbitrage, dropping odds, and more
- Documentation resources for AI context
- Real-time data from 265+ bookmakers across 34 sports
Quick Start
One-Click Install (Claude Desktop)
Download the latest .mcpb file from Releases and open it. Claude Desktop will prompt you for your API key.
Claude Code CLI
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):
Cursor
Add to your Cursor MCP settings (.cursor/mcp.json in your project or global config):
VS Code
Add to your VS Code settings (.vscode/mcp.json):
Global Install (alternative)
Then use odds-api-mcp as the command instead of npx -y odds-api-mcp-server.
Configuration
| Variable | Required | Description |
|---|---|---|
ODDS_API_KEY | Yes | Your API key from odds-api.io |
Available Tools
Sports & Leagues
| Tool | Description |
|---|---|
get_sports | List all available sports with slugs |
get_leagues | Get leagues for a sport (with optional all flag for inactive leagues) |
Bookmakers
| Tool | Description |
|---|---|
get_bookmakers | List all supported bookmakers |
get_selected_bookmakers | Get your currently selected bookmakers |
select_bookmakers | Add bookmakers to your selection |
clear_selected_bookmakers | Clear all selected bookmakers (once per 12h) |
Events
| Tool | Description |
|---|---|
get_events | Get events with filtering (league, status, date range, participant, bookmaker, pagination) |
get_event | Get a single event by ID |
get_live_events | Get currently live events |
search_events | Search events by team name or text |
Odds
| Tool | Description |
|---|---|
get_odds | Get odds for an event from selected bookmakers |
get_multi_odds | Get odds for up to 10 events in one call |
get_odds_movements | Get historical line movements for a market |
get_updated_odds | Get recently changed odds (polling) |
Historical
| Tool | Description |
|---|---|
get_historical_events | Get finished events for a sport/league/date range |
get_historical_odds | Get closing odds and scores for finished events |
Betting Analytics
| Tool | Description |
|---|---|
get_value_bets | Get positive EV opportunities for a bookmaker |
get_arbitrage_bets | Get arbitrage opportunities with optimal stakes |
get_dropping_odds | Track sharp bookmaker line movements by sport, league, market, and time window |
Participants
| Tool | Description |
|---|---|
get_participants | Get teams/participants for a sport |
get_participant | Get a single participant by ID |
Reference
| Tool | Description |
|---|---|
get_documentation | Fetch full API documentation |
Resources
| Resource URI | Description |
|---|---|
odds-api://documentation | Complete API documentation |
odds-api://openapi | OpenAPI/Swagger specification |
Example Usage
Once configured, ask your AI assistant things like:
- "What sports are available on Odds-API?"
- "Show me upcoming Premier League matches"
- "Get odds for the next Arsenal match from Bet365 and SingBet"
- "Find value bets on Bet365 with event details"
- "Are there any arbitrage opportunities between Bet365 and Unibet?"
- "Show me how the odds moved for event 12345 on the spread market"
- "Get historical results for La Liga in January 2026"
- "Show me the biggest dropping odds in football right now"
- "What Premier League odds have dropped the most in the last 12 hours?"
Development
License
MIT
Links
- Odds-API.io - Main website
- Documentation - API docs
- API Reference - Swagger/OpenAPI
- npm - Package registry
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
1
Stargazers on the source repository.
npm downloads
339
Package downloads in the last 30 days.
Last commit
1mo ago
Most recent push to the default branch.
Tools exposed
22
Callable tools this server registers over MCP.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Odds API MCP Server
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/odds-api-mcp-server)HTML Embed
<a href="https://allmcps.com/mcp/odds-api-mcp-server"><img src="https://allmcps.com/api/badge/odds-api-mcp-server?style=directory" alt="Odds API MCP Server on AllMCPs" /></a>Technical Specs & Signals
CategoryDeveloper Tools
53Quality signal: Good · 53/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools25/30
Adoption & activity5/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.