
Official MCP server for Odds-API.io: live sports betting odds from 450+ bookmakers in Claude, Cursor
Official MCP server for Odds-API.io: live sports betting odds from 450+ bookmakers in Claude, Cursor and other AI tools
·
MCP server for the Odds-API.io sports betting odds API. It gives Claude, Cursor, VS Code and other AI agents live and pre-match odds from 450+ bookmakers across 34 sports, plus odds summaries, closing lines, bet settlement, golf outrights, value bets, arbitrage and dropping odds.
Get an API key at odds-api.io/pricing.
Add the server to Claude Code:
claude mcp add odds-api --env ODDS_API_KEY="your-api-key" -- npx -y odds-api-mcp-serverAsk: "Show me upcoming Premier League matches with Bet365 odds."
Setup for Claude Desktop, Cursor and VS Code is below.
The server needs an Odds-API.io API key from a paid plan. Pick a plan at odds-api.io/pricing, then pass the key as the ODDS_API_KEY environment variable.
readOnlyHint; only select_bookmakers and clear_selected_bookmakers change anything.markets filter on every odds tool (market names per sport: odds-api.io/markets), and fields / maxResults on list tools.ODDS_API_KEY only. No tool takes it as an argument, and it is masked as *** in every output and error.skills/odds-api/SKILL.md: call order, caching, quotas and 429 handling. Also served as the odds-api://guide resource and, in short form, as the server's instructions.Download the latest .mcpb file from Releases and open it. Claude Desktop will prompt you for your API key.
claude mcp add odds-api --env ODDS_API_KEY="your-api-key" -- npx -y odds-api-mcp-serverAdd 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"
}
}
}
}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"
}
}
}
}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"
}
}
}
}npm install -g odds-api-mcp-serverThen use odds-api-mcp-server as the command instead of npx -y odds-api-mcp-server.
| Variable | Required | Description |
|---|---|---|
ODDS_API_KEY | Yes | Your API key from a paid plan at odds-api.io/pricing |
Requests go to https://api.odds-api.io/v3. Each tool call is one API request against your hourly limit (multi-event tools count as one).
| Tool | Description |
|---|---|
get_sports | List sports and their slugs. Call first |
get_leagues | Leagues for a sport (all includes leagues without events) |
get_markets | Exact market names per sport, with shape, period and prematch/live flags |
get_bookmakers | All bookmakers with status (ok, degraded, down) and reason |
get_selected_bookmakers | Bookmakers selected on your key |
select_bookmakers | Add bookmakers to your selection (writes) |
clear_selected_bookmakers | Clear your selection, once per 12h (destructive) |
| Tool | Description |
|---|---|
get_events | Events with league, status (pending, live, settled, cancelled), date, participant and bookmaker filters, limit/skip |
get_event | One event with scores and live clock |
get_live_events | Events in play now |
search_events | Search by team or league name, status upcoming or live |
| Tool | Description |
|---|---|
get_odds | Odds for one event; pass markets (max 40) to keep it small |
get_multi_odds | Odds for up to 10 events in one request, with markets |
get_odds_summary | Best, average, median, worst and fair price per line across bookmakers, for one or up to 10 events (Growth plan and above) |
get_odds_movements | Opening, latest and every change for one market at one bookmaker |
get_updated_odds | Odds changed since a timestamp, for named markets (max 40), with limit |
| Tool | Description |
|---|---|
get_value_bets | Prices above a fair-odds estimate for a bookmaker, by sport and league. expectedValue is bookmaker/fair x 100, so edge % = expectedValue - 100 |
get_arbitrage_bets | Arbitrage across your bookmakers with sport, league, markets, minProfit, allCombinations. profitMargin is already a percentage |
get_dropping_odds | Biggest drops at sharp bookmakers by sport, league, market and time window |
| Tool | Description |
|---|---|
get_historical_events | Finished events for a league and date range |
search_historical_events | Finished events by team name |
get_historical_odds | Closing odds and final score for one event, with markets |
get_closing_lines | Closing odds for every settled event across up to 10 leagues and 366 days |
| Tool | Description |
|---|---|
get_settlements | Status, final score and final flag for up to 50 events |
grade_bets | Grade up to 50 bets as won, lost, void, half won, half lost, pending or ungradeable |
| Tool | Description |
|---|---|
list_outrights | Tournaments for a sport (golf: PGA Tour, DP World Tour, LIV Golf, majors) |
get_outright_odds | Winner, Top 5/10/20, Top N (Incl. Ties) and Make Cut odds, with markets and maxRunners filters |
get_outright_results | Positions, cut status and winners per market |
| Tool | Description |
|---|---|
get_participants | Teams or players for a sport |
get_participant | One team or player by ID |
get_mappings | Our events and selections mapped to bookmaker ids (Polymarket, Kalshi), lookup or bulk sync with cursor |
| Tool | Description |
|---|---|
get_usage | Hourly request limit, remaining requests and reset time |
get_documentation | Fetch the full API documentation |
Golf outright odds and results are the Outrights add-on on paid plans. Call list_outrights with sport: "golf" for tournament ids, then get_outright_odds with the id and your bookmakers. Markets: Winner, Top 5, Top 10, Top 20 (boundary ties under the bookmaker's dead-heat rules), Top 5 (Incl. Ties), Top 10 (Incl. Ties), Top 20 (Incl. Ties) (ties paid in full) and Make Cut (only for events with a cut). A full field is 150+ golfers per market, so pass markets and maxRunners. get_outright_results lists every golfer's position and the winners per market once the tournament is settled.
Without the add-on the API answers 403 with a link to enable it; the server passes that message through and tells the agent to relay it rather than retry.
get_closing_lines returns closing odds for every settled event across up to 10 leagues in one request, over up to 366 days, so a season fits in one sweep (100 events per response; page with limit and skip). Use it for closing line value (CLV) and model backtests. For a single match use search_historical_events and get_historical_odds. Paid plans.
| Prompt | Description |
|---|---|
compare_odds | Find a match and compare prices across your bookmakers |
settle_bets | Grade a list of bets against final results |
golf_outrights | Show golf tournament prices for a market |
| Resource URI | Description |
|---|---|
odds-api://guide | Agent guide: call order, caching, quotas, errors |
odds-api://documentation | Complete API documentation |
odds-api://openapi | OpenAPI specification |
Once configured, ask your AI assistant things like:
git clone https://github.com/odds-api-io/odds-api-mcp-server
cd odds-api-mcp-server
npm install
npm run build
npm testMIT
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add odds-api -- npx -y odds-api-mcp-server{
"mcpServers": {
"odds-api": {
"env": {
"ODDS_API_KEY": ""
},
"args": [
"-y",
"odds-api-mcp-server"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"odds-api","env":{"ODDS_API_KEY":""},"args":["-y","odds-api-mcp-server"],"command":"npx"}'[mcp_servers.odds-api]
command = "npx"
args = ["-y", "odds-api-mcp-server"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/odds-api-io-mcp-server to learn what the "Odds-API.io MCP Server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add odds-api --env ODDS_API_KEY="your-api-key" -- npx -y odds-api-mcp-servernpm install -g odds-api-mcp-serverThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: its npm package has not answered in our offline sandbox, which usually means it needs an API key or other configuration to start. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/odds-api-io-mcp-server)Nothing comparable is listed yet.
v1.8.4Release notesv1.8.3Release notesv1.8.2Release notesv1.8.1Release notesv1.6.1Release notesv1.6.0Release notesv1.5.1Release notesv1.5.0Release notesv1.4.0Release notesv1.3.0Release notesv1.2.2Release notesv1.2.0Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "odds-api-io-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.