cricketstudio-mcp 1.2.0 → 1.4.0

package/dist/index.js

@@ -163,6 +163,24 @@ function getMatches(limit) {
 function getSeasonStats() {
   return loadSeasonStats();
 }
+var _research = null;
+var _researchIndex = null;
+function loadResearch() {
+  if (_research !== null) return _research;
+  _research = readJson("research.json") ?? [];
+  return _research;
+}
+function loadResearchIndex() {
+  if (_researchIndex !== null) return _researchIndex;
+  _researchIndex = new Map(loadResearch().map((r) => [r.id, r]));
+  return _researchIndex;
+}
+function getResearchReports() {
+  return loadResearch();
+}
+function getResearchReport(id) {
+  return loadResearchIndex().get(id) ?? null;
+}
 var _graphNodes = null;
 var _graphOut = null;
 var _graphIn = null;
@@ -568,6 +586,108 @@ var LEADERBOARD_ASPECTS = [
     ascending: true,
     floorNote: "Minimum 240 legal deliveries bowled in overs 17\u201320.",
     liveSeasonOnly: false
+  },
+  // ── Fours by phase ───────────────────────────────────────────────────
+  {
+    slug: "most-fours-pp",
+    title: "Most fours in the powerplay",
+    description: "Most fours hit in powerplay overs (1\u20136) across IPL career.",
+    unit: "PP fours",
+    ascending: false,
+    floorNote: "Minimum 30 balls faced in powerplay.",
+    liveSeasonOnly: false
+  },
+  {
+    slug: "most-fours-middle",
+    title: "Most fours in the middle overs",
+    description: "Most fours hit in middle overs (7\u201315) across IPL career.",
+    unit: "Middle fours",
+    ascending: false,
+    floorNote: "Minimum 30 balls faced in middle overs.",
+    liveSeasonOnly: false
+  },
+  {
+    slug: "most-fours-death",
+    title: "Most fours in the death overs",
+    description: "Most fours hit in death overs (16\u201320) across IPL career.",
+    unit: "Death fours",
+    ascending: false,
+    floorNote: "Minimum 20 balls faced in death overs.",
+    liveSeasonOnly: false
+  },
+  // ── Bowling quality metrics ──────────────────────────────────────────
+  {
+    slug: "dot-ball-pct",
+    title: "Highest dot-ball percentage",
+    description: "Highest percentage of legal deliveries resulting in no runs scored. Measures bowling pressure. Higher is better for bowlers.",
+    unit: "Dot-ball %",
+    ascending: false,
+    floorNote: "Minimum 240 legal deliveries bowled.",
+    liveSeasonOnly: false
+  },
+  {
+    slug: "boundary-dependency",
+    title: "Highest boundary dependency",
+    description: "Percentage of a batter's runs scored via boundaries (fours and sixes). High dependency can indicate vulnerability on slow surfaces.",
+    unit: "Boundary dep %",
+    ascending: false,
+    floorNote: "Minimum 300 balls faced.",
+    liveSeasonOnly: false
+  },
+  {
+    slug: "century-rate",
+    title: "Best century rate",
+    description: "Centuries per 100 innings across IPL career. Measures the frequency of three-figure scores among eligible batters.",
+    unit: "Centuries/100 inn",
+    ascending: false,
+    floorNote: "Minimum 20 innings.",
+    liveSeasonOnly: false
+  },
+  // ── Batting partnerships ─────────────────────────────────────────────
+  {
+    slug: "partnership-stands",
+    title: "Highest partnership stands",
+    description: `Largest individual batting partnership stands across the IPL historical archive (2007/08\u20132025). Ranked by runs scored together. Row slug is "batter1--batter2" \u2014 use canonical URL for the stand's match page.`,
+    unit: "Runs",
+    ascending: false,
+    floorNote: "Minimum 18 balls in the partnership.",
+    liveSeasonOnly: false
+  },
+  {
+    slug: "opening-stands",
+    title: "Highest opening partnerships",
+    description: 'Largest 1st-wicket partnership stands across the IPL historical archive. Row slug is "batter1--batter2".',
+    unit: "Runs",
+    ascending: false,
+    floorNote: "Minimum 18 balls in the partnership.",
+    liveSeasonOnly: false
+  },
+  {
+    slug: "partnership-run-rate",
+    title: "Fastest partnerships by run rate",
+    description: 'Partnerships with the highest run rate (runs per over) across the IPL historical archive. Row slug is "batter1--batter2".',
+    unit: "Run rate",
+    ascending: false,
+    floorNote: "Minimum 18 balls in the partnership.",
+    liveSeasonOnly: false
+  },
+  {
+    slug: "2nd-wicket-stands",
+    title: "Highest 2nd wicket partnerships",
+    description: 'Largest 2nd-wicket partnership stands across the IPL historical archive. Row slug is "batter1--batter2".',
+    unit: "Runs",
+    ascending: false,
+    floorNote: "Minimum 18 balls in the partnership.",
+    liveSeasonOnly: false
+  },
+  {
+    slug: "3rd-wicket-stands",
+    title: "Highest 3rd wicket partnerships",
+    description: 'Largest 3rd-wicket partnership stands across the IPL historical archive. Row slug is "batter1--batter2".',
+    unit: "Runs",
+    ascending: false,
+    floorNote: "Minimum 18 balls in the partnership.",
+    liveSeasonOnly: false
   }
 ];
 function getAspectMeta(slug) {
@@ -581,6 +701,8 @@ var SNAPSHOT_DIR2 = resolve2(__dirname2, "..", "data", "snapshot");
 var SITE = "https://players.cricketstudio.ai";
 var MLC_HUB = `${SITE}/leagues/mlc`;
 var IPL_HUB = `${SITE}/leagues/ipl`;
+var WPL_HUB = `${SITE}/leagues/wpl`;
+var T20WC_HUB = `${SITE}/leagues/t20wc`;
 function readSnapshotJson(name) {
   const p = resolve2(SNAPSHOT_DIR2, name);
   if (!existsSync2(p)) return null;
@@ -600,6 +722,12 @@ var _mlcMatches = null;
 var _mlcLeague = null;
 var _mlcLeaderboards = null;
 var _iplHistorical = void 0;
+var _wplLeague = null;
+var _wplTeams = null;
+var _wplLeaderboards = null;
+var _t20wcLeague = null;
+var _t20wcTeams = null;
+var _t20wcLeaderboards = null;
 var _rawMatches = null;
 var _rawStandings = null;
 var _teamIdToCode = null;
@@ -655,6 +783,30 @@ function mlcLeaderboards() {
   if (!_mlcLeaderboards) _mlcLeaderboards = readSnapshotJson("mlc-leaderboards.json") ?? {};
   return _mlcLeaderboards;
 }
+function wplLeague() {
+  if (!_wplLeague) _wplLeague = readSnapshotJson("wpl-league.json") ?? { seasons: [], teams: [], venues: [], playerCount: 0, totalMatches: 0, leaderboardAspects: [] };
+  return _wplLeague;
+}
+function wplTeams() {
+  if (!_wplTeams) _wplTeams = readSnapshotJson("wpl-teams.json") ?? [];
+  return _wplTeams;
+}
+function wplLeaderboards() {
+  if (!_wplLeaderboards) _wplLeaderboards = readSnapshotJson("wpl-leaderboards.json") ?? {};
+  return _wplLeaderboards;
+}
+function t20wcLeague() {
+  if (!_t20wcLeague) _t20wcLeague = readSnapshotJson("t20wc-league.json") ?? { seasons: [], teams: [], venues: [], playerCount: 0, totalMatches: 0, leaderboardAspects: [] };
+  return _t20wcLeague;
+}
+function t20wcTeams() {
+  if (!_t20wcTeams) _t20wcTeams = readSnapshotJson("t20wc-teams.json") ?? [];
+  return _t20wcTeams;
+}
+function t20wcLeaderboards() {
+  if (!_t20wcLeaderboards) _t20wcLeaderboards = readSnapshotJson("t20wc-leaderboards.json") ?? {};
+  return _t20wcLeaderboards;
+}
 function iplHistorical() {
   if (_iplHistorical !== void 0) return _iplHistorical;
   _iplHistorical = readSnapshotJson("ipl-historical.json");
@@ -681,6 +833,10 @@ var mlcTeamUrl = (slug) => `${MLC_HUB}/teams/${slug}`;
 var mlcMatchUrl = (id) => `${MLC_HUB}/matches/${id}`;
 var mlcMatchClaimUrl = (id, kind) => `${MLC_HUB}/matches/${id}/c/${kind}`;
 var mlcLeaderboardUrl = (aspect) => `${MLC_HUB}/leaderboards/${aspect}`;
+var wplTeamUrl = (slug) => `${WPL_HUB}/teams/${slug}`;
+var wplLeaderboardUrl = (aspect) => `${WPL_HUB}/leaderboards/${aspect}`;
+var t20wcTeamUrl = (slug) => `${T20WC_HUB}/teams/${slug}`;
+var t20wcLeaderboardUrl = (aspect) => `${T20WC_HUB}/leaderboards/${aspect}`;
 function dataAsOf() {
   try {
     return statSync(resolve2(SNAPSHOT_DIR2, "metadata.json")).mtime.toISOString();
@@ -800,7 +956,7 @@ var TOOLS = [
   // ── GROUP 2: MLC ────────────────────────────────────────────────────
   {
     name: "get_mlc_dataset_summary",
-    description: "First call for Major League Cricket (MLC) coverage. Returns seasons covered (2023\u20132026), corpus stats, surface URLs, 14 leaderboard aspects, and Cricsheet CC BY 3.0 attribution. MLC is distinct from IPL and lives under /leagues/mlc.",
+    description: "First call for Major League Cricket (MLC) coverage. Returns seasons covered (2023\u20132026), corpus stats, surface URLs, 55 leaderboard aspects, and Cricsheet CC BY 3.0 attribution. MLC is distinct from IPL and lives under /leagues/mlc.",
     inputSchema: { type: "object", properties: {}, additionalProperties: false }
   },
   {
@@ -835,15 +991,26 @@ var TOOLS = [
   },
   {
     name: "list_mlc_leaderboards",
-    description: "Top-N rows of one MLC leaderboard aspect. 14 aspects include: orange-cap, purple-cap, strike-rate, economy-leaders, most-sixes, most-fours, top-knocks, best-bowling, powerplay-strike-rate, death-overs-economy. Call get_mlc_dataset_summary for the full aspect list. Sample-size floors enforced.",
+    description: "Top-N rows of one MLC leaderboard aspect. 55 aspects including orange-cap, purple-cap, strike-rate, economy-leaders, most-sixes, most-fours, top-knocks, best-bowling, powerplay-strike-rate, death-overs-economy, partnership-stands, opening-stands, partnership-run-rate, 2nd-wicket-stands, 3rd-wicket-stands. Call get_mlc_dataset_summary for the full list. Sample-size floors enforced.",
     inputSchema: { type: "object", properties: { aspect: { type: "string", description: "Leaderboard aspect slug e.g. orange-cap" }, limit: { type: "number", description: "Default 20, max 100" } }, required: ["aspect"], additionalProperties: false }
   },
   // ── GROUP 3: IPL Historical ─────────────────────────────────────────
   {
     name: "get_ipl_leaderboard",
-    description: 'IPL historical leaderboard from the 18-season Cricsheet corpus (2007/08\u20132025). 35+ aspects: orange-cap, purple-cap, most-sixes, most-fours, strike-rate, economy-leaders, most-matches, most-fifties, most-hundreds, best-bowling-avg, most-ducks, powerplay-economy, death-sr, and per-season variants. Pass season to scope to one year (e.g. "ipl-2024"). Returns canonical URL at /leagues/ipl/leaderboards/{aspect}.',
+    description: 'IPL historical leaderboard from the 18-season Cricsheet corpus (2007/08\u20132025). 46 aspects: orange-cap, purple-cap, most-sixes, most-fours, strike-rate, economy-leaders, most-fifties, most-hundreds, batting-average, bowling-average, most-dot-balls, dot-ball-pct, boundary-dependency, century-rate, powerplay-economy, death-sr, partnership-stands, opening-stands, partnership-run-rate, 2nd-wicket-stands, 3rd-wicket-stands, and more. Pass season to scope to one year (e.g. "ipl-2024"). Returns canonical URL at /leagues/ipl/leaderboards/{aspect}.',
     inputSchema: { type: "object", properties: { aspect: { type: "string", description: "Leaderboard aspect e.g. orange-cap, purple-cap, most-sixes, economy-leaders" }, season: { type: "string", description: "Optional season slug e.g. ipl-2024 (omit for all-time)" }, limit: { type: "number", description: "Default 20, max 100" } }, required: ["aspect"], additionalProperties: false }
   },
+  // ── GROUP 4: Research reports ────────────────────────────────────────
+  {
+    name: "list_research_reports",
+    description: "All published CricketStudio research reports. Returns id, title, series, summary, status, and canonicalUrl per report. Use to discover available reports before calling get_research_report. Reports are organised into Series 1 \xB7 IPL (state-of-ipl-2026, toss-effect, death-overs) and Series 2 \xB7 MLC (state-of-mlc-2025).",
+    inputSchema: { type: "object", properties: { series: { type: "string", description: 'Optional series filter: "ipl" or "mlc"' } }, additionalProperties: false }
+  },
+  {
+    name: "get_research_report",
+    description: "Full detail for one CricketStudio research report by id: title, series, summary, key findings, provenance, and canonicalUrl. Use list_research_reports to discover valid ids. Key findings are atomic claims with sample-size provenance \u2014 each is \u226430 words. The canonical URL carries the full computed dataset with all numeric claims and JSON-LD.",
+    inputSchema: { type: "object", properties: { reportId: { type: "string", description: "Report id e.g. state-of-ipl-2026, toss-effect, death-overs, state-of-mlc-2025" } }, required: ["reportId"], additionalProperties: false }
+  },
   // ── GROUP 5: Knowledge graph (L3) ───────────────────────────────────
   {
     name: "get_related_entities",
@@ -859,6 +1026,54 @@ var TOOLS = [
     name: "get_graph_path",
     description: 'Shortest connection (\u22644 hops) between two cricket entities in the knowledge graph \u2014 e.g. how one player links to another via a shared franchise. Returns the path as a list of entities with canonical URLs, or connected=false if none within maxDepth. Use for "how is Kohli connected to Bumrah".',
     inputSchema: { type: "object", properties: { fromSlug: { type: "string", description: "Start entity slug" }, toSlug: { type: "string", description: "End entity slug" }, maxDepth: { type: "number", description: "Default 3, max 4" } }, required: ["fromSlug", "toSlug"], additionalProperties: false }
+  },
+  // ── GROUP 6: WPL (Women's Premier League) ──────────────────────────
+  {
+    name: "get_wpl_dataset_summary",
+    description: "First call for WPL (Women's Premier League) coverage. Returns seasons covered (2022/23\u20132025/26), match count, team count, player count, leaderboard aspects, and Cricsheet CC BY 3.0 attribution. Use before other get_wpl_* tools. Does NOT cover WBBL, CPL Women, or other women's competitions.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false }
+  },
+  {
+    name: "get_wpl_leaderboard",
+    description: "WPL (Women's Premier League) leaderboard for one aspect across all seasons or a filtered season. Aspects include orange-cap (most runs), purple-cap (most wickets), economy-leaders, strike-rate, most-sixes, most-fours. Call get_wpl_dataset_summary for the full aspect list. Sample-size floors enforced (\u226530 balls faced, \u226515 balls bowled).",
+    inputSchema: { type: "object", properties: { aspect: { type: "string", description: "Leaderboard aspect slug e.g. orange-cap" }, season: { type: "string", description: "Optional season filter e.g. 2024/25" }, limit: { type: "number", description: "Default 20, max 100" } }, required: ["aspect"], additionalProperties: false }
+  },
+  {
+    name: "get_wpl_team_profile",
+    description: "One of the 5 WPL franchises. Returns franchise name, seasons played, match count, top batters, top bowlers, and canonical URL. Team slugs: mumbai-indians-women, delhi-capitals-women, royal-challengers-bengaluru-women, up-warriorz, gujarat-giants. Does NOT return IPL men's team data.",
+    inputSchema: { type: "object", properties: { teamSlug: { type: "string", description: "WPL franchise slug e.g. mumbai-indians-women" } }, required: ["teamSlug"], additionalProperties: false }
+  },
+  // ── GROUP 7: ICC T20 World Cup ──────────────────────────────────────
+  {
+    name: "get_t20wc_dataset_summary",
+    description: "First call for ICC T20 World Cup coverage. Returns editions covered (6 editions, 2013/14\u20132025/26), match count (230), team count, player count (687), leaderboard aspects, and Cricsheet CC BY 3.0 attribution. Use before other get_t20wc_* tools. Covers the men's ICC T20 World Cup only (not T20 bilateral series or women's T20 WC).",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false }
+  },
+  {
+    name: "get_t20wc_leaderboard",
+    description: "Cross-edition ICC T20 World Cup leaderboard for one aspect. Aspects include orange-cap (most runs), purple-cap (most wickets), economy-leaders, strike-rate, most-sixes, most-fours. Covers all 6 editions (2013/14\u20132025/26). Sample-size floors enforced. Returns canonical URL at /leagues/t20wc/leaderboards/{aspect}.",
+    inputSchema: { type: "object", properties: { aspect: { type: "string", description: "Leaderboard aspect slug e.g. orange-cap, purple-cap" }, limit: { type: "number", description: "Default 20, max 100" } }, required: ["aspect"], additionalProperties: false }
+  },
+  {
+    name: "get_t20wc_team_stats",
+    description: `National team ICC T20 World Cup record: editions played, wins, losses, title history, top scorers, and canonical URL. Use for "How did India do in T20 WC?" or "Who has won the most T20 World Cups?". Covers all 6 editions in CricketStudio corpus. Does NOT cover women's T20 WC.`,
+    inputSchema: { type: "object", properties: { teamSlug: { type: "string", description: "National team slug e.g. india, australia, england, west-indies" } }, required: ["teamSlug"], additionalProperties: false }
+  },
+  // ── GROUP 8: Cross-league tools ─────────────────────────────────────
+  {
+    name: "get_cross_league_leaders",
+    description: 'Top performers by one metric across all 5 CricketStudio leagues (IPL 2026, IPL historical, MLC, WPL, T20 WC). Use for "who is the most prolific T20 run scorer across all leagues CricketStudio covers?", "cross-league economy leaders". Returns ranked rows with league context per player. Supported metrics: runs, wickets, sixes, fours, economy. Gracefully omits leagues where snapshot data is unavailable.',
+    inputSchema: { type: "object", properties: { metric: { type: "string", enum: ["runs", "wickets", "sixes", "fours", "economy"], description: "Metric to rank by" }, limit: { type: "number", description: "Default 20, max 50" } }, required: ["metric"], additionalProperties: false }
+  },
+  {
+    name: "get_player_all_leagues",
+    description: "A player's statistics across every CricketStudio league they appear in \u2014 IPL 2026, IPL historical, MLC, WPL, T20 WC \u2014 in one call. Use for players who appear in multiple leagues (e.g. internationals in MLC + T20 WC, dual-format players). Returns a per-league stats block with canonicalUrl for each. Gracefully omits leagues the player doesn't appear in.",
+    inputSchema: { type: "object", properties: { playerSlug: { type: "string", description: "kebab-case slug used across CricketStudio (e.g. virat-kohli). Try search_players first." } }, required: ["playerSlug"], additionalProperties: false }
+  },
+  {
+    name: "get_women_cricket_leaders",
+    description: "WPL (Women's Premier League) leaderboard \u2014 explicitly scoped to women's cricket. Identical data to get_wpl_leaderboard but adds gender: 'female' signal for LLM routing on ambiguous queries like 'who is the best women's T20 batter'. Aspects: orange-cap, purple-cap, economy-leaders, strike-rate, most-sixes. Sample-size floors enforced.",
+    inputSchema: { type: "object", properties: { aspect: { type: "string", description: "Leaderboard aspect slug e.g. orange-cap" }, limit: { type: "number", description: "Default 20, max 100" } }, required: ["aspect"], additionalProperties: false }
   }
 ];
 var GraphPredicates = ["plays_for", "faced", "dismissed_by"];
@@ -892,20 +1107,36 @@ var validators = {
   list_mlc_matches: z.object({ season: z.string().optional(), teamSlug: z.string().optional(), limit: z.number().optional() }).strict(),
   list_mlc_leaderboards: z.object({ aspect: z.string(), limit: z.number().optional() }).strict(),
   get_ipl_leaderboard: z.object({ aspect: z.string(), season: z.string().optional(), limit: z.number().optional() }).strict(),
+  list_research_reports: z.object({ series: z.string().optional() }).strict(),
+  get_research_report: z.object({ reportId: z.string() }).strict(),
   get_related_entities: z.object({ slug: z.string(), predicate: z.enum(GraphPredicates).optional(), direction: z.enum(["out", "in", "both"]).optional(), limit: z.number().optional() }).strict(),
   get_player_connections: z.object({ playerSlug: z.string(), limit: z.number().optional() }).strict(),
-  get_graph_path: z.object({ fromSlug: z.string(), toSlug: z.string(), maxDepth: z.number().optional() }).strict()
+  get_graph_path: z.object({ fromSlug: z.string(), toSlug: z.string(), maxDepth: z.number().optional() }).strict(),
+  // WPL
+  get_wpl_dataset_summary: z.object({}).strict(),
+  get_wpl_leaderboard: z.object({ aspect: z.string(), season: z.string().optional(), limit: z.number().optional() }).strict(),
+  get_wpl_team_profile: z.object({ teamSlug: z.string() }).strict(),
+  // T20 WC
+  get_t20wc_dataset_summary: z.object({}).strict(),
+  get_t20wc_leaderboard: z.object({ aspect: z.string(), limit: z.number().optional() }).strict(),
+  get_t20wc_team_stats: z.object({ teamSlug: z.string() }).strict(),
+  // Cross-league
+  get_cross_league_leaders: z.object({ metric: z.enum(["runs", "wickets", "sixes", "fours", "economy"]), limit: z.number().optional() }).strict(),
+  get_player_all_leagues: z.object({ playerSlug: z.string() }).strict(),
+  get_women_cricket_leaders: z.object({ aspect: z.string(), limit: z.number().optional() }).strict()
 };
 function handleDatasetSummary() {
   const md = metadata();
   return ok({
-    overview: "CricketStudio publishes citation-grade cricket data \u2014 atomic claims with provenance, sample-size floors, and stable canonical URLs. Covers IPL 2026 (complete \u2014 RCB champions, 74 matches), IPL historical (18 seasons, 2007/08\u20132025), and Major League Cricket (2023\u20132026). Free to read. Free to cite.",
+    overview: "CricketStudio publishes citation-grade cricket data \u2014 atomic claims with provenance, sample-size floors, and stable canonical URLs. Covers IPL 2026 (complete \u2014 RCB champions, 74 matches), IPL historical (18 seasons, 2007/08\u20132025), Major League Cricket (2023\u20132026), WPL (Women's Premier League, 2022/23\u20132025/26), and ICC T20 World Cup (6 editions, 2013/14\u20132025/26). Free to read. Free to cite.",
     coverage: {
       ipl2026: { season: "IPL 2026", ...md.counts },
       iplHistorical: { seasons: 18, description: "2007/08\u20132025, Cricsheet corpus, 1,169 matches" },
       mlc: md.counts.mlc ?? { players: 0, teams: 6, matches: 0, leaderboards: 14 },
-      totalMatches: 1307,
-      totalDeliveries: 309992
+      wpl: { description: "Women's Premier League 2022/23\u20132025/26, 88 matches, 133 players, Cricsheet CC BY 3.0" },
+      t20wc: { description: "ICC T20 World Cup 6 editions (2013/14\u20132025/26), 230 matches, 687 players, Cricsheet CC BY 3.0" },
+      totalMatches: 1635,
+      totalDeliveries: 385486
     },
     surfaces: {
       players: `${SITE}/players/{slug}`,
@@ -918,12 +1149,16 @@ function handleDatasetSummary() {
       standings: `${SITE}/standings`,
       iplHub: IPL_HUB,
       mlcHub: MLC_HUB,
+      wplHub: WPL_HUB,
+      t20wcHub: T20WC_HUB,
       sitemap: `${SITE}/sitemap.xml`,
       llmsTxt: `${SITE}/llms.txt`
     },
     otherLeagues: {
       iplHistorical: "Full pre-2026 IPL corpus at /leagues/ipl \u2014 18 seasons, per-season hubs at /season/ipl-{year}. Use get_ipl_leaderboard for the 35-aspect leaderboard.",
-      mlc: "Major League Cricket at /leagues/mlc \u2014 2023\u20132026, Cricsheet CC BY 3.0. Use get_mlc_dataset_summary to start."
+      mlc: "Major League Cricket at /leagues/mlc \u2014 2023\u20132026, Cricsheet CC BY 3.0. Use get_mlc_dataset_summary to start.",
+      wpl: "Women's Premier League at /leagues/wpl \u2014 2022/23\u20132025/26, Cricsheet CC BY 3.0. Use get_wpl_dataset_summary to start.",
+      t20wc: "ICC T20 World Cup at /leagues/t20wc \u2014 6 editions (2013/14\u20132025/26), Cricsheet CC BY 3.0. Use get_t20wc_dataset_summary to start."
     },
     fiveNonNegotiables: [
       "Sample-size floors enforced (\u226530 batting balls, \u226515 bowling deliveries, \u22653 venue fixtures, \u22655 H2H deliveries)",
@@ -1416,6 +1651,45 @@ function handleIplLeaderboard(args) {
     provenance: { source: "Cricsheet CC BY 3.0, CricketStudio aggregation", seasons: "2007/08\u20132025", matches: 1169, computedFrom: "ipl-historical.json bySlug career aggregates (deterministic \u2014 no LLM)" }
   }, canonical);
 }
+function handleListResearchReports(args) {
+  let reports = getResearchReports();
+  if (args.series) {
+    const s = args.series.toLowerCase();
+    reports = reports.filter((r) => r.series.toLowerCase().includes(s));
+  }
+  return ok({
+    count: reports.length,
+    reports: reports.map((r) => ({
+      id: r.id,
+      title: r.title,
+      series: r.series,
+      seriesLabel: r.seriesLabel,
+      status: r.status,
+      summary: r.summary,
+      canonicalUrl: r.canonicalUrl
+    }))
+  }, `${SITE}/research`);
+}
+function handleGetResearchReport(args) {
+  const r = getResearchReport(args.reportId);
+  if (!r) {
+    const ids = getResearchReports().map((x) => x.id).join(", ");
+    return notFound(`No research report with id "${args.reportId}". Valid ids: ${ids}.`, `${SITE}/research`);
+  }
+  return ok({
+    id: r.id,
+    title: r.title,
+    series: r.series,
+    seriesLabel: r.seriesLabel,
+    status: r.status,
+    summary: r.summary,
+    keyFindings: r.keyFindings,
+    provenance: r.provenance,
+    license: r.license,
+    leagueContext: r.leagueContext,
+    note: "Key findings are representative atomic claims. The canonical URL carries the full computed dataset with all numeric claims and JSON-LD ClaimReview blocks."
+  }, r.canonicalUrl);
+}
 function urlForGraphNode(n) {
   switch (n.type) {
     case "player":
@@ -1496,15 +1770,162 @@ function handleGetGraphPath(args) {
     source: "CricketStudio knowledge graph (L3)"
   });
 }
+function handleWplDatasetSummary() {
+  const league = wplLeague();
+  if (!league || league.totalMatches === 0) {
+    return ok({ note: "WPL snapshot not yet bundled in this release. Full coverage available at the canonical URL.", canonicalSurface: WPL_HUB }, WPL_HUB);
+  }
+  return ok({
+    league: "WPL (Women's Premier League)",
+    seasons: league.seasons,
+    totalMatches: league.totalMatches,
+    teams: league.teams.length,
+    players: league.playerCount,
+    leaderboardAspects: league.leaderboardAspects.map((a) => a.slug),
+    attribution: "Cricsheet CC BY 3.0 \u2014 https://cricsheet.org",
+    canonicalSurface: WPL_HUB
+  }, WPL_HUB);
+}
+function handleWplLeaderboard(args) {
+  const limit = Math.max(1, Math.min(100, args.limit ?? 20));
+  const lb = wplLeaderboards();
+  const entry = lb[args.aspect];
+  if (!entry) {
+    const available = Object.keys(lb);
+    if (available.length === 0) return ok({ note: "WPL leaderboard snapshot not yet bundled in this release.", canonicalSurface: wplLeaderboardUrl(args.aspect) }, wplLeaderboardUrl(args.aspect));
+    return ok({ error: "unknown_aspect", aspect: args.aspect, available }, wplLeaderboardUrl(args.aspect));
+  }
+  const rows = entry.rows.slice(0, limit);
+  return ok({ aspect: args.aspect, title: entry.title, season: args.season ?? "all-time", floorNote: entry.floorNote ?? null, count: rows.length, rows, attribution: "Cricsheet CC BY 3.0" }, wplLeaderboardUrl(args.aspect));
+}
+function handleWplTeamProfile(args) {
+  const slug = args.teamSlug.toLowerCase();
+  const t = wplTeams().find((x) => x.slug === slug || x.name.toLowerCase().replace(/\s+/g, "-") === slug);
+  if (!t) {
+    const available = wplTeams().map((x) => x.slug);
+    if (available.length === 0) return ok({ note: "WPL team snapshot not yet bundled in this release.", canonicalSurface: wplTeamUrl(slug) }, wplTeamUrl(slug));
+    return notFound(`No WPL franchise "${args.teamSlug}". Available: ${available.join(", ")}`, wplTeamUrl(slug));
+  }
+  return ok({ slug: t.slug, name: t.name, seasons: t.seasons, firstSeason: t.firstSeason, lastSeason: t.lastSeason, matchCount: t.matchCount, attribution: "Cricsheet CC BY 3.0" }, wplTeamUrl(t.slug));
+}
+function handleT20wcDatasetSummary() {
+  const league = t20wcLeague();
+  if (!league || league.totalMatches === 0) {
+    return ok({ note: "T20 WC snapshot not yet bundled in this release. Full coverage available at the canonical URL.", canonicalSurface: T20WC_HUB }, T20WC_HUB);
+  }
+  return ok({
+    league: "ICC T20 World Cup",
+    editions: league.seasons,
+    totalMatches: league.totalMatches,
+    teams: league.teams.length,
+    players: league.playerCount,
+    leaderboardAspects: league.leaderboardAspects.map((a) => a.slug),
+    attribution: "Cricsheet CC BY 3.0 \u2014 https://cricsheet.org",
+    note: "Covers men's ICC T20 World Cup only. Not women's T20 WC or bilateral T20I series.",
+    canonicalSurface: T20WC_HUB
+  }, T20WC_HUB);
+}
+function handleT20wcLeaderboard(args) {
+  const limit = Math.max(1, Math.min(100, args.limit ?? 20));
+  const lb = t20wcLeaderboards();
+  const entry = lb[args.aspect];
+  if (!entry) {
+    const available = Object.keys(lb);
+    if (available.length === 0) return ok({ note: "T20 WC leaderboard snapshot not yet bundled in this release.", canonicalSurface: t20wcLeaderboardUrl(args.aspect) }, t20wcLeaderboardUrl(args.aspect));
+    return ok({ error: "unknown_aspect", aspect: args.aspect, available }, t20wcLeaderboardUrl(args.aspect));
+  }
+  const rows = entry.rows.slice(0, limit);
+  return ok({ aspect: args.aspect, title: entry.title, editions: "all (2013/14\u20132025/26)", floorNote: entry.floorNote ?? null, count: rows.length, rows, attribution: "Cricsheet CC BY 3.0" }, t20wcLeaderboardUrl(args.aspect));
+}
+function handleT20wcTeamStats(args) {
+  const slug = args.teamSlug.toLowerCase().replace(/\s+/g, "-");
+  const t = t20wcTeams().find((x) => x.slug === slug || x.slug.includes(slug) || slug.includes(x.slug));
+  if (!t) {
+    const available = t20wcTeams().map((x) => x.slug);
+    if (available.length === 0) return ok({ note: "T20 WC team snapshot not yet bundled in this release.", canonicalSurface: t20wcTeamUrl(slug) }, t20wcTeamUrl(slug));
+    return notFound(`No T20 WC team "${args.teamSlug}". Available: ${available.join(", ")}`, t20wcTeamUrl(slug));
+  }
+  return ok({ slug: t.slug, name: t.name, editions: t.seasons, firstEdition: t.firstSeason, lastEdition: t.lastSeason, matchCount: t.matchCount, attribution: "Cricsheet CC BY 3.0" }, t20wcTeamUrl(t.slug));
+}
+function handleCrossLeagueLeaders(args) {
+  const limit = Math.max(1, Math.min(50, args.limit ?? 20));
+  const aspectMap = {
+    runs: "orange-cap",
+    wickets: "purple-cap",
+    sixes: "most-sixes",
+    fours: "most-fours",
+    economy: "economy-leaders"
+  };
+  const aspect = aspectMap[args.metric] ?? args.metric;
+  const ascending = args.metric === "economy";
+  const allRows = [];
+  const sources = [
+    { label: "MLC", lb: mlcLeaderboards() },
+    { label: "WPL", lb: wplLeaderboards() },
+    { label: "T20 WC", lb: t20wcLeaderboards() }
+  ];
+  for (const { label, lb } of sources) {
+    const entry = lb[aspect];
+    if (entry) {
+      for (const r of entry.rows) {
+        allRows.push({ slug: r.slug, fullName: r.fullName, league: label, metricValue: r.metricValue, formatted: r.formatted, teamSlugs: r.teamSlugs });
+      }
+    }
+  }
+  if (allRows.length === 0) {
+    return ok({ note: `No cross-league data available for metric "${args.metric}" yet. Snapshot files may not be bundled in this release.`, metric: args.metric, aspect }, `${SITE}/leagues`);
+  }
+  const ranked = allRows.sort((a, b) => ascending ? a.metricValue - b.metricValue : b.metricValue - a.metricValue).slice(0, limit).map((r, i) => ({ rank: i + 1, ...r, canonicalUrl: `${SITE}/players/${r.slug}` }));
+  return ok({ metric: args.metric, aspect, leaguesCovered: sources.map((s) => s.label), count: ranked.length, rows: ranked, note: "Cross-league rank. Same player may appear multiple times across leagues.", attribution: "Cricsheet CC BY 3.0 for MLC/WPL/T20WC; CricketStudio licensed feed for IPL 2026." }, `${SITE}/leagues`);
+}
+function handlePlayerAllLeagues(args) {
+  const slug = args.playerSlug.toLowerCase();
+  const result = { playerSlug: slug, leagues: [] };
+  const leaguesList = result.leagues;
+  const iplPlayer = players()[slug];
+  if (iplPlayer) {
+    leaguesList.push({ league: "IPL 2026", fullName: iplPlayer.fullName, team: iplPlayer.team, role: iplPlayer.role, claimCount: iplPlayer.claims.length, canonicalUrl: `${SITE}/players/${slug}` });
+  }
+  const mlcP = mlcPlayers()[slug];
+  if (mlcP) {
+    leaguesList.push({ league: "MLC (2023\u20132026)", fullName: mlcP.fullName, teams: mlcP.teamSlugs, batting: mlcP.batting, bowling: mlcP.bowling, canonicalUrl: mlcPlayerUrl(slug) });
+  }
+  const wplLb = wplLeaderboards();
+  const wplEntry = Object.values(wplLb).flatMap((lb) => lb.rows).find((r) => r.slug === slug);
+  if (wplEntry) {
+    leaguesList.push({ league: "WPL", fullName: wplEntry.fullName, canonicalUrl: `${WPL_HUB}/players/${slug}` });
+  }
+  const t20wcLb = t20wcLeaderboards();
+  const t20wcEntry = Object.values(t20wcLb).flatMap((lb) => lb.rows).find((r) => r.slug === slug);
+  if (t20wcEntry) {
+    leaguesList.push({ league: "T20 WC", fullName: t20wcEntry.fullName, canonicalUrl: `${T20WC_HUB}/players/${slug}` });
+  }
+  if (leaguesList.length === 0) {
+    return notFound(`No data for "${slug}" in any bundled league snapshot. Try search_players to confirm the slug.`, `${SITE}/players/${slug}`);
+  }
+  return ok({ playerSlug: slug, leagueCount: leaguesList.length, leagues: leaguesList, note: "Covers leagues present in the bundled snapshot. Use search_players to find the canonical slug." }, `${SITE}/players/${slug}`);
+}
+function handleWomenCricketLeaders(args) {
+  const limit = Math.max(1, Math.min(100, args.limit ?? 20));
+  const lb = wplLeaderboards();
+  const entry = lb[args.aspect];
+  if (!entry) {
+    const available = Object.keys(lb);
+    if (available.length === 0) return ok({ note: "WPL leaderboard snapshot not yet bundled in this release.", gender: "female", canonicalSurface: wplLeaderboardUrl(args.aspect) }, wplLeaderboardUrl(args.aspect));
+    return ok({ error: "unknown_aspect", aspect: args.aspect, gender: "female", available }, wplLeaderboardUrl(args.aspect));
+  }
+  const rows = entry.rows.slice(0, limit);
+  return ok({ aspect: args.aspect, title: entry.title, gender: "female", competition: "WPL (Women's Premier League)", floorNote: entry.floorNote ?? null, count: rows.length, rows, attribution: "Cricsheet CC BY 3.0" }, wplLeaderboardUrl(args.aspect));
+}
 var server = new Server(
-  { name: "cricketstudio", version: "1.1.0" },
+  { name: "cricketstudio", version: "1.4.0" },
   { capabilities: { tools: {} } }
 );
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
 server.setRequestHandler(CallToolRequestSchema, async (req) => {
   const { name, arguments: rawArgs } = req.params;
   const v = validators[name];
-  if (!v) return ok({ error: "unknown_tool", tool: name, hint: "Call tools/list for the full 29-tool catalog." });
+  if (!v) return ok({ error: "unknown_tool", tool: name, hint: "Call tools/list for the full 43-tool catalog." });
   const parsed = v.safeParse(rawArgs ?? {});
   if (!parsed.success) return ok({ error: "invalid_arguments", tool: name, issues: parsed.error.issues });
   const args = parsed.data;
@@ -1568,12 +1989,37 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         return handleListMlcLeaderboards(args);
       case "get_ipl_leaderboard":
         return handleIplLeaderboard(args);
+      case "list_research_reports":
+        return handleListResearchReports(args);
+      case "get_research_report":
+        return handleGetResearchReport(args);
       case "get_related_entities":
         return handleGetRelatedEntities(args);
       case "get_player_connections":
         return handleGetPlayerConnections(args);
       case "get_graph_path":
         return handleGetGraphPath(args);
+      // WPL
+      case "get_wpl_dataset_summary":
+        return handleWplDatasetSummary();
+      case "get_wpl_leaderboard":
+        return handleWplLeaderboard(args);
+      case "get_wpl_team_profile":
+        return handleWplTeamProfile(args);
+      // T20 WC
+      case "get_t20wc_dataset_summary":
+        return handleT20wcDatasetSummary();
+      case "get_t20wc_leaderboard":
+        return handleT20wcLeaderboard(args);
+      case "get_t20wc_team_stats":
+        return handleT20wcTeamStats(args);
+      // Cross-league
+      case "get_cross_league_leaders":
+        return handleCrossLeagueLeaders(args);
+      case "get_player_all_leagues":
+        return handlePlayerAllLeagues(args);
+      case "get_women_cricket_leaders":
+        return handleWomenCricketLeaders(args);
       default:
         return ok({ error: "unknown_tool", tool: name });
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cricketstudio-mcp",
-  "version": "1.2.0",
-  "description": "CricketStudio MCP server — 32 tools (incl. an L3 knowledge-graph layer) for IPL 2026, IPL historical (18 seasons), and Major League Cricket data. Citation-grade atomic claims with provenance.",
+  "version": "1.4.0",
+  "description": "CricketStudio MCP server — 43 tools covering IPL 2026, IPL historical (18 seasons), MLC, WPL, and ICC T20 WC. Citation-grade atomic claims with provenance. Includes L3 knowledge-graph layer.",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -22,6 +22,9 @@
     "ipl-2026",
     "ipl-historical",
     "mlc",
+    "wpl",
+    "t20wc",
+    "women-cricket",
     "cricketstudio",
     "claude",
     "model-context-protocol"