propline-mcp 0.41.0 → 0.43.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 CHANGED
@@ -43,10 +43,11 @@ The model uses these tools transparently:
43
43
  | `propline_get_event_context` | Game conditions a prop settles under — probable pitchers, lineup flag, home-plate umpire, first-pitch weather (free) |
44
44
  | `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. |
45
45
  | `propline_get_event_results` | Pro: graded won/lost/push per prop |
46
- | `propline_get_player_history` | Player prop history with resolution |
47
- | `propline_get_player_games` | Player game log — recent games with every raw box-score stat per game, one call instead of one per event; `opponent` gives head-to-head (last N *meetings*). Raw-stat archive, so it includes games no book priced |
46
+ | `propline_search_players` | Free: find a player by name fragment → stable `player_id` + every spelling the books use (`known_names`) |
47
+ | `propline_get_player_history` | Player prop history with resolution; accepts a `player_id`; optional `main_line_only`; entries carry `is_main_line` + `line_moved_in_play` |
48
+ | `propline_get_player_games` | Player game log — recent games with every raw box-score stat per game, one call instead of one per event; `opponent` gives head-to-head (last N *meetings*). Raw-stat archive, so it includes games no book priced. Accepts a `player_id` in place of the name |
48
49
  | `propline_get_player_trends` | Hit-rate trends — over/under/push splits over last 5/10/20/50 graded games, streak, avg actual (optional `dfs_odds_type` to scope to a PrizePicks flavor) |
49
- | `propline_get_event_ev` | Pro: cross-book +EV with no-vig fair lines (`devig`: multiplicative or shin) |
50
+ | `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) |
50
51
  | `propline_get_event_projections` | Hobby+: market-implied consensus projection per (market, player) |
51
52
  | `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 |
52
53
  | `propline_list_webhooks` | Streaming Lite+: list webhook subscriptions (read-only, secrets masked) |
@@ -55,7 +56,7 @@ The model uses these tools transparently:
55
56
 
56
57
  ## Hosted endpoint (no install)
57
58
 
58
- The same 29 tools are served over **Streamable HTTP** at
59
+ The same 30 tools are served over **Streamable HTTP** at
59
60
 
60
61
  ```
61
62
  https://mcp.prop-line.com/mcp
@@ -120,7 +121,7 @@ Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) o
120
121
  }
121
122
  ```
122
123
 
123
- 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.)
124
+ Restart Claude Desktop. The hammer icon should show 30 PropLine tools. (Or skip the install and add `https://mcp.prop-line.com/mcp` as a custom connector — see the hosted endpoint above.)
124
125
 
125
126
  #### Claude Code
126
127
 
package/dist/http.js CHANGED
@@ -265,11 +265,22 @@ var PropLineClient = class {
265
265
  }
266
266
  );
267
267
  }
268
+ // ----- Player search -----
269
+ searchPlayers(sportKey, search, opts = {}) {
270
+ return this.request(`/v1/sports/${sportKey}/players`, {
271
+ search,
272
+ limit: opts.limit
273
+ });
274
+ }
268
275
  // ----- Player history -----
269
276
  getPlayerHistory(sportKey, playerName, opts = {}) {
270
277
  return this.request(
271
278
  `/v1/sports/${sportKey}/players/${encodeURIComponent(playerName)}/history`,
272
- { limit: opts.limit, markets: opts.markets }
279
+ {
280
+ limit: opts.limit,
281
+ market: opts.market,
282
+ main_line_only: opts.mainLineOnly === void 0 ? void 0 : opts.mainLineOnly ? "true" : "false"
283
+ }
273
284
  );
274
285
  }
275
286
  // ----- Player game log / H2H -----
@@ -291,7 +302,8 @@ var PropLineClient = class {
291
302
  return this.request(`/v1/sports/${sportKey}/events/${eventId}/ev`, {
292
303
  markets: opts.markets,
293
304
  bookmakers: opts.bookmakers,
294
- devig: opts.devig
305
+ devig: opts.devig,
306
+ fair_source: opts.fairSource
295
307
  });
296
308
  }
