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 +8 -1
- package/dist/http.js +222 -1
- package/dist/http.js.map +1 -1
- package/dist/index.js +222 -1
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
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
|
|
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.
|
|
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",
|