propline-mcp
PropLine
Documentation
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. |
| `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. |
| `propline_price_sgp` | Hobby+: price a same-game parlay at the book's own correlated odds (FanDuel, BetOnline, LowVig). 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_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+) |
| `propline_get_event_results` | Pro: graded won/lost/push per prop |
| `propline_get_player_history` | Player prop history with resolution |
| `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 |
| `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 |
| `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 |
Hosted endpoint (no install)
The same 27 tools are served over Streamable HTTP at
https://mcp.prop-line.com/mcpUse 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 ` (or `X-API-Key: `, or `?apiKey=` 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-mcpYour 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.
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 27 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-mcpAny 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
- 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
Frequently asked questions
What is propline-mcp?
propline-mcp is PropLine
How do I install propline-mcp?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is propline-mcp open source?
Yes — it is hosted on GitHub at https://github.com/proplineapi/propline-mcp and has 1 stars.
Related MCP tools
Model Context Protocol Servers
The Open-Source Multimodal AI Agent Stack: Connecting Cutting-Edge AI Models and Agent Infra
A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you
MCP server to provide Figma layout information to AI coding agents like Cursor
The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Instant is the best backend for AI-coded apps. You get auth, permissions, storage, presence, and streams — everything you need to ship apps your users will love.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP