
sports-betting-odds
dev.minmaxxxer/sports-betting-odds
Betting odds data: closing lines of 390k games, Pinnacle odds and props, arbitrage and value bets
Documentation
Sports Betting Odds MCP Server
An MCP server with sports betting odds data for Claude, Cursor, VS Code and any other MCP client:
- closing lines of 390,000+ past games with every bet already graded;
- Pinnacle's current lines and player props;
- arbitrage and value bets on the coming games.
It is a remote server (Streamable HTTP, stateless JSON) served through RapidAPI, so all you need is a RapidAPI key. The BASIC plan is free.
https://sports-betting-odds-arbitrage-api.p.rapidapi.com/v1/mcp
headers: X-RapidAPI-Key: <your key>
X-RapidAPI-Host: sports-betting-odds-arbitrage-api.p.rapidapi.com
What an agent can answer
| Ask | Tool |
|---|---|
| "How did NBA home favourites do against the spread in 2024-25?" | get_closing_lines |
| "What is Pinnacle's line on tonight's Celtics game?" | get_pinnacle_odds |
| "Any surebets on this weekend's Premier League games?" | find_arbitrage |
| "Which NBA player props moved most since they opened?" | get_player_props |
| "Did the closing line beat the opening one for the Chiefs this season?" | get_closing_lines, get_line_movement |
Tools
Each tool runs the REST endpoint of the same name. Answers, plan limits and error messages are the same as REST, and one tool call is one API request.
| Tool | Returns |
|---|---|
list_leagues | League keys, seasons and the first season your plan covers. Call this first. |
get_closing_lines | One row per finished game: opening and closing odds, implied probabilities, graded bets. |
get_games | Games by season, day or date range, with scores, every bookmaker's odds and match stats. |
get_scores | Compact scores and statuses for one league-local day. |
get_upcoming_odds | Coming games with every bookmaker's current prices. |
get_best_odds | The best price of every outcome and the bookmaker offering it. |
get_line_movement | Coming games whose market moved most since the opening. |
find_arbitrage | Surebets across bookmakers, with the stake split. |
find_value_bets | Prices above the market's no-vig fair odds. |
get_pinnacle_odds | Pinnacle's current moneyline, main spread and main total, re-read every 2 minutes before the start. |
get_pinnacle_closing_lines | Pinnacle's opening and closing lines of a past day. |
get_player_props | Pinnacle player props now: line, odds, no-vig probability, opening line. |
get_player_props_history | Graded props of a past day: closing line, result, the player's actual stat. |
list_teams | Teams of a league with their IDs. |
Connect
Claude Code
claude mcp add --transport http sports-odds https://sports-betting-odds-arbitrage-api.p.rapidapi.com/v1/mcp \
--header "X-RapidAPI-Key: YOUR_KEY" --header "X-RapidAPI-Host: sports-betting-odds-arbitrage-api.p.rapidapi.com"
Cursor (~/.cursor/mcp.json)
{"mcpServers": {"sports-odds": {
"url": "https://sports-betting-odds-arbitrage-api.p.rapidapi.com/v1/mcp",
"headers": {"X-RapidAPI-Key": "YOUR_KEY", "X-RapidAPI-Host": "sports-betting-odds-arbitrage-api.p.rapidapi.com"}}}}
VS Code (.vscode/mcp.json)
{"servers": {"sports-odds": {"type": "http",
"url": "https://sports-betting-odds-arbitrage-api.p.rapidapi.com/v1/mcp",
"headers": {"X-RapidAPI-Key": "YOUR_KEY", "X-RapidAPI-Host": "sports-betting-odds-arbitrage-api.p.rapidapi.com"}}}}
Claude Desktop and other clients without custom headers, through the mcp-remote bridge:
{"mcpServers": {"sports-odds": {"command": "npx", "args": ["-y", "mcp-remote",
"https://sports-betting-odds-arbitrage-api.p.rapidapi.com/v1/mcp",
"--header", "X-RapidAPI-Key:${RAPIDAPI_KEY}",
"--header", "X-RapidAPI-Host:sports-betting-odds-arbitrage-api.p.rapidapi.com"],
"env": {"RAPIDAPI_KEY": "YOUR_KEY"}}}}
Get a key: subscribe to the Sports Betting Odds & Arbitrage API on RapidAPI.
Check it from a terminal
export RAPIDAPI_KEY=your-key
python examples/check_mcp.py
examples/check_mcp.py uses the standard library only. It runs what a client does: initialize, notifications/initialized, tools/list and one tools/call.
Data
- Leagues: NBA, NFL, MLB, NHL, ATP and WTA tennis, and 32 soccer leagues (Premier League, LaLiga, Serie A, Bundesliga, Ligue 1, Champions League, MLS and more).
- History: soccer since 2005; US leagues and tennis since 2009. About 25 bookmakers per game in current seasons.
- Pinnacle: lines recorded every 2 minutes since 22 Oct 2026. Player props for NBA, NFL, NHL, NCAAF, WNBA and MLB.
- Pre-match only: no in-play prices.
- Analysis only: the data is for analysis and the server takes no bets. Prices move, so confirm them at the bookmaker.
Protocol
MCP Streamable HTTP without SSE or sessions:
- one JSON-RPC 2.0 message per POST, answered with
application/json; - notifications get
202 Accepted; GETanswers405;- protocol versions
2025-06-18,2025-03-26and2024-11-05.
server.json is the entry for the official MCP Registry.
License
MIT for the code in this repository. The data is served under RapidAPI's terms.
No installation packages available.