PropLine — Sports Betting Odds & Prop Resolution

propline-mcp

Listed in the official MCP Registry as io.github.proplineapi/propline-mcp — discoverable from Claude Code, Claude Desktop, and any MCP-aware client.

Model Context Protocol server for the PropLine player props betting odds API. Plug it into Claude Desktop, Claude Code, or any MCP-compatible client and ask natural-language questions about live odds, prop resolution, cross-book +EV, scores, and box-score stats — the model picks the right tool, calls the API, and answers from real data.

No more "I'd need an API for that" deflections from your AI assistant. PropLine MCP turns sports-betting research into a chat.

What you can ask

Once installed, you can prompt the model with things like:

• "What's the +EV on Yankees vs Red Sox tonight across all books?"
• "Pull Aaron Judge's last 20 prop-bet history with hit/miss outcomes."
• "List today's MLB pitcher strikeout props from DraftKings and Pinnacle side by side."
• "Did Nikola Jokic's points prop hit last night? What was the line?"
• "Compare PrizePicks DFS projections to Bovada lines for tonight's NBA slate."
• "What's the first-quarter total on Lakers vs Celtics, and which book has the best Over?"

The model uses these tools transparently:

Tool	What it does
propline_list_sports	Discover what sports PropLine polls (54 today)
propline_list_events	Upcoming events for a sport, with ids
propline_list_event_markets	Available market types for an event
propline_get_odds	Live odds — bulk by sport or full props per event. Accepts period (q1/h1/p1/f5/…) to scope to game-period markets; include_depth adds order-book depth per outcome.
propline_get_odds_history	Hobby+: snapshot history per outcome; supports period (q1/h1/…) plus time-window filters (from/to, relative_from/relative_to, interval, changes_only)
propline_get_odds_closing	Hobby+: opening and closing line per (book, market, outcome) — CLV helper. Accepts period to scope to a specific game period.
propline_grade_clv	Hobby+: grade placed bets against their closing lines. Returns closing price, de-vigged closing fair (fair_source = sharpest book at close, not yours), clv_pct (price-vs-price, vig-blind) and ev_vs_close_pct (the honest number), plus the graded result once the game settles. Fail-closed matching; unstarted events come back closing_is_final: false and are excluded from the averages. devig: multiplicative or shin.
propline_price_sgp	Hobby+: price a same-game parlay at the book's own correlated odds (FanDuel, DraftKings, BetOnline, LowVig — or bookmaker: "all" for every book side by side with best_bookmaker). Returns sgp_price, independent_price (product of the live single-leg prices) and correlation_factor (their ratio). Legs are named exactly as /odds names an outcome; matching is fail-closed.
propline_export_odds_history	Backfill-pass / Enterprise: bulk line-movement tick history (every snapshot, per book) for a sport. Requires a since/until window; result capped to 200 rows (use the REST endpoint directly for the full file).
propline_get_futures	Season-long futures — championship/division/conference winners, MVP + awards, season win totals — across Bovada/FanDuel/DraftKings/Pinnacle/Kalshi (free)
propline_get_scores	Game scores + status (free)
propline_get_dfs_payouts	PrizePicks Power/Flex payout schedule + per-leg breakeven win probability (free)
propline_get_mlb_grand_salami	Synthetic daily MLB Grand Salami — total runs + each book's implied line (free)
propline_get_nhl_daily_goals_total	Synthetic daily NHL goals total — hockey's Grand Salami (free)
propline_get_resolution_summary	Graded-prop volume + per-sport/market breakdown (free)
propline_get_event_ids	Event id crosswalk — ESPN, MLB gamePk and each book's own event id (free)
propline_get_book_accuracy	Sportsbook accuracy report — how well each book prices props, vs the market (free)
propline_get_event_stats	Raw box-score stats (free, book-agnostic)
propline_get_event_context	Game conditions a prop settles under — probable pitchers, lineup flag, home-plate umpire, first-pitch weather (free)
propline_get_event_movement	Line movement + steam detection (sharp-money signal across all books) from the tick history (Hobby+). since (e.g. -6h) measures from a moment; include_book_ids adds book ids.
propline_get_event_results	Pro: graded won/lost/push per prop
propline_search_players	Free: find a player by name fragment → stable player_id + every spelling the books use (known_names)
propline_get_player_history	Player prop history with resolution; accepts a player_id; optional main_line_only; entries carry is_main_line + line_moved_in_play
propline_get_player_games	Player game log — recent games with every raw box-score stat per game, one call instead of one per event; opponent gives head-to-head (last N meetings). Raw-stat archive, so it includes games no book priced. Accepts a player_id in place of the name
propline_get_player_trends	Hit-rate trends — over/under/push splits over last 5/10/20/50 graded games, streak, avg actual (optional dfs_odds_type to scope to a PrizePicks flavor)
propline_get_event_ev	Pro: cross-book +EV with no-vig fair lines (devig: multiplicative or shin; fair_source: pick the anchor book(s), tried in order)
propline_get_event_projections	Hobby+: market-implied consensus projection per (market, player)
propline_get_best_line	Hobby+: cross-book line shopping — best price per (market, player, line) across all comparable books, all_prices sorted best-first; optional bookmakers filter
propline_list_webhooks	Streaming Lite+: list webhook subscriptions (read-only, secrets masked)
propline_get_webhook_deliveries	Streaming Lite+: recent delivery attempts for a webhook — status, HTTP code, attempts, payload; before_id pages backwards. The "why isn't my webhook firing" tool
propline_create_free_api_key	Sign the user up for a free personal key from inside the chat. Takes the email the user gives; the key is emailed to them (never returned), with a ready-made connector URL to reconnect. The only tool that is not read-only

