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. 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 (38 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+: closing line per (book, market, outcome) — CLV helper. Accepts `period` to scope to a specific game period. |
| `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 (free) |
| `propline_get_scores` | Game scores + status (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_trends` | Hit-rate trends — over/under/push splits over last 5/10/20/50 graded games, streak, avg actual |
| `propline_get_event_ev` | Pro: cross-book +EV with no-vig fair lines |

## 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).

## 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. Pro at $19/mo unlocks resolution, history, and +EV.

### 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",
      "args": ["-y", "propline-mcp"],
      "env": {
        "PROPLINE_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}
```

Restart Claude Desktop. The hammer icon should show 13 PropLine tools.

#### Claude Code

```bash
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](https://modelcontextprotocol.io/) 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](https://prop-line.com/?ref=mcp) 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), Pro at $19/mo for 25,000 req/day, Streaming at $79/mo for 1,000,000 req/day. No credit math.

## License

MIT