Repository avatar
AI Tools
v1.0.1
active

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

AskTool
"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.

ToolReturns
list_leaguesLeague keys, seasons and the first season your plan covers. Call this first.
get_closing_linesOne row per finished game: opening and closing odds, implied probabilities, graded bets.
get_gamesGames by season, day or date range, with scores, every bookmaker's odds and match stats.
get_scoresCompact scores and statuses for one league-local day.
get_upcoming_oddsComing games with every bookmaker's current prices.
get_best_oddsThe best price of every outcome and the bookmaker offering it.
get_line_movementComing games whose market moved most since the opening.
find_arbitrageSurebets across bookmakers, with the stake split.
find_value_betsPrices above the market's no-vig fair odds.
get_pinnacle_oddsPinnacle's current moneyline, main spread and main total, re-read every 2 minutes before the start.
get_pinnacle_closing_linesPinnacle's opening and closing lines of a past day.
get_player_propsPinnacle player props now: line, odds, no-vig probability, opening line.
get_player_props_historyGraded props of a past day: closing line, result, the player's actual stat.
list_teamsTeams 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;
  • GET answers 405;
  • protocol versions 2025-06-18, 2025-03-26 and 2024-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.