297
309
  getEventProjections(sportKey, eventId, opts = {}) {
@@ -331,7 +343,7 @@ var PropLineClient = class {
331
343
  };
332
344
 
333
345
  // src/server.ts
334
- var VERSION = "0.41.0";
346
+ var VERSION = "0.43.0";
335
347
  var DEMO_KEY = "be2b8487fcfacb1fbc292a8aa925a84c";
336
348
  var apiKey = process.env.PROPLINE_API_KEY;
337
349
  var baseUrl = process.env.PROPLINE_BASE_URL;
@@ -952,25 +964,57 @@ var tools = [
952
964
  }
953
965
  )
954
966
  },
967
+ {
968
+ name: "propline_search_players",
969
+ title: "Search players",
970
+ description: "Find a player by name fragment and get their stable player_id (e.g. 'mlb:677951') plus every spelling the books use (known_names). Free tier. Pass the player_id as player_name to propline_get_player_history / propline_get_player_trends to avoid name-spelling ambiguity.",
971
+ inputSchema: {
972
+ type: "object",
973
+ properties: {
974
+ sport_key: { type: "string" },
975
+ search: {
976
+ type: "string",
977
+ description: "Name fragment to match, e.g. 'judge'"
978
+ },
979
+ limit: {
980
+ type: "number",
981
+ description: "Max players to return, 1-100. Default 25."
982
+ }
983
+ },
984
+ required: ["sport_key", "search"],
985
+ additionalProperties: false
986
+ },
987
+ handler: (args) => client().searchPlayers(args.sport_key, args.search, {
988
+ limit: args.limit
989
+ })
990
+ },
955
991
  {
956
992
  name: "propline_get_player_history",
957
993
  title: "Get player prop history",
958
- description: "Player prop history across recent games. Returns each prior prop this player took with line, prices, resolution, and actual value. Pro tier returns full data; free tier returns redacted resolution/actual_value with an upgrade pointer.",
994
+ description: "Player prop history across recent games for one market. Returns each prior prop this player took with line, prices, resolution, actual value, is_main_line (the book's main line vs an alt-ladder rung) and line_moved_in_play. Pass main_line_only=true to drop alt rungs. Pro tier returns full data; free tier returns redacted resolution/actual_value with an upgrade pointer.",
959
995
  inputSchema: {
960
996
  type: "object",
961
997
  properties: {
962
998
  sport_key: { type: "string" },
963
999
  player_name: {
964
1000
  type: "string",
965
- description: "Player name as it appears in box scores \u2014 e.g. 'Aaron Judge', 'Nikola Jokic'"
1001
+ description: "Player name as it appears in box scores \u2014 e.g. 'Aaron Judge', 'Nikola Jokic' \u2014 or a player_id from propline_search_players, e.g. 'mlb:592450'"
1002
+ },
1003
+ market: {
1004
+ type: "string",
1005
+ description: "Market key, e.g. 'pitcher_strikeouts' or 'player_points'"
1006
+ },
1007
+ markets: {
1008
+ type: "string",
1009
+ description: "Deprecated alias: the first market of a comma-separated list is used when `market` is omitted"
966
1010
  },
967
1011
  limit: {
968
1012
  type: "number",
969
1013
  description: "Max number of past games (default 20, max 100)"
970
1014
  },
971
- markets: {
972
- type: "string",
973
- description: "Comma-separated subset of markets (e.g. 'player_points,player_rebounds')"
1015
+ main_line_only: {
1016
+ type: "boolean",
1017
+ description: "Only each book's main line (drops alt-ladder rungs). Omit for every line."
974
1018
  }
975
1019
  },
976
1020
  required: ["sport_key", "player_name"],
@@ -981,21 +1025,22 @@ var tools = [
981
1025
  args.player_name,
982
1026
  {
983
1027
  limit: args.limit,
984
- markets: args.markets
1028
+ market: args.market ?? (args.markets?.split(",")[0]?.trim() || void 0),
1029
+ mainLineOnly: args.main_line_only
985
1030
  }
986
1031
  )
987
1032
  },
988
1033
  {
989
1034
  name: "propline_get_player_games",
990
1035
  title: "Get player game log / H2H",
991
- description: "A player's recent games with every raw box-score stat per game \u2014 one call instead of one request per event. Use this to answer 'how has X actually performed lately?' and to build L5/L10/L20, season splits and head-to-head yourself. Pass `opponent` for H2H (accepts a full name, nickname or abbreviation \u2014 'Boston Red Sox', 'Red Sox', 'BOS'); the limit applies AFTER that filter, so opponent + limit=10 means the last 10 MEETINGS, not the Boston games among the last 10 games. H2H is not capped to the current season. IMPORTANT: this is the raw box-score archive, NOT graded-prop history \u2014 it covers every game with a box score on file, including games no sportsbook priced, so a 'last 10 games' window here really is the last 10 games (one built from propline_get_player_trends silently skips unpriced games). It carries no line, price or grade; use propline_get_player_trends for hit rates against a posted line. `player_team`/`opponent`/`is_home` are null when the player's side can't be identified, and always for individual sports (tennis, golf, UFC) \u2014 report them as unknown rather than guessing.",
1036
+ description: "A player's recent games with every raw box-score stat per game \u2014 one call instead of one request per event. Use this to answer 'how has X actually performed lately?' and to build L5/L10/L20, season splits and head-to-head yourself. Pass `opponent` for H2H (accepts a full name, nickname or abbreviation \u2014 'Boston Red Sox', 'Red Sox', 'BOS'); the limit applies AFTER that filter, so opponent + limit=10 means the last 10 MEETINGS, not the Boston games among the last 10 games. H2H is not capped to the current season. IMPORTANT: this is the raw box-score archive, NOT graded-prop history \u2014 it covers every game with a box score on file, including games no sportsbook priced, so a 'last 10 games' window here really is the last 10 games (one built from propline_get_player_trends silently skips unpriced games). It carries no line, price or grade; use propline_get_player_trends for hit rates against a posted line. `player_team`/`opponent`/`is_home` are null when the player's side can't be identified, and always for individual sports (tennis, golf, UFC) \u2014 report them as unknown rather than guessing. Accepts a player_id in place of the name; the response carries player_id (null when the player has none yet).",
992
1037
  inputSchema: {
993
1038
  type: "object",
994
1039
  properties: {
995
1040
  sport_key: { type: "string" },
996
1041
  player_name: {
997
1042
  type: "string",
998
- description: "Player name as it appears in box scores \u2014 e.g. 'Aaron Judge', 'Nikola Jokic'"
1043
+ description: "Player name as it appears in box scores \u2014 e.g. 'Aaron Judge', 'Nikola Jokic' \u2014 or a player_id from propline_search_players, e.g. 'mlb:592450'"
999
1044
  },
1000
1045
  limit: {
1001
1046
  type: "number",
@@ -1033,7 +1078,7 @@ var tools = [
1033
1078
  sport_key: { type: "string" },
1034
1079
  player_name: {
1035
1080
  type: "string",
1036
- description: "Player name as it appears in box scores \u2014 e.g. 'Aaron Judge', 'Nikola Jokic'"
1081
+ description: "Player name as it appears in box scores \u2014 e.g. 'Aaron Judge', 'Nikola Jokic' \u2014 or a player_id from propline_search_players, e.g. 'mlb:592450'"
1037
1082
  },
1038
1083
  market: {
1039
1084
  type: "string",
@@ -1079,6 +1124,10 @@ var tools = [
1079
1124
  type: "string",
1080
1125
  enum: ["multiplicative", "shin"],
1081
1126
  description: "How the anchor's vig is removed. 'multiplicative' (default) divides each implied probability by the booksum; 'shin' solves Shin's insider-trading model, which loads the overround onto the longshot and corrects the favourite-longshot bias \u2014 use it when the user asks about longshot props (anytime TD, first scorer). The response echoes devig_method; say which method the numbers came from."
1127
+ },
1128
+ fair_source: {
1129
+ type: "string",
1130
+ description: "Optional anchor override: one book or a comma-separated list tried IN ORDER per line, from pinnacle, polymarket, kalshi, bovada, smarkets (anything else is a 400). Lines none of them anchor are dropped. Omit for the default order."
1082
1131
  }
1083
1132
  },
1084
1133
  required: ["sport_key", "event_id"],
@@ -1091,7 +1140,8 @@ var tools = [
1091
1140
  {
1092
1141
  markets: args.markets,
1093
1142
  bookmakers: args.bookmakers,
1094
- devig: args.devig
1143
+ devig: args.devig,
1144
+ fairSource: args.fair_source
1095
1145
  }
1096
1146
  );
1097
1147
  return filterByMinEv(res, args.min_ev_pct);