propline-mcp 0.50.1 → 0.54.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -31,6 +31,9 @@ The model uses these tools transparently:
31
31
  | `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) |
32
32
  | `propline_get_odds_closing` | Hobby+: opening **and** closing line per (book, market, outcome) — CLV helper. Accepts `period` to scope to a specific game period. |
33
33
  | `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. |
34
+ | `propline_settle_bets` | Hobby+: settle **placed** bets, singles or parlays: won / lost / push / void / half_won / half_lost, with the stat each settled on, payout and profit. Works at books and lines PropLine never stored (`source: computed`); quarter lines settle as two half-stakes; `pending` until graded. |
35
+ | `propline_price_parlay` | Hobby+: fair price of a parlay across games from the no-vig lines, each leg's best price, every book's product price, EV% of an offered price. Same-game legs flagged. |
36
+ | `propline_lookup_event_ids` | Free: find PropLine's event (with result) from a sportsbook's own event id, an ESPN id or an MLB gamePk. |
34
37
  | `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. |
35
38
  | `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). |
36
39
  | `propline_get_futures` | Season-long futures — championship/division/conference winners, MVP + awards, season win totals — across Bovada/FanDuel/DraftKings/Pinnacle/Kalshi (free) |
@@ -43,6 +46,10 @@ The model uses these tools transparently:
43
46
  | `propline_get_book_accuracy` | Sportsbook accuracy report — how well each book prices props, vs the market (free) |
44
47
  | `propline_get_golf_rounds` | A golfer's completed rounds by tour (PGA, DP World, LIV, LPGA, Korn Ferry, Champions) with L5/L10/L20 (free) |
45
48
  | `propline_get_golf_tournaments` | Golf tournaments with round data, by tour and season (free) |
49
+ | `propline_get_injuries` | Current injury report for NFL, NCAAF, NBA, WNBA, NHL, MLB (free) |
50
+ | `propline_get_injury_history` | Injury status changes over the last 1-90 days (free) |
51
+ | `propline_get_referees` | Referee card stats — cards per match, last and next match (EPL, free) |
52
+ | `propline_get_referee_matches` | One referee's matches with each team's cards (EPL, free) |
46
53
  | `propline_get_event_stats` | Raw box-score stats (free, book-agnostic) |
47
54
  | `propline_get_event_context` | Game conditions a prop settles under — probable pitchers, lineup flag, home-plate umpire, first-pitch weather (free) |
48
55
  | `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. |
@@ -60,7 +67,7 @@ The model uses these tools transparently:
60
67
 
61
68
  ## Hosted endpoint (no install)
62
69
 
63
- The same 32 tools are served over **Streamable HTTP** at
70
+ The same 41 tools are served over **Streamable HTTP** at
64
71
 
65
72
  ```
66
73
  https://mcp.prop-line.com/mcp
package/dist/http.js CHANGED
@@ -170,6 +170,14 @@ var PropLineClient = class {
170
170
  const qs = devig ? `?devig=${encodeURIComponent(devig)}` : "";
171
171
  return this.postRequest(`/v1/clv/grade${qs}`, bets);
172
172
  }