Hosted endpoint (no install)

The same 32 tools are served over Streamable HTTP at

https://mcp.prop-line.com/mcp

Use it from any remote-capable client — nothing to install, nothing to run.

Client	How
Claude Code	claude mcp add --transport http propline https://mcp.prop-line.com/mcp
Claude.ai / Claude Desktop	Settings → Connectors → Add custom connector → URL above
Cursor	Settings → MCP → Add server → type http, URL above (one-click)
ChatGPT (developer mode)	Settings → Connectors → Create → MCP server URL above
Any client	Streamable HTTP, endpoint /mcp; GET / returns a JSON manifest

Auth is per request. Send your PropLine key as Authorization: Bearer <key> (or X-API-Key: <key>, or ?apiKey=<key> for clients that cannot set headers). With no key the endpoint falls back to the shared free demo key — every tool works, paid features are redacted, limits are pooled. Keys are used for the one request and never stored.

Claude Code with your own key:

claude mcp add --transport http propline https://mcp.prop-line.com/mcp \
  --header "Authorization: Bearer YOUR_KEY"

The stdio build below (npx -y propline-mcp) is the same code; pick whichever your client prefers.

Zero-config quick start

No key needed to try it. The server falls back to a shared public demo key, so this just works:

npx -y propline-mcp

Your agent can immediately pull live odds, scores, and stats. The demo key is free-tier and shared — paid features (resolution, +EV, history, exports) return a redacted teaser, and limits are pooled across everyone. For full access and your own limits, set PROPLINE_API_KEY (below). Get a free personal key at prop-line.com.

While the demo key is in use, every tool result carries a second content block noting the pooling and redaction, so the assistant can explain an empty field or a 429 accurately. It disappears the moment you set your own key. The note also tells the assistant it can offer propline_create_free_api_key, so a user can get their own key without leaving the chat.

Install (with your own key)

1. Get a PropLine API key

prop-line.com — free tier is 1,000 requests/day, no credit card. Hobby at $9/mo unlocks resolution, history, closing lines and +EV — Pro at $19/mo is that same feature set at 25,000 requests/day.

2. Add to your MCP client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "propline": {
      "command": "npx",
      "args": ["-y", "propline-mcp"],
      "env": {
        "PROPLINE_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}

Restart Claude Desktop. The hammer icon should show 30 PropLine tools. (Or skip the install and add https://mcp.prop-line.com/mcp as a custom connector — see the hosted endpoint above.)

Claude Code

claude mcp add propline \
  --env PROPLINE_API_KEY=YOUR_KEY \
  -- npx -y propline-mcp

Any other MCP client

Run propline-mcp as a stdio server. Most clients accept a command + env. See the MCP spec for client-specific config.

Configuration

Env var	Required	Default	Notes
PROPLINE_API_KEY	no	shared demo key	Unset = shared free demo key (paid features redacted, pooled limits). Set your own free key from prop-line.com for full access.
PROPLINE_BASE_URL	no	https://api.prop-line.com	Override for self-hosted setups

Comparison with the-odds-api

PropLine is API-compatible at the response level (same bookmakers[].markets[].outcomes[] shape) and adds three things the-odds-api doesn't offer at any tier:

1. Prop resolution — every Over/Under graded against the actual box-score stat after the game
2. Cross-book +EV — Pinnacle-anchored no-vig fair lines per book, sorted with +EV plays at the top
3. Webhooks — push delivery on Streaming tier, not pull-only

Pricing: free at 1,000 req/day (vs their 500/month), Hobby at $9/mo for 5,000 req/day, Pro at $19/mo for 25,000, Streaming Lite at $39/mo for 250,000 (webhooks + websocket), Streaming at $79/mo for 1,000,000. No credit math.

Links

• Hosted MCP endpoint: https://mcp.prop-line.com/mcp (Streamable HTTP)
• Privacy policy: prop-line.com/privacy
• Website: prop-line.com
• Player props API (markets, books, sports covered): prop-line.com/player-props-api
• API Docs: prop-line.com/docs
• Recipes (code for common jobs): prop-line.com/recipes
• Odds API by sport and market (live line, books, graded hit rate): prop-line.com/odds-api
• Prop resolution (every prop graded against the box score): prop-line.com/prop-resolution-api
• Cross-book +EV: prop-line.com/ev
• Pricing: prop-line.com/pricing
• Dashboard: prop-line.com/dashboard
• OpenAPI reference: api.prop-line.com/docs
• For AI agents (llms.txt, MCP setup): prop-line.com/for-ai-agents
• Python SDK: pip install propline
• Node SDK: npm install propline

License

MIT