propline-mcp 0.56.0 → 0.58.0
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 +5 -1
- package/dist/http.js +103 -1
- package/dist/http.js.map +1 -1
- package/dist/index.js +103 -1
- package/dist/index.js.map +1 -1
- package/package.json +4 -2
package/README.md
CHANGED
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/propline-mcp)
|
|
4
4
|
[](https://opensource.org/licenses/MIT)
|
|
5
|
+
[](https://mcp.market/server/proplineapi-propline-mcp)
|
|
5
6
|
|
|
6
7
|
Listed in the official [MCP Registry](https://registry.modelcontextprotocol.io) as `io.github.proplineapi/propline-mcp` — discoverable from Claude Code, Claude Desktop, and any MCP-aware client.
|
|
7
8
|
|
|
@@ -32,6 +33,8 @@ The model uses these tools transparently:
|
|
|
32
33
|
| `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
34
|
| `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
35
|
| `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. |
|
|
36
|
+
| `propline_track_bets` | Hobby+: register placed bets (singles or parlays) so PropLine holds them and settles each when its games grade. `ref` makes retries safe; unmatched bets are `rejected` with a reason. Streaming Lite+ also get a `bet_settled` webhook. Writes to your account. |
|
|
37
|
+
| `propline_list_tracked_bets` | Hobby+: tracked bets newest first with status (open / settled / expired), result, payout and profit; `bet_id` for one. |
|
|
35
38
|
| `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
39
|
| `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. |
|
|
37
40
|
| `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. |
|
|
@@ -63,13 +66,14 @@ The model uses these tools transparently:
|
|
|
63
66
|
| `propline_get_event_ev` | Pro: cross-book +EV with no-vig fair lines (`devig`: multiplicative or shin; `fair_source`: pick the anchor book(s), tried in order) |
|
|
64
67
|
| `propline_get_event_projections` | Hobby+: market-implied consensus projection per (market, player) |
|
|
65
68
|
| `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 |
|
|
69
|
+
| `propline_get_parlay_link` | One bet-slip link with several legs at DraftKings, FanDuel or Fanatics, from PropLine outcome ids (the book may still refuse the combination) |
|
|
66
70
|
| `propline_list_webhooks` | Streaming Lite+: list webhook subscriptions (read-only, secrets masked) |
|
|
67
71
|
| `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 |
|
|
68
72
|
| `propline_create_free_api_key` | Sign the user up for a free personal key from inside the chat. Takes the email **the user gives**; the key is emailed to them (never returned), with a ready-made connector URL to reconnect. The only tool that is not read-only |
|
|
69
73
|
|
|
70
74
|
## Hosted endpoint (no install)
|
|
71
75
|
|
|
72
|
-
The same
|
|
76
|
+
The same 47 tools are served over **Streamable HTTP** at
|
|
73
77
|
|
|
74
78
|
```
|
|
75
79
|
https://mcp.prop-line.com/mcp
|
package/dist/http.js
CHANGED
|
@@ -189,6 +189,21 @@ var PropLineClient = class {
|
|
|
189
189
|
settleBets(bets) {
|
|
190
190
|
return this.postRequest(`/v1/bets/settle`, bets);
|
|
191
191
|
}
|
|
192
|
+
/** Register bets to be settled and pushed when their games grade. Hobby+. */
|
|
193
|
+
trackBets(bets) {
|
|
194
|
+
return this.postRequest(`/v1/bets`, bets);
|
|
195
|
+
}
|
|
196
|
+
/** List tracked bets (or one, by id). Hobby+. */
|
|
197
|
+
listTrackedBets(opts = {}) {
|
|
198
|
+
if (opts.betId !== void 0) {
|
|
199
|
+
return this.request(`/v1/bets/${opts.betId}`, {});
|
|
200
|
+
}
|
|
201
|
+
return this.request(`/v1/bets`, {
|
|
202
|
+
status: opts.status,
|
|
203
|
+
since: opts.since,
|
|
204
|
+
limit: opts.limit === void 0 ? void 0 : String(opts.limit)
|
|
205
|
+
});
|
|
206
|
+
}
|
|
192
207
|
/** Fair price of a parlay across games. Hobby+. */
|
|
193
208
|
priceParlay(body) {
|
|
194
209
|
return this.postRequest(`/v1/parlay/price`, body);
|
|
@@ -404,6 +419,9 @@ var PropLineClient = class {
|
|
|
404
419
|
includeLinks: opts.includeLinks ? "true" : void 0
|
|
405
420
|
});
|
|
406
421
|
}
|
|
422
|
+
getParlayLink(outcomeIds) {
|
|
423
|
+
return this.request("/v1/bet-links/parlay", { outcome_ids: outcomeIds });
|
|
424
|
+
}
|
|
407
425
|
// ----- Webhooks (READ-ONLY on purpose) -----
|
|
408
426
|
// Create is excluded because it returns the HMAC signing secret exactly
|
|
409
427
|
// once — through MCP that lands in a model context window and whatever
|
|
@@ -428,7 +446,7 @@ var PropLineClient = class {
|
|
|
428
446
|
};
|
|
429
447
|
|
|
430
448
|
// src/server.ts
|
|
431
|
-
var VERSION = "0.
|
|
449
|
+
var VERSION = "0.58.0";
|
|
432
450
|
var DEMO_KEY = "be2b8487fcfacb1fbc292a8aa925a84c";
|
|
433
451
|
var apiKey = process.env.PROPLINE_API_KEY;
|
|
434
452
|
var baseUrl = process.env.PROPLINE_BASE_URL;
|
|
@@ -821,6 +839,73 @@ var tools = [
|
|
|
821
839
|
},
|
|
822
840
|
handler: (args) => client().settleBets(args.bets)
|
|
823
841
|
},
|
|
842
|
+
{
|
|
843
|
+
name: "propline_track_bets",
|
|
844
|
+
title: "Track bets until they settle",
|
|
845
|
+
writes: true,
|
|
846
|
+
description: "Hobby+ endpoint. Registers PLACED bets (singles or parlays) so PropLine holds them and settles each when its games are graded. Same bet fields as propline_settle_bets. Use this instead of propline_settle_bets when the game has NOT been played yet and the user wants the result later; read it back with propline_list_tracked_bets. Give each bet a ref: sending the same ref again returns the bet already held, so a retry never duplicates. Each bet comes back with bet_id and status: 'open' (held), 'settled' (the game was already graded) or 'rejected' with a reason (not stored: surface it). Streaming Lite and above also get a bet_settled webhook, and bet_regraded if an official stat correction changes the result. The response carries open_bets and open_bet_limit (Hobby/Pro 500). This stores data on the user's account: only call it when the user asked to track or save a bet.",
|
|
847
|
+
inputSchema: {
|
|
848
|
+
type: "object",
|
|
849
|
+
properties: {
|
|
850
|
+
bets: {
|
|
851
|
+
type: "array",
|
|
852
|
+
maxItems: 200,
|
|
853
|
+
description: "Bets to track. A single bet uses the leg fields directly; a parlay sets legs.",
|
|
854
|
+
items: {
|
|
855
|
+
type: "object",
|
|
856
|
+
properties: {
|
|
857
|
+
ref: { type: "string", description: "Your id for the bet; makes retries safe." },
|
|
858
|
+
stake: { type: "number", description: "Defaults to 1." },
|
|
859
|
+
sport_key: { type: "string" },
|
|
860
|
+
event_id: { type: ["string", "number"] },
|
|
861
|
+
market: { type: "string" },
|
|
862
|
+
selection: {
|
|
863
|
+
type: "string",
|
|
864
|
+
description: "Player for a prop, team for a game line, 'Over'/'Under' for a game total."
|
|
865
|
+
},
|
|
866
|
+
side: { type: "string", description: "Over/Under/Yes/No for two-way markets." },
|
|
867
|
+
point: { type: "number", description: "The bettor's line." },
|
|
868
|
+
period: { type: "string", description: "Canonical period code (q1, h1, f5). Omit for full game." },
|
|
869
|
+
team: { type: "string", description: "Scope a totals bet to one team's total." },
|
|
870
|
+
bookmaker: { type: "string", description: "Optional book the bet was placed at." },
|
|
871
|
+
price: { type: "number", description: "American odds taken. Needed for payout." },
|
|
872
|
+
legs: {
|
|
873
|
+
type: "array",
|
|
874
|
+
maxItems: 20,
|
|
875
|
+
description: "Parlay legs; each has the single-bet fields above.",
|
|
876
|
+
items: { type: "object" }
|
|
877
|
+
}
|
|
878
|
+
},
|
|
879
|
+
additionalProperties: false
|
|
880
|
+
}
|
|
881
|
+
}
|
|
882
|
+
},
|
|
883
|
+
required: ["bets"],
|
|
884
|
+
additionalProperties: false
|
|
885
|
+
},
|
|
886
|
+
handler: (args) => client().trackBets(args.bets)
|
|
887
|
+
},
|
|
888
|
+
{
|
|
889
|
+
name: "propline_list_tracked_bets",
|
|
890
|
+
title: "List tracked bets and their results",
|
|
891
|
+
description: "Hobby+ endpoint. Lists the bets registered with propline_track_bets, newest first, each with status (open / settled / expired), result, payout, profit and legs. Pass bet_id for one bet. status filters; since (ISO timestamp) returns only bets settled or regraded at or after it. 'open' means the game is not graded yet: say so, do not guess. 'expired' means the game was never graded within 14 days. regraded_at is set when an official stat correction changed a result.",
|
|
892
|
+
inputSchema: {
|
|
893
|
+
type: "object",
|
|
894
|
+
properties: {
|
|
895
|
+
bet_id: { type: "number", description: "Return just this bet." },
|
|
896
|
+
status: { type: "string", enum: ["open", "settled", "expired"] },
|
|
897
|
+
since: { type: "string", description: "ISO timestamp." },
|
|
898
|
+
limit: { type: "number", description: "1-500, default 100." }
|
|
899
|
+
},
|
|
900
|
+
additionalProperties: false
|
|
901
|
+
},
|
|
902
|
+
handler: (args) => client().listTrackedBets({
|
|
903
|
+
betId: args.bet_id,
|
|
904
|
+
status: args.status,
|
|
905
|
+
since: args.since,
|
|
906
|
+
limit: args.limit
|
|
907
|
+
})
|
|
908
|
+
},
|
|
824
909
|
{
|
|
825
910
|
name: "propline_price_parlay",
|
|
826
911
|
title: "Price a parlay across games",
|
|
@@ -1633,6 +1718,23 @@ var tools = [
|
|
|
1633
1718
|
}
|
|
1634
1719
|
)
|
|
1635
1720
|
},
|
|
1721
|
+
{
|
|
1722
|
+
name: "propline_get_parlay_link",
|
|
1723
|
+
title: "Get multi-leg bet-slip link",
|
|
1724
|
+
description: "One link that opens a sportsbook with several legs on the bet slip. Pass PropLine outcome ids (the outcome_id on propline_get_best_line price rows with include_links=true), 1-12, all at one book: DraftKings, FanDuel or Fanatics. Returns bet_link plus each leg's book ids. The link only LOADS the legs; the book may still refuse to combine them (some same-game parlays), so tell the user to check the slip. No prices; every tier.",
|
|
1725
|
+
inputSchema: {
|
|
1726
|
+
type: "object",
|
|
1727
|
+
properties: {
|
|
1728
|
+
outcome_ids: {
|
|
1729
|
+
type: "string",
|
|
1730
|
+
description: "Comma-separated PropLine outcome ids, e.g. '16263784960,16263949931'."
|
|
1731
|
+
}
|
|
1732
|
+
},
|
|
1733
|
+
required: ["outcome_ids"],
|
|
1734
|
+
additionalProperties: false
|
|
1735
|
+
},
|
|
1736
|
+
handler: (args) => client().getParlayLink(String(args.outcome_ids))
|
|
1737
|
+
},
|
|
1636
1738
|
// -- Webhooks: READ-ONLY on purpose. Create returns the HMAC secret exactly
|
|
1637
1739
|
// once (a credential in a model context); update/delete/test are
|
|
1638
1740
|
// side-effectful. The read pair is the self-service debugging surface.
|