173
+ /** Settle placed bets (singles or parlays). Hobby+. */
174
+ settleBets(bets) {
175
+ return this.postRequest(`/v1/bets/settle`, bets);
176
+ }
177
+ /** Fair price of a parlay across games. Hobby+. */
178
+ priceParlay(body) {
179
+ return this.postRequest(`/v1/parlay/price`, body);
180
+ }
173
181
  /**
174
182
  * Price a same-game parlay at the book's own correlated odds (FanDuel
175
183
  * today). Hobby+. See the propline_price_sgp tool description.
@@ -241,6 +249,9 @@ var PropLineClient = class {
241
249
  getEventIds(sportKey) {
242
250
  return this.request(`/v1/sports/${sportKey}/ids`);
243
251
  }
252
+ lookupEventIds(opts) {
253
+ return this.request(`/v1/ids/lookup`, opts);
254
+ }
244
255
  getBookAccuracy(opts = {}) {
245
256
  return this.request(`/v1/books/accuracy`, {
246
257
  days: opts.days,
@@ -261,6 +272,31 @@ var PropLineClient = class {
261
272
  limit: opts.limit
262
273
  });
263
274
  }
275
+ getInjuries(sportKey, opts = {}) {
276
+ return this.request(`/v1/sports/${encodeURIComponent(sportKey)}/injuries`, {
277
+ team: opts.team,
278
+ status: opts.status
279
+ });
280
+ }
281
+ getInjuryHistory(sportKey, opts = {}) {
282
+ return this.request(`/v1/sports/${encodeURIComponent(sportKey)}/injuries/history`, {
283
+ days: opts.days,
284
+ player: opts.player
285
+ });
286
+ }
287
+ getReferees(sportKey, opts = {}) {
288
+ return this.request(`/v1/sports/${encodeURIComponent(sportKey)}/referees`, {
289
+ search: opts.search,
290
+ since: opts.since,
291
+ until: opts.until
292
+ });
293
+ }
294
+ getRefereeMatches(sportKey, name, opts = {}) {
295
+ return this.request(
296
+ `/v1/sports/${encodeURIComponent(sportKey)}/referees/${encodeURIComponent(name)}/matches`,
297
+ { since: opts.since, until: opts.until, limit: opts.limit }
298
+ );
299
+ }
264
300
  getFutures(sportKey) {
265
301
  return this.request(`/v1/sports/${sportKey}/futures`);
266
302
  }
@@ -367,7 +403,7 @@ var PropLineClient = class {
367
403
  };
368
404
 
369
405
  // src/server.ts
370
- var VERSION = "0.50.1";
406
+ var VERSION = "0.54.1";
371
407
  var DEMO_KEY = "be2b8487fcfacb1fbc292a8aa925a84c";
372
408
  var apiKey = process.env.PROPLINE_API_KEY;
373
409
  var baseUrl = process.env.PROPLINE_BASE_URL;
@@ -681,6 +717,86 @@ var tools = [
681
717
  },
682
718
  handler: (args) => client().gradeClv(args.bets, args.devig)
683
719
  },
720
+ {
721
+ name: "propline_settle_bets",
722
+ title: "Settle placed bets (won / lost / push / void)",
723
+ description: "Hobby+ endpoint. Settles PLACED bets, singles or parlays, against final results: each comes back won, lost, push, void, half_won or half_lost, with actual_value (the stat or score it settled on), payout (stake included) and profit, plus a summary. The book and the line are free: a bet at a book PropLine does not carry, or at a line nobody posted, is graded by running PropLine's grader at that line (source='computed'); a named bookmaker whose outcome was stored at that exact line uses its own grade (source='stored'). Asian quarter lines (2.75, -0.25) settle as two half-stakes. result 'pending' means the game is not graded yet \u2014 say so, do not guess. 'unmatched' carries a reason (event_not_found, no_market_for_key, no_outcome_for_selection, ambiguous_selection, cannot_compute_at_line, invalid_bet): surface those rows. For a parlay pass legs (each with its own price); any lost leg loses it and pushed/voided legs drop out. Use propline_list_events or propline_get_scores to find event_id. Max 200 bets. Stateless. Free tier returns results as 'redacted'.",
724
+ inputSchema: {
725
+ type: "object",
726
+ properties: {
727
+ bets: {
728
+ type: "array",
729
+ maxItems: 200,
730
+ description: "Bets to settle. A single bet uses the leg fields directly; a parlay sets legs.",
731
+ items: {
732
+ type: "object",
733
+ properties: {
734
+ ref: { type: "string", description: "Echoed back." },
735
+ stake: { type: "number", description: "Defaults to 1." },
736
+ sport_key: { type: "string" },
737
+ event_id: { type: ["string", "number"] },
738
+ market: { type: "string" },
739
+ selection: {
740
+ type: "string",
741
+ description: "Player for a prop, team for a game line, 'Over'/'Under' for a game total."
742
+ },
743
+ side: { type: "string", description: "Over/Under/Yes/No for two-way markets." },
744
+ point: { type: "number", description: "The bettor's line." },
745
+ period: { type: "string", description: "Canonical period code (q1, h1, f5). Omit for full game." },
746
+ team: { type: "string", description: "Scope a totals bet to one team's total." },
747
+ bookmaker: { type: "string", description: "Optional book the bet was placed at." },
748
+ price: { type: "number", description: "American odds taken. Needed for payout." },
749
+ legs: {
750
+ type: "array",
751
+ maxItems: 20,
752
+ description: "Parlay legs; each has the single-bet fields above.",
753
+ items: { type: "object" }
754
+ }
755
+ },
756
+ additionalProperties: false
757
+ }
758
+ }
759
+ },
760
+ required: ["bets"],
761
+ additionalProperties: false
762
+ },
763
+ handler: (args) => client().settleBets(args.bets)
764
+ },
765
+ {
766
+ name: "propline_price_parlay",
767
+ title: "Price a parlay across games",
768
+ description: "Hobby+ endpoint. Fair price of a parlay across games (2-15 legs), from the same no-vig fair lines as propline_get_event_ev. Returns fair_price for the parlay, each leg's fair_price and best price + book, best_legs_price, books (every book that prices all the legs: the product of its leg prices, with ev_pct), and offered_ev_pct when price is given. The fair price ASSUMES INDEPENDENT LEGS: legs on the same event are flagged same_game \u2014 say so, and use propline_price_sgp for same-game parlays. A leg that matches no fair line returns a reason and the parlay is not priced. Never present the EV as a profit guarantee.",
769
+ inputSchema: {
770
+ type: "object",
771
+ properties: {
772
+ legs: {
773
+ type: "array",
774
+ minItems: 2,
775
+ maxItems: 15,
776
+ items: {
777
+ type: "object",
778
+ properties: {
779
+ sport_key: { type: "string" },
780
+ event_id: { type: ["string", "number"] },
781
+ market: { type: "string" },
782
+ selection: { type: "string", description: "Team, player, or Over/Under for a game total." },
783
+ side: { type: "string" },
784
+ point: { type: "number" },
785
+ team: { type: "string", description: "For a team total." },
786
+ price: { type: "number", description: "Offered price for this leg." }
787
+ },
788
+ required: ["sport_key", "event_id", "market", "selection"],
789
+ additionalProperties: false
790
+ }
791
+ },
792
+ price: { type: "number", description: "Parlay price offered (American)." },
793
+ devig: { type: "string", enum: ["multiplicative", "shin"] }
794
+ },
795
+ required: ["legs"],
796
+ additionalProperties: false
797
+ },
798
+ handler: (args) => client().priceParlay({ legs: args.legs, price: args.price, devig: args.devig })
799
+ },
684
800
  {
685
801
  name: "propline_price_sgp",
686
802
  title: "Price a same-game parlay at the book's own odds",
@@ -891,6 +1007,27 @@ var tools = [
891
1007
  },
892
1008
  handler: (args) => client().getEventIds(args.sport_key)
893
1009
  },
1010
+ {
1011
+ name: "propline_lookup_event_ids",
1012
+ title: "Find an event by a book, ESPN or MLB id",
1013
+ description: "Free-tier endpoint. Reverse id lookup: give a sportsbook's own event id (book + book_event_id, e.g. book='pinnacle'), an ESPN event id or an MLB gamePk and get PropLine's event back with its full id crosswalk, status, completed flag and final score. Any date. Up to 50 comma-separated ids; misses come back in not_found. Useful for: 'what was the result of Pinnacle event 1612345678', 'which PropLine event is this ESPN game'.",
1014
+ inputSchema: {
1015
+ type: "object",
1016
+ properties: {
1017
+ book: { type: "string", description: "Book key, e.g. pinnacle, draftkings, kalshi." },
1018
+ book_event_id: { type: "string", description: "That book's event id(s), comma-separated." },
1019
+ espn_event_id: { type: "string" },
1020
+ mlb_game_pk: { type: "string" }
1021
+ },
1022
+ additionalProperties: false
1023
+ },
1024
+ handler: (args) => client().lookupEventIds({
1025
+ book: args.book,
1026
+ book_event_id: args.book_event_id,
1027
+ espn_event_id: args.espn_event_id,
1028
+ mlb_game_pk: args.mlb_game_pk
1029
+ })
1030
+ },
894
1031
  {
895
1032
  name: "propline_get_book_accuracy",
896
1033
  title: "Get sportsbook accuracy report",
@@ -962,6 +1099,90 @@ var tools = [
962
1099
  limit: args.limit
963
1100
  })
964
1101
  },
1102
+ {
1103
+ name: "propline_get_injuries",
1104
+ title: "Get a sport's injury report",
1105
+ description: "Free-tier endpoint. The current injury report for NFL, NCAAF, NBA, WNBA, NHL or MLB: each listed player with status (Out, Questionable, Day-To-Day, 15-Day-IL...), status_code, injury, expected return and status_since (when the current status began). Source: ESPN, every 10 minutes. Useful for: 'who is out for the Chiefs', 'which NBA players are questionable tonight' \u2014 check it before trusting a player prop.",
1106
+ inputSchema: {
1107
+ type: "object",
1108
+ properties: {
1109
+ sport_key: { type: "string", description: "football_nfl, football_ncaaf, basketball_nba, basketball_wnba, hockey_nhl or baseball_mlb." },
1110
+ team: { type: "string", description: "Optional team name or abbreviation, e.g. KC." },
1111
+ status: {
1112
+ type: "string",
1113
+ description: "Optional comma-separated status codes: out, doubtful, questionable, probable, day_to_day, injured_list, suspended, other."
1114
+ }
1115
+ },
1116
+ required: ["sport_key"],
1117
+ additionalProperties: false
1118
+ },
1119
+ handler: (args) => client().getInjuries(args.sport_key, {
1120
+ team: args.team,
1121
+ status: args.status
1122
+ })
1123
+ },
1124
+ {
1125
+ name: "propline_get_injury_history",
1126
+ title: "Get injury status changes",
1127
+ description: "Free-tier endpoint. Every injury status change in a sport over the last 1-90 days, newest first: old_status -> new_status with the time we saw it (new_status null = came off the report). History starts 2026-10-18. Pair with odds history to see how lines moved on a ruling.",
1128
+ inputSchema: {
1129
+ type: "object",
1130
+ properties: {
1131
+ sport_key: { type: "string", description: "football_nfl, football_ncaaf, basketball_nba, basketball_wnba, hockey_nhl or baseball_mlb." },
1132
+ days: { type: "number", description: "1-90. Defaults to 7." },
1133
+ player: { type: "string", description: "Optional player name (substring match)." }
1134
+ },
1135
+ required: ["sport_key"],
1136
+ additionalProperties: false
1137
+ },
1138
+ handler: (args) => client().getInjuryHistory(args.sport_key, {
1139
+ days: args.days,
1140
+ player: args.player
1141
+ })
1142
+ },
1143
+ {
1144
+ name: "propline_get_referees",
1145
+ title: "Get referee card stats",
1146
+ description: "Free-tier endpoint. Card stats per referee: graded matches, yellow and red cards, cards per match, last match and next appointment. Premier League (soccer_epl) only today. Useful for: 'which EPL referee gives the most cards', 'who is refereeing Arsenal next' \u2014 check it before a cards prop.",
1147
+ inputSchema: {
1148
+ type: "object",
1149
+ properties: {
1150
+ sport_key: { type: "string", description: "soccer_epl (the only sport supported today)." },
1151
+ search: { type: "string", description: "Optional referee name (substring match)." },
1152
+ since: { type: "string", description: "Optional start date, YYYY-MM-DD." },
1153
+ until: { type: "string", description: "Optional end date, YYYY-MM-DD." }
1154
+ },
1155
+ required: ["sport_key"],
1156
+ additionalProperties: false
1157
+ },
1158
+ handler: (args) => client().getReferees(args.sport_key, {
1159
+ search: args.search,
1160
+ since: args.since,
1161
+ until: args.until
1162
+ })
1163
+ },
1164
+ {
1165
+ name: "propline_get_referee_matches",
1166
+ title: "Get a referee's matches",
1167
+ description: "Free-tier endpoint. One referee's summary plus their matches, newest first, with each team's yellow and red cards (null until graded) and upcoming appointments. Premier League (soccer_epl) only today. Get exact names from propline_get_referees.",
1168
+ inputSchema: {
1169
+ type: "object",
1170
+ properties: {
1171
+ sport_key: { type: "string", description: "soccer_epl (the only sport supported today)." },
1172
+ name: { type: "string", description: "Referee name, e.g. Michael Oliver." },
1173
+ since: { type: "string", description: "Optional start date, YYYY-MM-DD." },
1174
+ until: { type: "string", description: "Optional end date, YYYY-MM-DD." },
1175
+ limit: { type: "number", description: "1-500. Defaults to 100." }
1176
+ },
1177
+ required: ["sport_key", "name"],
1178
+ additionalProperties: false
1179
+ },
1180
+ handler: (args) => client().getRefereeMatches(args.sport_key, args.name, {
1181
+ since: args.since,
1182
+ until: args.until,
1183
+ limit: args.limit
1184
+ })
1185
+ },
965
1186
  {
966
1187
  name: "propline_get_event_stats",
967
1188
  title: "Get event stats",