propline-mcp

# propline-mcp

[![npm version](https://img.shields.io/npm/v/propline-mcp.svg)](https://www.npmjs.com/package/propline-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)

Listed in the official [MCP Registry](https://registry.modelcontextprotocol.io) as `io.github.proplineapi/propline-mcp` — discoverable from Claude Code, Claude Desktop, and any MCP-aware client.

**Model Context Protocol server** for the [PropLine](https://prop-line.com/?ref=mcp) [player props betting odds API](https://prop-line.com/player-props-api?ref=mcp). 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_golf_rounds` | A golfer's completed rounds by tour (PGA, DP World, LIV, LPGA, Korn Ferry, Champions) with L5/L10/L20 (free) |
| `propline_get_golf_tournaments` | Golf tournaments with round data, by tour and season (free) |
| `propline_get_injuries` | Current injury report for NFL, NCAAF, NBA, WNBA, NHL, MLB (free) |
| `propline_get_injury_history` | Injury status changes over the last 1-90 days (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 36 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](https://cursor.com/en/install-mcp?name=propline&config=eyJ1cmwiOiJodHRwczovL21jcC5wcm9wLWxpbmUuY29tL21jcCJ9)) |
| 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:

```bash
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:

```bash
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](https://prop-line.com/?ref=mcp).

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](https://prop-line.com/?ref=mcp) — 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):

```json
{
  "mcpServers": {
    "propline": {
      "command": "npx",