propline-mcp 0.33.0 → 0.35.0

package/README.md

@@ -31,6 +31,7 @@ The model uses these tools transparently:
 | `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 today). 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) |
@@ -53,7 +54,7 @@ The model uses these tools transparently:
 
 ## Hosted endpoint (no install)
 
-The same 25 tools are served over **Streamable HTTP** at
+The same 27 tools are served over **Streamable HTTP** at
 
 ```
 https://mcp.prop-line.com/mcp
@@ -118,7 +119,7 @@ Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) o
 }
 ```
 
-Restart Claude Desktop. The hammer icon should show 25 PropLine tools. (Or skip the install and add `https://mcp.prop-line.com/mcp` as a custom connector — see the hosted endpoint above.)
+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
 

package/dist/http.js

@@ -162,6 +162,16 @@ var PropLineClient = class {
   gradeClv(bets) {
     return this.postRequest("/v1/clv/grade", bets);
   }
+  /**
+   * Price a same-game parlay at the book's own correlated odds (FanDuel
+   * today). Hobby+. See the propline_price_sgp tool description.
+   */
+  priceSgp(sportKey, eventId, legs, bookmaker = "fanduel") {
+    return this.postRequest(
+      `/v1/sports/${encodeURIComponent(sportKey)}/events/${encodeURIComponent(String(eventId))}/sgp`,
+      { bookmaker, legs }
+    );
+  }
   // ----- Bulk exports -----
   /**
    * Full line-movement tick history as CSV text (Backfill pass / Enterprise
@@ -280,10 +290,16 @@ var PropLineClient = class {
       before_id: opts.beforeId
     });
   }
+  replayWebhookEvents(webhookId, opts = {}) {
+    return this.request(`/v1/webhooks/${webhookId}/replay`, {
+      since_seq: opts.sinceSeq,
+      limit: opts.limit
+    });
+  }
 };
 
 // src/server.ts
-var VERSION = "0.33.0";
+var VERSION = "0.35.0";
 var DEMO_KEY = "be2b8487fcfacb1fbc292a8aa925a84c";
 var apiKey = process.env.PROPLINE_API_KEY;
 var baseUrl = process.env.PROPLINE_BASE_URL;
@@ -578,6 +594,48 @@ var tools = [
     },
     handler: (args) => client().gradeClv(args.bets)
   },
+  {
+    name: "propline_price_sgp",
+    title: "Price a same-game parlay at the book's own odds",
+    description: "Hobby+ endpoint. Prices a same-game parlay at the BOOK'S OWN correlated odds \u2014 the price a FanDuel customer would be offered for that exact slip right now, not a model of it. FanDuel is the only book today (bookmaker defaults to fanduel). Send 2-10 legs from ONE event, each named exactly as propline_get_odds names an outcome: market key, name (team / Over / Under / player for YES-only props), description (the player on a two-way prop, '' for game lines), point (omit for h2h and YES-only props) and period (omit for full game) \u2014 or book_outcome_id from includeBookIds. The response carries sgp_price (the book's parlay price), independent_price (the product of the live single-leg prices) and correlation_factor = their ratio: below 1 the book is charging for correlation, above 1 it is paying for anti-correlation \u2014 say which when presenting it. Matching is fail-closed: a leg that does not pin to exactly one stored outcome is a 422 leg_unmatched naming the leg (an Over with no point on an event with two total lines is refused, not guessed) \u2014 fix the leg, do not retry blindly. quoted=false means the book will not offer that combination as an SGP; refused legs carry the book's own failure_code. Free tier returns the matched legs with every price nulled.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        sport_key: { type: "string", description: "e.g. baseball_mlb" },
+        event_id: { type: ["string", "number"] },
+        bookmaker: {
+          type: "string",
+          description: "Book to price at. Only fanduel today."
+        },
+        legs: {
+          type: "array",
+          minItems: 2,
+          maxItems: 10,
+          description: "Legs named exactly as /odds names an outcome.",
+          items: {
+            type: "object",
+            properties: {
+              market: { type: "string" },
+              name: { type: "string" },
+              description: { type: "string" },
+              point: { type: ["number", "null"] },
+              period: { type: ["string", "null"] },
+              book_outcome_id: { type: ["string", "null"] }
+            },
+            additionalProperties: false
+          }
+        }
+      },
+      required: ["sport_key", "event_id", "legs"],
+      additionalProperties: false
+    },
+    handler: (args) => client().priceSgp(
+      args.sport_key,
+      args.event_id,
+      args.legs,
+      args.bookmaker ?? "fanduel"
+    )
+  },
   {
     name: "propline_export_odds_history",
     title: "Export odds history",
@@ -1055,6 +1113,34 @@ var tools = [
       limit: args.limit,
       beforeId: args.before_id
     })
+  },
+  {
+    name: "propline_replay_webhook_events",
+    title: "Replay missed webhook events",
+    description: "Re-read a webhook subscription's events in order from a cursor \u2014 answers 'my endpoint was down, what did I miss?'. Every delivery carries an X-PropLine-Sequence header, a counter monotonic WITHIN one subscription; pass the highest one the user processed as since_seq. Do NOT use the delivery id as the cursor: that id is global across all subscriptions, so gaps in it are other customers' traffic and mean nothing. Events come back OLDEST FIRST (the opposite of propline_get_webhook_deliveries, which is a newest-first debugging log). Page by passing next_seq back as since_seq while has_more is true. ALWAYS check `truncated`: true means events after the cursor already aged out of retention (2 days, max 5,000 deliveries per subscription) and are unrecoverable \u2014 tell the user to resync from the REST endpoints rather than reporting them caught up. latest_seq is not subject to retention, so latest_seq - next_seq is an honest 'how far behind' even when the rows are gone. Sequence numbers always increase and never repeat but are NOT guaranteed to be dense \u2014 a skipped number is normal and is not evidence of loss.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        webhook_id: {
+          type: "number",
+          description: "Webhook id (from propline_list_webhooks)."
+        },
+        since_seq: {
+          type: "number",
+          description: "Read events after this sequence. Default 0 = from the oldest retained event (which on an established subscription will correctly report truncated: true)."
+        },
+        limit: {
+          type: "number",
+          description: "Events per page, 1-500. Default 100."
+        }
+      },
+      required: ["webhook_id"],
+      additionalProperties: false
+    },
+    handler: (args) => client().replayWebhookEvents(args.webhook_id, {
+      sinceSeq: args.since_seq,
+      limit: args.limit
+    })
   }
 ];
 function withDemoNote(text) {