Odds-API MCP Server
OfficialThis MCP server provides AI assistants with 22 tools to access real-time and historical sports betting odds data from 265+ bookmakers across 34 sports.
Sports & Leagues: List all available sports (get_sports) and leagues for a specific sport, including inactive ones (get_leagues).
Bookmakers: List all supported bookmakers, view currently selected ones, add new selections, and clear them (get_bookmakers, get_selected_bookmakers, select_bookmakers, clear_selected_bookmakers).
Events: Browse events with filtering by league, status, date range, participant, and bookmaker (get_events); fetch a single event by ID (get_event); view all live events (get_live_events); search events by team name or text query (search_events).
Odds: Get odds for a specific event (get_odds), fetch odds for up to 10 events in one call (get_multi_odds), track historical line movements for a market (get_odds_movements), and poll for recently updated odds (get_updated_odds).
Historical Data: Retrieve finished events within a date range up to 31 days (get_historical_events) and their closing odds and final scores (get_historical_odds).
Betting Analytics: Find positive EV betting opportunities (get_value_bets), discover arbitrage opportunities with optimal stake distribution (get_arbitrage_bets), and track sharp bookmaker line movements via dropping odds (get_dropping_odds).
Participants: List teams/participants for a sport (get_participants) and retrieve a single participant by ID (get_participant).
Documentation: Fetch the full API documentation (get_documentation) or access the OpenAPI/Swagger spec directly as resources.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Odds-API MCP ServerShow me upcoming Premier League matches"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Related MCP server: AltSportsData MCP Server
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 mcp add odds-api --env ODDS_API_KEY="your-api-key" -- npx -y odds-api-mcp-serverClaude 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):
{
"mcpServers": {
"odds-api": {
"command": "npx",
"args": ["-y", "odds-api-mcp-server"],
"env": {
"ODDS_API_KEY": "your-api-key"
}
}
}
}Cursor
Add to your Cursor MCP settings (.cursor/mcp.json in your project or global config):
{
"mcpServers": {
"odds-api": {
"command": "npx",
"args": ["-y", "odds-api-mcp-server"],
"env": {
"ODDS_API_KEY": "your-api-key"
}
}
}
}VS Code
Add to your VS Code settings (.vscode/mcp.json):
{
"servers": {
"odds-api": {
"command": "npx",
"args": ["-y", "odds-api-mcp-server"],
"env": {
"ODDS_API_KEY": "your-api-key"
}
}
}
}Global Install (alternative)
npm install -g odds-api-mcp-serverThen use odds-api-mcp as the command instead of npx -y odds-api-mcp-server.
Configuration
Variable | Required | Description |
| Yes | Your API key from odds-api.io |
Available Tools
Sports & Leagues
Tool | Description |
| List all available sports with slugs |
| Get leagues for a sport (with optional |
Bookmakers
Tool | Description |
| List all supported bookmakers |
| Get your currently selected bookmakers |
| Add bookmakers to your selection |
| Clear all selected bookmakers (once per 12h) |
Events
Tool | Description |
| Get events with filtering (league, status, date range, participant, bookmaker, pagination) |
| Get a single event by ID |
| Get currently live events |
| Search events by team name or text |
Odds
Tool | Description |
| Get odds for an event from selected bookmakers |
| Get odds for up to 10 events in one call |
| Get historical line movements for a market |
| Get recently changed odds (polling) |
Historical
Tool | Description |
| Get finished events for a sport/league/date range |
| Get closing odds and scores for finished events |
Betting Analytics
Tool | Description |
| Get positive EV opportunities for a bookmaker |
| Get arbitrage opportunities with optimal stakes |
| Track sharp bookmaker line movements by sport, league, market, and time window |
Participants
Tool | Description |
| Get teams/participants for a sport |
| Get a single participant by ID |
Reference
Tool | Description |
| Fetch full API documentation |
Resources
Resource URI | Description |
| Complete API documentation |
| 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
git clone https://github.com/odds-api-io/odds-api-mcp-server
cd odds-api-mcp-server
npm install
npm run build
npm testLicense
MIT
Links
Odds-API.io - Main website
Documentation - API docs
API Reference - Swagger/OpenAPI
npm - Package registry
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityDmaintenanceConnects AI assistants to SharpEdge AI to discover +EV sports betting opportunities and arbitrage edges across major sportsbooks. It provides real-time scanner statistics, sample betting edges, and educational content on advanced betting concepts like the Kelly Criterion.Last updated58MIT
- AlicenseBqualityDmaintenanceMCP-compatible server that gives AI agents access to alternative sports data across 30+ leagues — odds, events, probabilities, settlement, and futures for prediction markets, DFS platforms, and sportsbooks.Last updated2932MIT
- Alicense-qualityCmaintenanceEnables fetching sportsbook odds, live scores, and event information across 70+ books and 30+ leagues, with tools to list sports, get scores, and discover events.Last updated3MIT
- AlicenseAqualityCmaintenanceEnables AI agents to query live sports betting data including odds, edges, arbitrage opportunities, player/team stats, and reference data using the SportWizzard API.Last updated20625MIT
Related MCP Connectors
Real-time sports betting data: odds, player props, edges and arbitrage from 35+ books and DFS apps.
Props-first sports odds API: live odds and player props across NBA, NFL, MLB and NHL.
Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/odds-api-io/odds-api-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server