propline-mcp 0.23.1 → 0.25.0

package/README.md

@@ -45,10 +45,12 @@ The model uses these tools transparently:
 | `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_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 21 tools are served over **Streamable HTTP** at
+The same 23 tools are served over **Streamable HTTP** at
 
 ```
 https://mcp.prop-line.com/mcp
@@ -145,6 +147,7 @@ Pricing: free at 1,000 req/day (vs their 500/month), Pro at $19/mo for 25,000 re
 ## Links
 
 - **Hosted MCP endpoint**: `https://mcp.prop-line.com/mcp` (Streamable HTTP)
+- **Privacy policy**: [prop-line.com/privacy](https://prop-line.com/privacy)
 - **Website**: [prop-line.com](https://prop-line.com/?ref=mcp)
 - **API Docs**: [prop-line.com/docs](https://prop-line.com/docs?ref=mcp)
 - **Recipes** (code for common jobs): [prop-line.com/recipes](https://prop-line.com/recipes?ref=mcp)

package/dist/http.js

@@ -210,10 +210,25 @@ var PropLineClient = class {
       includeLinks: opts.includeLinks ? "true" : void 0
     });
   }
+  // ----- Webhooks (READ-ONLY on purpose) -----
+  // Create is excluded because it returns the HMAC signing secret exactly
+  // once — through MCP that lands in a model context window and whatever
+  // logs it. Update/delete/test are excluded as side-effectful. The read
+  // surface (list shows the secret MASKED; deliveries is the debugging
+  // log) is what an agent needs to answer "why isn't my webhook firing".
+  listWebhooks() {
+    return this.request("/v1/webhooks");
+  }
+  listWebhookDeliveries(webhookId, opts = {}) {
+    return this.request(`/v1/webhooks/${webhookId}/deliveries`, {
+      limit: opts.limit,
+      before_id: opts.beforeId
+    });
+  }
 };
 
 // src/server.ts
-var VERSION = "0.23.1";
+var VERSION = "0.25.0";
 var DEMO_KEY = "be2b8487fcfacb1fbc292a8aa925a84c";
 var apiKey = process.env.PROPLINE_API_KEY;
 var baseUrl = process.env.PROPLINE_BASE_URL;
@@ -252,6 +267,7 @@ function filterByMinEv(res, minEvPct) {
 var tools = [
   {
     name: "propline_list_sports",
+    title: "List sports",
     description: "List all sports PropLine currently polls. Returns sport keys (e.g. baseball_mlb, basketball_nba, soccer_epl) along with human titles and active status. Use this first to discover what sport_key values are valid for the other tools.",
     inputSchema: {
       type: "object",
@@ -262,6 +278,7 @@ var tools = [
   },
   {
     name: "propline_list_events",
+    title: "List events",
     description: "List upcoming events for a sport. Returns each event's id, home_team, away_team, commence_time. Use the returned event_id to drill into per-event odds, props, +EV, or results.",
     inputSchema: {
       type: "object",
@@ -284,6 +301,7 @@ var tools = [
   },
   {
     name: "propline_list_event_markets",
+    title: "List event markets",
     description: "List the market types available for a specific event (e.g. h2h, spreads, totals, player_points, pitcher_strikeouts). Useful when you don't know which prop markets a given event carries.",
     inputSchema: {
       type: "object",
@@ -301,6 +319,7 @@ var tools = [
   },
   {
     name: "propline_get_odds",
+    title: "Get odds",
     description: "Get live odds. If event_id is supplied, returns full per-event props for that event; otherwise returns bulk game-line odds for the whole sport. Pass markets as a comma-separated list (e.g. 'h2h,spreads,totals' or 'player_points,player_rebounds'). Response includes a bookmakers[] array across every book that carries the requested markets (currently up to 13: Bovada, DraftKings, FanDuel, Pinnacle, BetMGM, BetRivers, Unibet, Underdog, PrizePicks, Kalshi, Polymarket, Matchbook, Smarkets \u2014 coverage varies by sport). Underdog Fantasy outcomes carry a payout_multiplier on EVERY outcome (1.0 = standard pick, e.g. 1.5 = boost, 0.75 = discount; null means the book is not Underdog) \u2014 keep only payout_multiplier == 1.0 when comparing DFS lines to sportsbook consensus, since filtering on non-null would drop every Underdog line. Each market carries suspended_at: null while on the board, set when that book pulled the market pregame (late scratch, dropped market type) \u2014 its outcomes are then the last quoted legs, not a live price. Treat a suspended market as unbettable and, if several books show it for one player, as a probable scratch.",
     inputSchema: {
       type: "object",
@@ -345,6 +364,7 @@ var tools = [
   },
   {
     name: "propline_get_odds_history",
+    title: "Get odds history",
     description: "Hobby+ endpoint. Returns the historical line-movement snapshot series for an event (every recorded price/point change per outcome over the event's lifetime). Free tier returns market structure with redacted snapshots and an upgrade pointer. Supports period-historical filters: from/to (absolute ISO), relative_from/relative_to (offsets to commence_time like '-3h' or '0'), interval downsample ('30s'/'1m'/'5m'/'15m'/'30m'/'1h'), and changes_only=true to drop unchanged adjacent snapshots.",
     inputSchema: {
       type: "object",
@@ -407,6 +427,7 @@ var tools = [
   },
   {
     name: "propline_get_odds_closing",
+    title: "Get opening & closing lines",
     description: "Hobby+ endpoint. Returns the OPENING and CLOSING line per (book, market, outcome) for an event. Closing = the last snapshot at or before commence_time (price/point/closing_at); opening = the first snapshot in the same 14-day pre-kickoff window (opening_price/opening_point/opening_at). Canonical CLV-tracking helper; one call returns both data points your bet should be measured against, instead of fetching full history and post-processing. Compare the POINTS as well as the prices \u2014 on spreads and totals the number moves as much as the price, so a price-only comparison mis-measures those markets. opening_age_seconds says how long before kickoff the opener was recorded: the archive starts 2026-04, so a small value means PropLine started polling late and this is not the book's true open. Free tier returns redacted structure with upgrade pointer.",
     inputSchema: {
       type: "object",
@@ -438,6 +459,7 @@ var tools = [
   },
   {
     name: "propline_export_odds_history",
+    title: "Export odds history",
     description: "Backfill-pass / Enterprise only. Bulk line-movement tick history as CSV \u2014 every recorded odds snapshot (price + line, per book, including period markets) across a whole sport, one row per (outcome, snapshot). This is the raw firehose no subscription tier can bulk-pull (Pro/Streaming use propline_get_odds_history per event instead). REQUIRES a since/until window to keep the pull bounded \u2014 the full archive runs to gigabytes per sport. The result is capped to the first 200 rows for context safety; for the full dataset use the /v1/exports/odds-history endpoint directly with curl/SDK and stream to disk. Non-entitled keys get a 403 with an upgrade pointer.",
     inputSchema: {
       type: "object",
@@ -476,6 +498,7 @@ var tools = [
   },
   {
     name: "propline_get_futures",
+    title: "Get futures",
     description: "Free-tier endpoint. Returns season-long futures (outright) markets for a sport \u2014 championship/Super Bowl/division/conference winners, MVP and award winners, season win totals \u2014 aggregated across Bovada, FanDuel, DraftKings, and Pinnacle. One row per (futures event, book, market) with each team/player outcome and its price. Marquee markets (Super Bowl winner, MVP, division/conference) are quoted by multiple books for comparison; exotic markets are often single-book. Useful for: 'who are the Super Bowl favorites across books', 'NFL MVP odds', 'NBA championship futures'. Futures are unresolved (no settlement grade).",
     inputSchema: {
       type: "object",
@@ -492,6 +515,7 @@ var tools = [
   },
   {
     name: "propline_get_scores",
+    title: "Get scores",
     description: "Free-tier endpoint. Returns recent and live game scores plus status (scheduled, live, final) for a sport. Useful for: 'is this game over yet, what was the final score'.",
     inputSchema: {
       type: "object",
@@ -511,6 +535,7 @@ var tools = [
   },
   {
     name: "propline_get_dfs_payouts",
+    title: "Get DFS payouts",
     description: "Free-tier reference math. Returns the PrizePicks Power Play (all legs must hit) and Flex Play (partial payouts) entry payout schedule for 2-6 legs, plus the per-leg breakeven win probability for each play. Pass leg_win_prob (e.g. 0.58) to also get expected_return (per $1) and is_plus_ev per play \u2014 the slip-level breakeven. Useful for: 'what hit rate do I need to beat a 4-pick PrizePicks Power play', 'is a 3-leg flex +EV at 60% per leg'. NOTE: standard published payouts only \u2014 demon/goblin per-pick modifiers aren't in PrizePicks's feed (see the disclaimer field); breakeven assumes independent legs.",
     inputSchema: {
       type: "object",
@@ -529,6 +554,7 @@ var tools = [
   },
   {
     name: "propline_get_mlb_grand_salami",
+    title: "Get MLB Grand Salami",
     description: "Free-tier endpoint. Returns the synthetic daily MLB Grand Salami for a given UTC date \u2014 total runs scored across every MLB game on the slate plus each book's implied Grand Salami line (median of per-game primary totals across our MLB books incl. Pinnacle, Polymarket, Matchbook, Smarkets). No retail sportsbook quotes this as a single market. Useful for: 'what's the total run line for tonight's full MLB slate', 'did the Grand Salami go over yesterday', 'historical Grand Salami results for backtesting'.",
     inputSchema: {
       type: "object",
@@ -547,6 +573,7 @@ var tools = [
   },
   {
     name: "propline_get_nhl_daily_goals_total",
+    title: "Get NHL daily goals total",
     description: "Free-tier endpoint. Returns the synthetic daily NHL goals total (hockey's equivalent of the MLB Grand Salami) for a given UTC date \u2014 total goals scored across every NHL game on the slate (including OT/SO) plus each book's implied Daily Goals Total line (median of per-game primary totals across our NHL books). No retail sportsbook quotes this as a single market. Useful for: 'what's the total goal line for tonight's full NHL slate', 'did the Daily Goals Total go over yesterday', 'historical NHL daily-goals results for backtesting'.",
     inputSchema: {
       type: "object",
@@ -565,6 +592,7 @@ var tools = [
   },
   {
     name: "propline_get_resolution_summary",
+    title: "Get resolution summary",
     description: "Free-tier endpoint. Returns the factual volume of player props PropLine has graded against real box scores over the last N days (aggregated counts only): total graded/settled, games, sports covered, plus per-sport and top-market breakdowns. Useful for: 'how much graded prop data does PropLine have, what's the coverage'. A coverage proof, never a profitability claim.",
     inputSchema: {
       type: "object",
@@ -581,6 +609,7 @@ var tools = [
   },
   {
     name: "propline_get_event_stats",
+    title: "Get event stats",
     description: "Book-agnostic raw box-score stats for an event. Returns per-player stats (e.g. strikeouts, hits, points, rebounds, shots-on-goal) decoupled from any sportsbook's lines. LIVE during games for major US sports (MLB + WNBA now; NFL, NCAAF, NBA, NHL at season start): while the event's status is in_progress, stats refresh ~every 90 seconds with cumulative in-game values \u2014 use this to answer 'how is this prop tracking right now'. Treat in-progress numbers as partial; at status=final they are the official box score. Other sports populate stats at game completion. Free tier.",
     inputSchema: {
       type: "object",
@@ -598,6 +627,7 @@ var tools = [
   },
   {
     name: "propline_get_event_results",
+    title: "Get graded prop results",
     description: "Pro-tier endpoint. Returns graded prop outcomes for a completed event \u2014 every Over/Under marked won, lost, push, or void with the actual stat value next to the line. The single most distinctive feature vs the-odds-api: they don't grade props at any tier. Free tier returns the same structure with resolution and actual_value redacted plus an upgrade pointer.",
     inputSchema: {
       type: "object",
@@ -615,6 +645,7 @@ var tools = [
   },
   {
     name: "propline_get_event_context",
+    title: "Get event context",
     description: "Game context for an event \u2014 the conditions a prop settles under. MLB: probable starting pitchers and their throwing hand (L/R/S \u2014 platoon-split context for every batter prop), a confirmed-lineup flag, the home-plate umpire, and first-pitch weather (temperature, wind, precipitation) at outdoor / open-roof venues (indoor venues return weather=null). NFL & NCAAF: the venue and kickoff weather. The same block is embedded in get_event_results, so every graded prop carries its conditions \u2014 unique to PropLine. Free tier. 404 when no context is on file for the event yet.",
     inputSchema: {
       type: "object",
@@ -632,6 +663,7 @@ var tools = [
   },
   {
     name: "propline_get_event_movement",
+    title: "Get line movement & steam",
     description: "Line movement + steam detection from the snapshot tick history. Per (book, market, outcome): opening line, latest line, signed implied-probability shift, point shift, direction. The steam[] array flags outcomes that multiple books moved the same direction \u2014 the classic sharp-money signal, computed across all 16 books PropLine polls. When a book moves the line itself, that outcome's prob_shift is null and direction is 'line_moved' (excluded from the steam signal). No pull-only odds API can produce this. Hobby+ full; free tier redacted.",
     inputSchema: {
       type: "object",
@@ -666,6 +698,7 @@ var tools = [
   },
   {
     name: "propline_get_player_history",
+    title: "Get player prop history",
     description: "Player prop history across recent games. Returns each prior prop this player took with line, prices, resolution, and actual value. Pro tier returns full data; free tier returns redacted resolution/actual_value with an upgrade pointer.",
     inputSchema: {
       type: "object",
@@ -698,6 +731,7 @@ var tools = [
   },
   {
     name: "propline_get_player_trends",
+    title: "Get player trends",
     description: "Hit-rate trends / last-N-games over rate for a player \u2014 unique to PropLine's prop-resolution data. For each market the player has graded history in, returns over/under/push splits across the last 5/10/20/50 graded games, current streak, average actual stat, and the recent line. This is the 'did X go over in N of his last M games?' surface. Omit `market` for all markets, or pass one to scope (e.g. 'player_points', 'batter_hits').",
     inputSchema: {
       type: "object",
@@ -731,6 +765,7 @@ var tools = [
   },
   {
     name: "propline_get_event_ev",
+    title: "Get cross-book +EV",
     description: "Pro-tier endpoint. Returns cross-book +EV per outcome for an event. We anchor on a sharp book, remove vig, derive a no-vig fair line, and compute EV% per book at the same line. Outcomes are sorted with +EV plays floated to the top of each line group. PrizePicks is excluded from EV math (DFS payouts aren't comparable to per-book prices). The anchor is chosen PER LINE in the order pinnacle \u2192 polymarket \u2192 kalshi \u2192 bovada, and each line's fair_source names the one used \u2014 report the anchor from fair_source per line, never assume Pinnacle anchored all of them. Optional bookmakers filter prices to the books the user holds accounts at; it never changes the anchor, so filtering to DraftKings still measures DraftKings against Pinnacle.",
     inputSchema: {
       type: "object",
@@ -764,6 +799,7 @@ var tools = [
   },
   {
     name: "propline_get_best_line",
+    title: "Get best line",
     description: "Cross-book line shopping (Hobby+ for prices; free tier gets the full structure with book identities + best-first ranking but prices nulled and redacted:true). For every (market, player, line) tuple on an event, returns the single best American price across all comparable books, plus an all_prices array sorted best-first (one row per book, each with last_update). Companion to propline_get_event_ev: /ev says whether a price beats the no-vig fair line; best-line says which book pays the most. DFS pick'em books (PrizePicks, Sleeper, Dabble) are excluded; Underdog only at clean two-way lines. Optional bookmakers filter to shop only the books the user holds accounts at.",
     inputSchema: {
       type: "object",
@@ -795,6 +831,48 @@ var tools = [
         includeLinks: args.include_links
       }
     )
+  },
+  // -- Webhooks: READ-ONLY on purpose. Create returns the HMAC secret exactly
+  // once (a credential in a model context); update/delete/test are
+  // side-effectful. The read pair is the self-service debugging surface.
+  {
+    name: "propline_list_webhooks",
+    title: "List webhooks",
+    description: "List the API key's webhook subscriptions (Streaming Lite tier and up; other tiers get a 403 with an upgrade URL). Read-only: signing secrets are always masked, and this server deliberately has no create/update/delete tools \u2014 manage subscriptions via the REST API or SDKs. Each row shows url, subscribed events (line_movement, resolution, steam, market_suspended), filters and active status. Use this first to find the webhook id for propline_get_webhook_deliveries.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    handler: () => client().listWebhooks()
+  },
+  {
+    name: "propline_get_webhook_deliveries",
+    title: "Get webhook deliveries",
+    description: "Recent delivery attempts for one webhook (Streaming Lite tier and up), newest first \u2014 the debugging surface for 'why isn't my webhook firing'. Each row: status (pending/success/failed), HTTP response_code, attempts, delivered_at and the payload that was sent. A pending row with attempts > 0 is mid-retry-backoff; status 'failed' with response_code null means the endpoint was unreachable or timed out (8s). Page backwards through a deep queue with before_id = the smallest id on the previous page; a page shorter than limit is the last one.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        webhook_id: {
+          type: "number",
+          description: "Webhook id (from propline_list_webhooks)."
+        },
+        limit: {
+          type: "number",
+          description: "Rows per page, 1-200. Default 50."
+        },
+        before_id: {
+          type: "number",
+          description: "Cursor: smallest delivery id from the previous page."
+        }
+      },
+      required: ["webhook_id"],
+      additionalProperties: false
+    },
+    handler: (args) => client().listWebhookDeliveries(args.webhook_id, {
+      limit: args.limit,
+      beforeId: args.before_id
+    })
   }
 ];
 function createServer() {
@@ -805,8 +883,19 @@ function createServer() {
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: tools.map((t) => ({
       name: t.name,
+      title: t.title,
       description: t.description,
-      inputSchema: t.inputSchema
+      inputSchema: t.inputSchema,
+      // Every PropLine tool is a READ of the odds API — none creates,
+      // changes or deletes anything. Directories (Claude connectors, Cursor)
+      // require these hints; clients use them to skip confirmation prompts.
+      annotations: {
+        title: t.title,
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+      }
     }))
   }));
   server.setRequestHandler(CallToolRequestSchema, async (req) => {