propline-mcp 0.51.0 → 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 +6 -1
- package/dist/http.js +169 -1
- package/dist/http.js.map +1 -1
- package/dist/index.js +169 -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) |
|
|
@@ -45,6 +48,8 @@ The model uses these tools transparently:
|
|
|
45
48
|
| `propline_get_golf_tournaments` | Golf tournaments with round data, by tour and season (free) |
|
|
46
49
|
| `propline_get_injuries` | Current injury report for NFL, NCAAF, NBA, WNBA, NHL, MLB (free) |
|
|
47
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) |
|
|
48
53
|
| `propline_get_event_stats` | Raw box-score stats (free, book-agnostic) |
|
|
49
54
|
| `propline_get_event_context` | Game conditions a prop settles under — probable pitchers, lineup flag, home-plate umpire, first-pitch weather (free) |
|
|
50
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. |
|
|
@@ -62,7 +67,7 @@ The model uses these tools transparently:
|
|
|
62
67
|
|
|
63
68
|
## Hosted endpoint (no install)
|
|
64
69
|
|
|
65
|
-
The same
|
|
70
|
+
The same 41 tools are served over **Streamable HTTP** at
|
|
66
71
|
|
|
67
72
|
```
|
|
68
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,
|
|
@@ -273,6 +284,19 @@ var PropLineClient = class {
|
|
|
273
284
|
player: opts.player
|
|
274
285
|
});
|
|
275
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
|
+
}
|
|
276
300
|
getFutures(sportKey) {
|
|
277
301
|
return this.request(`/v1/sports/${sportKey}/futures`);
|
|
278
302
|
}
|
|
@@ -379,7 +403,7 @@ var PropLineClient = class {
|
|
|
379
403
|
};
|
|
380
404
|
|
|
381
405
|
// src/server.ts
|
|
382
|
-
var VERSION = "0.
|
|
406
|
+
var VERSION = "0.54.1";
|
|
383
407
|
var DEMO_KEY = "be2b8487fcfacb1fbc292a8aa925a84c";
|
|
384
408
|
var apiKey = process.env.PROPLINE_API_KEY;
|
|
385
409
|
var baseUrl = process.env.PROPLINE_BASE_URL;
|
|
@@ -693,6 +717,86 @@ var tools = [
|
|
|
693
717
|
},
|
|
694
718
|
handler: (args) => client().gradeClv(args.bets, args.devig)
|
|
695
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
|
+
},
|
|
696
800
|
{
|
|
697
801
|
name: "propline_price_sgp",
|
|
698
802
|
title: "Price a same-game parlay at the book's own odds",
|
|
@@ -903,6 +1007,27 @@ var tools = [
|
|
|
903
1007
|
},
|
|
904
1008
|
handler: (args) => client().getEventIds(args.sport_key)
|
|
905
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
|
+
},
|
|
906
1031
|
{
|
|
907
1032
|
name: "propline_get_book_accuracy",
|
|
908
1033
|
title: "Get sportsbook accuracy report",
|
|
@@ -1015,6 +1140,49 @@ var tools = [
|
|
|
1015
1140
|
player: args.player
|
|
1016
1141
|
})
|
|
1017
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
|
+
},
|
|
1018
1186
|
{
|
|
1019
1187
|
name: "propline_get_event_stats",
|
|
1020
1188
|
title: "Get event stats",
|