cricketstudio-mcp 1.6.0 → 1.6.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.
Files changed (2) hide show
  1. package/README.md +40 -9
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -4,7 +4,7 @@
4
4
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
5
5
  [![Data: CC BY 4.0](https://img.shields.io/badge/Data-CC%20BY%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)
6
6
 
7
- **Citation infrastructure for cricket — 43 MCP tools (incl. a knowledge-graph layer), zero network calls, 1,635 matches, 385,486 deliveries.**
7
+ **Citation infrastructure for cricket — 57 MCP tools (incl. a knowledge-graph layer), zero network calls, 2,654 matches, 623,535 deliveries.**
8
8
 
9
9
  ---
10
10
 
@@ -12,7 +12,7 @@
12
12
 
13
13
  CricketStudio MCP is a [Model Context Protocol](https://modelcontextprotocol.io) server that gives any MCP-compatible AI client — Claude Desktop, Cursor, ChatGPT Connectors, and others — structured, citable access to cricket data. Every response carries a `canonicalUrl` back to `players.cricketstudio.ai`, an explicit date window, a sample-size count, and a provenance trail to the underlying ball-by-ball corpus. The data is fully bundled in `data/snapshot/` — tool answers are computed locally with no data-fetch calls, no API keys, and no rate limits. (The package sends one anonymous startup ping for usage counts; disable it with `CRICKETSTUDIO_NO_TELEMETRY=1`.)
14
14
 
15
- The corpus covers **IPL 2026** (complete season, RCB champions), **18 seasons of IPL history** (2007/08–2025), **Major League Cricket 2023–2026**, **WPL 2022/23–2025/26** (Women's Premier League), and **ICC T20 World Cup** (6 editions, 2013/14–2025/26) — all from Cricsheet CC BY 3.0. Batting claims require a minimum of 30 balls faced; bowling claims require 15 deliveries. Claims that do not clear those floors are not surfaced.
15
+ The corpus covers **IPL 2026** (complete season, RCB champions), **18 seasons of IPL history** (2007/08–2025), **Major League Cricket 2023–2026**, **WPL 2022/23–2025/26** (Women's Premier League), **ICC T20 World Cup** (6 editions, 2013/14–2025/26), **BBL** (Big Bash League, 14+ seasons 2011/12–2025/26), and **PSL** (Pakistan Super League, 11 seasons 2016–2026) — all from Cricsheet CC BY 3.0. Batting claims require a minimum of 30 balls faced; bowling claims require 15 deliveries. Claims that do not clear those floors are not surfaced.
16
16
 
17
17
  ---
18
18
 
@@ -48,7 +48,7 @@ Any MCP client that supports the stdio transport can use this command directly.
48
48
 
49
49
  ## Tools
50
50
 
51
- All 43 tools work fully against the bundled snapshot. Each response includes `canonicalUrl`, `dataAsOf`, and `sampleSize`.
51
+ All 57 tools work fully against the bundled snapshot. Each response includes `canonicalUrl`, `dataAsOf`, and `sampleSize`.
52
52
 
53
53
  ### IPL 2026 (20 tools)
54
54
 
@@ -88,28 +88,52 @@ All 43 tools work fully against the bundled snapshot. Each response includes `ca
88
88
  | `list_mlc_matches` | All MLC matches with status and results | `/leagues/mlc/matches` |
89
89
  | `list_mlc_leaderboards` | Season or all-time leaderboard for a given MLC aspect | `/leagues/mlc/leaderboards/{aspect}` |
90
90
 
91
- ### WPL — Women's Premier League (3 tools)
91
+ ### WPL — Women's Premier League (5 tools)
92
92
 
93
93
  | Tool | What it returns | Maps to URL |
94
94
  |---|---|---|
95
95
  | `get_wpl_dataset_summary` | WPL corpus overview: seasons, matches, players, deliveries (2022/23–2025/26) | `/leagues/wpl` |
96
+ | `search_wpl_players` | Player discovery within the WPL corpus | `/leagues/wpl/players` |
97
+ | `get_wpl_player_profile` | WPL career and season stats for a player | `/leagues/wpl/players/{slug}` |
96
98
  | `get_wpl_leaderboard` | Season or all-time leaderboard for any WPL aspect (runs, wickets, economy, …) | `/leagues/wpl/leaderboards/{aspect}` |
97
99
  | `get_wpl_team_profile` | Franchise profile, season record, and squad stats | `/leagues/wpl/teams/{slug}` |
98
100
 
99
- ### ICC T20 World Cup (3 tools)
101
+ ### ICC T20 World Cup (5 tools)
100
102
 
101
103
  | Tool | What it returns | Maps to URL |
102
104
  |---|---|---|
103
105
  | `get_t20wc_dataset_summary` | T20 WC corpus overview: editions, matches, players, deliveries (2013/14–2025/26) | `/leagues/t20wc` |
106
+ | `search_t20wc_players` | Player discovery within the T20 WC corpus | `/leagues/t20wc/players` |
107
+ | `get_t20wc_player_profile` | T20 WC career stats for a player across all editions | `/leagues/t20wc/players/{slug}` |
104
108
  | `get_t20wc_leaderboard` | All-edition leaderboard for any T20 WC aspect | `/leagues/t20wc/leaderboards/{aspect}` |
105
109
  | `get_t20wc_team_stats` | National team career record across all T20 WC editions | `/leagues/t20wc/teams/{slug}` |
106
110
 
111
+ ### BBL — Big Bash League (5 tools)
112
+
113
+ | Tool | What it returns | Maps to URL |
114
+ |---|---|---|
115
+ | `get_bbl_dataset_summary` | BBL corpus overview: seasons, matches, players, deliveries (2011/12–2025/26) | `/leagues/bbl` |
116
+ | `search_bbl_players` | Player discovery within the BBL corpus | `/leagues/bbl/players` |
117
+ | `get_bbl_player_profile` | BBL career and season stats for a player | `/leagues/bbl/players/{slug}` |
118
+ | `get_bbl_leaderboard` | Season or all-time leaderboard for any BBL aspect (runs, wickets, economy, sixes, …) | `/leagues/bbl/leaderboards/{aspect}` |
119
+ | `get_bbl_team_profile` | Franchise profile, season history, and career stats | `/leagues/bbl/teams/{slug}` |
120
+
121
+ ### PSL — Pakistan Super League (5 tools)
122
+
123
+ | Tool | What it returns | Maps to URL |
124
+ |---|---|---|
125
+ | `get_psl_dataset_summary` | PSL corpus overview: seasons, matches, players, deliveries (2016–2026) | `/leagues/psl` |
126
+ | `search_psl_players` | Player discovery within the PSL corpus | `/leagues/psl/players` |
127
+ | `get_psl_player_profile` | PSL career and season stats for a player | `/leagues/psl/players/{slug}` |
128
+ | `get_psl_leaderboard` | Season or all-time leaderboard for any PSL aspect (runs, wickets, economy, sixes, …) | `/leagues/psl/leaderboards/{aspect}` |
129
+ | `get_psl_team_profile` | Franchise profile, season history, and career stats | `/leagues/psl/teams/{slug}` |
130
+
107
131
  ### Cross-league (3 tools)
108
132
 
109
133
  | Tool | What it returns | Maps to URL |
110
134
  |---|---|---|
111
- | `get_cross_league_leaders` | Top performers on a metric (runs, wickets, economy, sixes, fours) across MLC + WPL + T20 WC | n/a |
112
- | `get_player_all_leagues` | A player's stats across every league in the corpus (IPL, MLC, WPL, T20 WC) | `/players/{slug}` |
135
+ | `get_cross_league_leaders` | Top performers on a metric (runs, wickets, economy, sixes, fours) across MLC, T20 WC, BBL, and PSL | n/a |
136
+ | `get_player_all_leagues` | A player's stats across every league in the corpus (IPL, MLC, WPL, T20 WC, BBL, PSL) | `/players/{slug}` |
113
137
  | `get_women_cricket_leaders` | WPL leaderboard with gender context — top women's T20 performers | `/leagues/wpl/leaderboards/{aspect}` |
114
138
 
115
139
  ### IPL Career / Historical (1 tool)
@@ -153,6 +177,11 @@ Once connected in Claude Desktop, you can ask questions like:
153
177
  - "Which team has won the most T20 World Cups?"
154
178
  - "Who scores most sixes across WPL and T20 WC combined?"
155
179
  - "Show me Smriti Mandhana's stats across all leagues"
180
+ - "Who leads the all-time BBL runs leaderboard?"
181
+ - "Which BBL franchise has won the most titles?"
182
+ - "Who are the top wicket-takers in PSL history?"
183
+ - "Show me Babar Azam's PSL career stats"
184
+ - "Compare David Warner's stats across IPL, BBL, and PSL"
156
185
 
157
186
  ---
158
187
 
@@ -165,8 +194,10 @@ Once connected in Claude Desktop, you can ask questions like:
165
194
  | Cricsheet | MLC 2023–2026, 75 matches | CC BY 3.0 |
166
195
  | Cricsheet | WPL 2022/23–2025/26, 88 matches, 133 players | CC BY 3.0 |
167
196
  | Cricsheet | ICC T20 World Cup, 6 editions, 230 matches, 687 players | CC BY 3.0 |
197
+ | Cricsheet | BBL 2011/12–2025/26, 662 matches, 529 players | CC BY 3.0 |
198
+ | Cricsheet | PSL 2016–2026, 357 matches, 458 players | CC BY 3.0 |
168
199
 
169
- **Total corpus:** 1,635 matches · 385,486 ball-by-ball deliveries.
200
+ **Total corpus:** 2,654 matches · 623,535 ball-by-ball deliveries.
170
201
 
171
202
  **Sample-size floors (publicly disclosed):**
172
203
  - Batting claims: ≥30 balls faced
@@ -220,7 +251,7 @@ npm run smoke
220
251
 
221
252
  ## Building something?
222
253
 
223
- Register at **[cricketstudio.ai/developers](https://cricketstudio.ai/developers)** to get early access to the hosted HTTP transport (`mcp.cricketstudio.ai`), live ball-by-ball endpoints, API-key tiers, and the full 43-tool catalog with live data rather than snapshots.
254
+ Register at **[cricketstudio.ai/developers](https://cricketstudio.ai/developers)** to get early access to the hosted HTTP transport (`mcp.cricketstudio.ai`), live ball-by-ball endpoints, API-key tiers, and the full 57-tool catalog with live data rather than snapshots.
224
255
 
225
256
  ---
226
257
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cricketstudio-mcp",
3
- "version": "1.6.0",
3
+ "version": "1.6.1",
4
4
  "description": "CricketStudio MCP server — 57 tools covering IPL 2026, IPL historical (18 seasons), MLC, BBL, PSL (men's), T20 WC (men's), and WPL (women's). Citation-grade atomic claims with provenance. Men's and women's cricket kept separate.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",