odds-api-io/odds-api-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
- **25 API tools** covering the full Odds-API.io v3 surface: sports, events, odds, historical data, bet settlement, value bets, arbitrage, dropping odds, and more
- **Documentation resources** for AI context
- **Real-time data** from 365+ 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) |
| get_markets | List the exact market names a sport serves, with shape, period and prematch/live availability |
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), for the markets you name |
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_settlements | Status, final score and final flag for up to 50 events |
| grade_bets | Settle up to 50 bets as won, lost, void, half won or half lost |