CricketStudio MCP
CricketStudio MCP is an offline, citable cricket data server that lets MCP-compatible AI clients answer structured cricket questions across 7 leagues with no network calls, API keys, or rate limits.
Query the complete IPL 2026 season: standings, fixtures, match state, recaps, player and team profiles, venue hubs, trends, and season leaderboards.
Explore historical IPL data across 18 seasons via all-time leaderboards for runs, wickets, sixes, economy, centuries, and more.
Access MLC, WPL, ICC T20 World Cup, BBL, and PSL datasets with player profiles, team profiles, match details, and league-specific leaderboards.
Compare players side-by-side, get batter-vs-bowler head-to-head records, partnerships, dismissal patterns, fielding stats, and venue/trend insights.
Run cross-league queries to find top run-scorers, wicket-takers, six-hitters, and economy leaders across all covered leagues.
Browse and retrieve research reports with citable findings and provenance.
Use knowledge-graph tools to find player connections, related entities, and shortest paths between players or teams.
Every response includes a canonicalUrl, date window, sample-size count, and provenance trail for citable, verifiable answers.
cricketstudio-mcp
Citation infrastructure for cricket — 60 MCP tools across 7 leagues, zero network calls, 2,654 matches, 623,535 deliveries. LLM accuracy: 0% → 85% on compound cricket questions (benchmark).
What is this?
CricketStudio MCP is a Model Context Protocol 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.)
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.
Related MCP server: SportIQ
Installation
Claude Desktop
Add to your Claude Desktop config file and restart the app.
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"cricketstudio": {
"command": "npx",
"args": ["cricketstudio-mcp"]
}
}
}Other MCP clients
npx cricketstudio-mcpAny MCP client that supports the stdio transport can use this command directly. The server starts on stdin/stdout and requires Node 18 or later.
Tools
All 57 tools work fully against the bundled snapshot. Each response includes canonicalUrl, dataAsOf, and sampleSize.
IPL 2026 (20 tools)
Tool | What it returns | Maps to URL |
| Top-level corpus overview: seasons, matches, players, deliveries |
|
| Player discovery by name or team | n/a |
| Headline stats across all five pillars (P1–P5) |
|
| Claims from a specific pillar (P1 recaps, P2 moments, P3 form, P4 season, P5 notebook) |
|
| Filtered query across all ClaimReview entries | various |
| Side-by-side stat comparison for two or more players |
|
| Team headline stats and season summary |
|
| Head-to-head record between two franchises |
|
| Aggregated venue patterns: par scores, toss impact, phase splits |
|
| IPL 2026 points table with NRR |
|
| A single trend insight with full claim set |
|
| Browse trends by category (conditional, momentum, venue, toss, anomaly) |
|
| Batter vs bowler matchup record |
|
| Season leaderboard for a given aspect (runs, wickets, strike rate, economy, …) |
|
| Catches, run-outs, and fielding contributions for a player or the full season |
|
| Partnership records for a match or player pair |
|
| Dismissal mode breakdown for a batter or bowler |
|
| Full schedule with match status, venue, and result |
|
| Live or final scorecard with ball-by-ball state |
|
| Atomic claim set for a completed match |
|
Major League Cricket (8 tools)
Tool | What it returns | Maps to URL |
| MLC corpus overview: seasons, matches, players, deliveries |
|
| Player discovery within the MLC corpus |
|
| MLC career and season stats for a player |
|
| Franchise profile and season history |
|
| Match scorecard and key claims |
|
| A single typed claim for an MLC match (top scorer, best figures, etc.) |
|
| All MLC matches with status and results |
|
| Season or all-time leaderboard for a given MLC aspect |
|
WPL — Women's Premier League (5 tools)
Tool | What it returns | Maps to URL |
| WPL corpus overview: seasons, matches, players, deliveries (2022/23–2025/26) |
|
| Player discovery within the WPL corpus |
|
| WPL career and season stats for a player |
|
| Season or all-time leaderboard for any WPL aspect (runs, wickets, economy, …) |
|
| Franchise profile, season record, and squad stats |
|
ICC T20 World Cup (5 tools)
Tool | What it returns | Maps to URL |
| T20 WC corpus overview: editions, matches, players, deliveries (2013/14–2025/26) |
|
| Player discovery within the T20 WC corpus |
|
| T20 WC career stats for a player across all editions |
|
| All-edition leaderboard for any T20 WC aspect |
|
| National team career record across all T20 WC editions |
|
BBL — Big Bash League (5 tools)
Tool | What it returns | Maps to URL |
| BBL corpus overview: seasons, matches, players, deliveries (2011/12–2025/26) |
|
| Player discovery within the BBL corpus |
|
| BBL career and season stats for a player |
|
| Season or all-time leaderboard for any BBL aspect (runs, wickets, economy, sixes, …) |
|
| Franchise profile, season history, and career stats |
|
PSL — Pakistan Super League (5 tools)
Tool | What it returns | Maps to URL |
| PSL corpus overview: seasons, matches, players, deliveries (2016–2026) |
|
| Player discovery within the PSL corpus |
|
| PSL career and season stats for a player |
|
| Season or all-time leaderboard for any PSL aspect (runs, wickets, economy, sixes, …) |
|
| Franchise profile, season history, and career stats |
|
Cross-league (3 tools)
Tool | What it returns | Maps to URL |
| Top performers on a metric (runs, wickets, economy, sixes, fours) across MLC, T20 WC, BBL, and PSL | n/a |
| A player's stats across every league in the corpus (IPL, MLC, WPL, T20 WC, BBL, PSL) |
|
| WPL leaderboard with gender context — top women's T20 performers |
|
IPL Career / Historical (1 tool)
Tool | What it returns | Maps to URL |
| All-time IPL leaderboard for any aspect across 18 seasons (2007/08–2025) — runs, wickets, sixes, centuries, economy, and more |
|
Research (2 tools)
Tool | What it returns | Maps to URL |
| Index of all published data investigations (venue, rivalry, strategy, era, cross-league, season) |
|
| A single focused report with one question, one dataset, one citable answer |
|
Knowledge Graph (L3) (3 tools)
Slug-keyed traversal over CricketStudio's entity graph. Nodes are players and franchises; edges are plays_for (squad membership) and faced/dismissed_by (batter-vs-bowler matchups, mirroring the get_player_h2h pair set).
Tool | What it returns | Maps to URL |
| Entities connected to a player or franchise, by edge type and direction |
|
| A player's franchise + most-faced bowlers + bowlers who dismissed them most, in one call |
|
| Shortest connection (≤4 hops) between two entities, e.g. two players via a shared franchise | n/a |
Example queries
Once connected in Claude Desktop, you can ask questions like:
"Who won IPL 2026?"
"What did Kohli score in the final?"
"Who leads the all-time IPL sixes leaderboard?"
"Show me Vaibhav Suryavanshi's IPL 2026 stats"
"What's the RCB vs GT head-to-head record?"
"Which venues favour the team batting first in IPL 2026?"
"Who has the best death-over economy in MLC 2025?"
"List the top wicket-takers in IPL history"
"Who are the leading run-scorers in WPL history?"
"Which team has won the most T20 World Cups?"
"Who scores most sixes across WPL and T20 WC combined?"
"Show me Smriti Mandhana's stats across all leagues"
"Who leads the all-time BBL runs leaderboard?"
"Which BBL franchise has won the most titles?"
"Who are the top wicket-takers in PSL history?"
"Show me Babar Azam's PSL career stats"
"Compare David Warner's stats across IPL, BBL, and PSL"
Data
Source | Coverage | License |
Licensed feed | IPL 2026 ball-by-ball (complete season — RCB champions) | Proprietary |
Cricsheet | IPL historical, 18 seasons, 1,169 matches (2007/08–2025) | CC BY 3.0 |
Cricsheet | MLC 2023–2026, 75 matches | CC BY 3.0 |
Cricsheet | WPL 2022/23–2025/26, 88 matches, 133 players | CC BY 3.0 |
Cricsheet | ICC T20 World Cup, 6 editions, 230 matches, 687 players | CC BY 3.0 |
Cricsheet | BBL 2011/12–2025/26, 662 matches, 529 players | CC BY 3.0 |
Cricsheet | PSL 2016–2026, 357 matches, 458 players | CC BY 3.0 |
Total corpus: 2,654 matches · 623,535 ball-by-ball deliveries.
Sample-size floors (publicly disclosed):
Batting claims: ≥30 balls faced
Bowling claims: ≥15 deliveries
Venue claims: ≥3 fixtures at the venue
Trend claims: ≥3 matches forming the pattern
Claims that do not reach these floors are excluded — they are not suppressed with a placeholder, they are simply absent. This is the moat.
Update cadence: the bundled snapshot is refreshed after each CricketStudio data update. Every tool response includes dataAsOf so an LLM citing the answer can disclose freshness explicitly.
Data licence: the bundled data is released under CC BY 4.0. Every tool response includes a canonicalUrl back to players.cricketstudio.ai so attribution flows automatically when an LLM cites an answer.
About this package
This package bundles a pre-computed projection of CricketStudio's public data. Every number here is also readable on the rendered pages at players.cricketstudio.ai — no new information is exposed, only a different (offline, zero-network) access path.
Methodology
Every claim in this package is governed by five non-negotiables:
Sample-size floors — ≥30 batting balls, ≥15 bowling deliveries, ≥3 venue fixtures, ≥5 H2H deliveries, ≥3 matches for trends. Disclosed publicly on every page.
Explicit date windows — every claim specifies its window (
ipl-2026,ipl-career,last-N-matches). No "all-time" labels without a defined window.Provenance to ball-by-ball — every numeric claim traces to a specific match, delivery count, and computation timestamp.
Atomic claim format — under 30 words, structured as
[Subject] [metric] [value] [comparator] [period].Sub-4-hour freshness SLA — for IPL 2026 pages, time from match end to page update is under 4 hours at the 95th percentile.
Full methodology at https://players.cricketstudio.ai/about.
Local development
npm install
npm run typecheck # tsc --noEmit
npm start # stdio MCP server via tsxSmoke-test without an MCP client — spawns the server over stdio, drives it with JSON-RPC, and asserts every advertised tool returns a non-error payload with dataAsOf:
npm run smokeBuilding something?
Register at 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.
License
Code: MIT — see
LICENSEData: CC BY 4.0 — free to cite with attribution to CricketStudio (
https://players.cricketstudio.ai). Attribution flows automatically via thecanonicalUrlfield in every tool response.
Built by Arul Anand · Chennai & Frisco · cricket enthusiast and data engineer. Questions, bugs, or requests: open an issue or visit players.cricketstudio.ai/mcp.
Available Tools
57 toolscompare_playersA
Side-by-side comparison of 2–8 IPL 2026 players: team, role, claim count per pillar (P1–P5), headline claim. Returns a canonical /compare/players?slugs=… URL. Use search_players to resolve slugs first.
Inputs: playerSlugs (required).
get_bbl_dataset_summaryA
First call for BBL (KFC Big Bash League) coverage. Returns seasons covered (2011/12–2025/26), match count (662), team count, player count (529), leaderboard aspects, and Cricsheet CC BY 3.0 attribution. Use before other get_bbl_* tools. Covers the men's Big Bash League only (not WBBL women's competition).
Inputs: no named parameters.
get_bbl_leaderboardA
BBL (Big Bash 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_bbl_dataset_summary for the full aspect list. Sample-size floors enforced (≥30 balls faced, ≥15 balls bowled). Returns canonical URL at /leagues/bbl/leaderboards/{aspect}.
Inputs: aspect (required), limit, season.
get_bbl_player_profileA
A BBL player's career batting + bowling aggregates across all seasons, with phase splits (powerplay / middle / death). Big Bash League only. Kebab-case slug e.g. 'david-warner'. Use search_bbl_players first if you don't have the slug. Men's BBL only — do NOT use for WBBL.
Inputs: playerSlug (required).
get_bbl_team_profileA
One of the 8 BBL franchises. Returns franchise name, seasons played, match count, and canonical URL. Team slugs: sydney-sixers, melbourne-stars, brisbane-heat, perth-scorchers, sydney-thunder, adelaide-strikers, hobart-hurricanes, melbourne-renegades. Does NOT return IPL/PSL team data.
Inputs: teamSlug (required).
get_cross_league_leadersA
Top performers by one metric across all 7 CricketStudio leagues (IPL 2026, IPL historical, MLC, WPL, T20 WC, BBL, PSL). 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.
Inputs: metric (required), limit.
get_dataset_summaryA
First call. Returns what CricketStudio covers — leagues (IPL 2026, IPL historical 18 seasons, MLC 2023–2026), corpus counts, surface URLs, 5 non-negotiables (sample-size floors, date windows, provenance, atomic claims, 4hr SLA), license. Use to ground subsequent queries against the real catalog of available entities.
Inputs: no named parameters.
get_dismissal_analysisA
IPL 2026 dismissal pattern analysis for a batter — dismissed by pace vs spin, powerplay vs death, most frequent dismissal modes. Returns available snapshot data or canonical URL for the full breakdown.
Inputs: playerSlug (required).
get_fielding_statsA
IPL 2026 fielding: catches, run-out assists, total dismissals. Pass playerSlug for a single player, omit for the full leaderboard. Aggregated from the CricketStudio canonical snapshot.
Inputs: limit, playerSlug.
get_graph_pathA
Shortest connection (≤4 hops) between two cricket entities in the knowledge graph — 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".
Inputs: toSlug (required), fromSlug (required), maxDepth.
get_ipl_leaderboardA
IPL historical leaderboard from the 18-season Cricsheet corpus (2007/08–2025). 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}.
Inputs: aspect (required), limit, season.
get_match_recapA
Key performers and highlights for one finished IPL 2026 match — top batter, top bowler, MOTM, milestones. Use for: "Who won the MI vs RCB match?", "What happened in match 69635?". Use list_fixtures to discover matchIds.
Inputs: matchId (required).
get_match_stateA
Result, scoreboards, and status for one IPL 2026 match from the bundled snapshot. Returns home/away teams, innings totals, toss winner, and Man of the Match. Use list_fixtures to discover matchIds. Note: live ball-by-ball is at the canonical URL.
Inputs: matchId (required).
get_mlc_dataset_summaryA
First call for Major League Cricket (MLC) coverage. Returns seasons covered (2023–2026), corpus stats, surface URLs, 55 leaderboard aspects, and Cricsheet CC BY 3.0 attribution. MLC is distinct from IPL and lives under /leagues/mlc.
Inputs: no named parameters.
get_mlc_matchA
Full detail for one MLC match: teams, venue, toss, result, innings summary, officials, player of the match, plus available atomic claim cards. matchId is a Cricsheet id (e.g. "1381361"). Use list_mlc_matches to discover ids.
Inputs: matchId (required).
get_mlc_match_claimA
One atomic claim card from an MLC match. Kinds: top-batter, top-bowler, biggest-partnership, pp-control, death-domination. Permanent citable URL at /leagues/mlc/matches/{id}/c/{kind}. Sample-size floors enforced.
Inputs: kind (required), matchId (required).
get_mlc_player_profileA
MLC player career profile: batting + bowling aggregates, per-season breakdown, identity bridge (Wikidata / ESPNcricinfo). Slug is kebab-case e.g. f-du-plessis. Use search_mlc_players to discover slugs.
Inputs: playerSlug (required).
get_mlc_team_profileA
One of 6 MLC franchises: los-angeles-knight-riders, mi-new-york, san-francisco-unicorns, seattle-orcas, texas-super-kings, washington-freedom. Returns seasons, match count, and hub URL.
Inputs: teamSlug (required).
get_partnershipsB
Partnership stats for an IPL 2026 player — top stand partners, average partnership runs, most productive wicket-stand. Returns available data from the snapshot or redirects to the canonical player page for the full view.
Inputs: playerSlug (required).
get_player_all_leaguesA
A player's statistics across every CricketStudio league they appear in — IPL 2026, IPL historical, MLC, WPL, T20 WC, BBL, PSL — in one call. Use for players who appear in multiple leagues (e.g. internationals in BBL + IPL, PSL + T20WC). Returns a per-league stats block with canonicalUrl for each. Gracefully omits leagues the player doesn't appear in.
Inputs: playerSlug (required).
get_player_connectionsA
A player's graph neighbourhood in one call: their franchise (plays_for), most-faced bowlers (by deliveries), and the bowlers who dismissed them most — each with canonical URLs + aggregate counts. Use for "who are Kohli's toughest bowlers", "which team does Kohli play for". Returns aggregates, not ball-by-ball. Matchup edges mirror the get_player_h2h pair set, so not every opponent appears.
Inputs: playerSlug (required), limit.
get_player_h2hA
Batter-vs-bowler head-to-head record in IPL 2026. Sample-size floor: ≥5 deliveries faced. Returns deliveries, runs, SR, dismissals, and canonical URL. Both slugs are kebab-case.
Inputs: batterSlug (required), bowlerSlug (required).
get_player_pillarA
One content pillar for an IPL 2026 player. P1=Match recaps, P2=Moments/milestones, P3=Form & phase (powerplay/middle/death), P4=Season comparatives, P5=Notebook/narrative. Use for: "How is Bumrah bowling at the death?" → P3. "What are Kohli's best moments?" → P2.
Inputs: pillar (required), playerSlug (required).
get_player_profileA
Full IPL 2026 player profile + all computed claims across pillars P1–P5. Each claim carries sample size, period, provenance. Use for: "How is Bumrah performing?", "What are Kohli's IPL 2026 stats?". Player slugs are kebab-case (jasprit-bumrah). Use search_players first if you need the slug.
Inputs: playerSlug (required).
get_psl_dataset_summaryA
First call for PSL (HBL Pakistan Super League) coverage. Returns seasons covered (2015/16–2025/26), match count (357), team count, player count (458), leaderboard aspects, and Cricsheet CC BY 3.0 attribution. Use before other get_psl_* tools. Covers the men's Pakistan Super League only.
Inputs: no named parameters.
get_psl_leaderboardA
PSL (Pakistan Super 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_psl_dataset_summary for the full aspect list. Sample-size floors enforced (≥30 balls faced, ≥15 balls bowled). Returns canonical URL at /leagues/psl/leaderboards/{aspect}.
Inputs: aspect (required), limit, season.
get_psl_player_profileA
A PSL player's career batting + bowling aggregates across all seasons, with phase splits (powerplay / middle / death). Pakistan Super League only. Kebab-case slug e.g. 'babar-azam'. Use search_psl_players first if you don't have the slug.
Inputs: playerSlug (required).
get_psl_team_profileA
One of the PSL franchises. Returns franchise name, seasons played, match count, and canonical URL. Team slugs include: karachi-kings, lahore-qalandars, islamabad-united, peshawar-zalmi, quetta-gladiators, multan-sultans. Does NOT return BBL/IPL team data.
Inputs: teamSlug (required).
get_research_reportA
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 — each is ≤30 words. The canonical URL carries the full computed dataset with all numeric claims and JSON-LD.
Inputs: reportId (required).
get_season_statsA
IPL 2026 season leaderboard from CricketStudio canonical aggregate. sortBy: runs, wickets, strike_rate, economy, ducks, single_digit_outs, catches, run_outs. Optional teamCode filter. Sample-size floors apply (≥30 balls faced for SR, ≥15 balls bowled for economy).
Inputs: sortBy (required), limit, teamCode.
get_standingsA
IPL 2026 final standings. RCB are champions. All 10 teams with Points/Won/Lost/NRR. Returns canonical URL — the live standings page refreshes within the 4-hour SLA; cite the URL for current data.
Inputs: no named parameters.
get_t20wc_dataset_summaryA
First call for ICC T20 World Cup coverage. Returns editions covered (6 editions, 2013/14–2025/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).
Inputs: no named parameters.
get_t20wc_leaderboardA
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–2025/26). Sample-size floors enforced. Returns canonical URL at /leagues/t20wc/leaderboards/{aspect}.
Inputs: aspect (required), limit.
get_t20wc_player_profileA
A player's ICC Men's T20 World Cup career profile: batting + bowling aggregates, per-edition breakdown, phase splits. Kebab-case slug e.g. 'v-kohli'. Use search_t20wc_players first if you don't have the slug. Men's tournament only — do NOT mix with WPL.
Inputs: playerSlug (required).
get_t20wc_team_statsA
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.
Inputs: teamSlug (required).
get_team_h2hA
Team-vs-team head-to-head record across IPL 2026: matches, wins each way, no-results, recent meetings. Pass slugs in any order (mi, csk, rcb, srh, kkr, dc, pbks, rr, lsg, gt). Returns atomic lead claim + canonical URL.
Inputs: teamSlugA (required), teamSlugB (required).
get_team_profileA
IPL 2026 team metadata + canonical URL for the full server-rendered profile (record, at-home/away splits, phase strengths). Slugs: mi, csk, rcb, srh, kkr, dc, pbks, rr, lsg, gt.
Inputs: teamSlug (required).
get_trendA
One cross-fixture trend insight by stable id. Each trend carries bigStat, hook, and supporting numbers[]. Use list_trends to discover ids.
Inputs: trendId (required).
get_venue_hubA
Venue metadata + canonical URL for the full hub page (par 1st-innings score, toss-decision split, phase scoring patterns, recent matches). Sample-size floor: ≥3 fixtures. Use list_fixtures to find venue slugs.
Inputs: venueSlug (required).
get_women_cricket_leadersA
WPL (Women's Premier League) leaderboard — 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.
Inputs: aspect (required), limit.
get_wpl_dataset_summaryA
First call for WPL (Women's Premier League) coverage. Returns seasons covered (2022/23–2025/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.
Inputs: no named parameters.
get_wpl_leaderboardA
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 (≥30 balls faced, ≥15 balls bowled).
Inputs: aspect (required), limit, season.
get_wpl_player_profileA
A WPL player's career batting + bowling aggregates across all seasons, with phase splits (powerplay / middle / death). Women's Premier League only. Kebab-case slug e.g. 'smriti-mandhana'. Use search_wpl_players first if you don't have the slug. Do NOT use for men's cricket.
Inputs: playerSlug (required).
get_wpl_team_profileA
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.
Inputs: teamSlug (required).
list_atomic_claimsA
Filtered query across the full IPL 2026 atomic-claim corpus. Each claim is a single-sentence retrieval target with provenance, sample size, and canonicalUrl. Answers: "What are RCB's best claims this season?", "Show me Bumrah's P3 claims". Filter by player name, team code, or pillar.
Inputs: team, limit, pillar, player.
list_fixturesA
All 74 IPL 2026 fixtures with optional status/team filter. Returns id, date, home, away, venue, result. Use to discover matchIds for get_match_state and get_match_recap.
Inputs: team, limit, status.
list_mlc_leaderboardsA
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.
Inputs: aspect (required), limit.
list_mlc_matchesA
List MLC matches, optionally filtered by season (2023/2024/2025) or team slug. Returns id, date, teams, venue, result, canonicalUrl per row. Use to discover matchIds for get_mlc_match.
Inputs: limit, season, teamSlug.
list_research_reportsA
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 · IPL (state-of-ipl-2026, toss-effect, death-overs) and Series 2 · MLC (state-of-mlc-2025).
Inputs: series.
list_trendsA
All IPL 2026 cross-fixture trends, optionally filtered by kind: conditional, momentum, venue, toss, anomaly. Returns id + kind + hook + canonicalUrl per row.
Inputs: kind, limit.
search_bbl_playersA
Find BBL player slugs by substring match against full name or slug. Big Bash League only (529 players across 2011/12–2025/26, 15 seasons). Example: 'david warner' → 'david-warner'. Use before get_bbl_player_profile. NOT for PSL/IPL/MLC players.
Inputs: query (required), limit.
search_mlc_playersA
Find MLC player slugs by substring match against name or slug. Cricsheet uses initials format ("F du Plessis" → f-du-plessis). Use before get_mlc_player_profile.
Inputs: query (required), limit.
search_playersA
Find IPL 2026 player slugs by substring match against name, slug, or team. Case-insensitive. Returns slug + fullName + team + role. Use before get_player_profile when you have a name but not a slug.
Inputs: query (required), limit.
search_psl_playersA
Find PSL player slugs by substring match against full name or slug. Pakistan Super League only (458 players across 2015/16–2025/26, 10 seasons). Example: 'babar azam' → 'babar-azam'. Use before get_psl_player_profile. NOT for BBL/IPL/MLC players.
Inputs: query (required), limit.
search_t20wc_playersA
Find ICC Men's T20 World Cup player slugs by substring match. Multi-nation tournament: 693 players across 6 editions (2013/14–2025/26). Example: 'virat kohli' → 'v-kohli'. Use before get_t20wc_player_profile. NOT for WPL (women's) players.
Inputs: query (required), limit.
search_wpl_playersA
Find WPL player slugs by substring match against full name or slug. Women's Premier League only (133 players across 2022/23–2025/26). Example: 'smriti mandhana' → 'smriti-mandhana'. Use before get_wpl_player_profile. NOT for IPL/MLC/T20WC players.
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 57 tools
Each tool targets a specific league and entity type, with clearly differentiated purposes. For example, get_bbl_player_profile and get_ipl_player_profile are distinguished by the league prefix, and search tools are league-specific. Overlaps are minimal and intentional (e.g., get_women_cricket_leaders vs get_wpl_leaderboard).
All tools follow a consistent verb_noun pattern with league prefixes (e.g., get_bbl_*, list_mlc_*, search_psl_*). Verbs are limited to get, list, and search, making the pattern predictable and easy to navigate.
57 tools is high, but each serves a distinct purpose across 7 different leagues plus cross-league tools. The count is appropriate for the breadth of data covered, though some consolidation could reduce redundancy without sacrificing clarity.
The tool surface covers essential CRUD-like operations (profiles, leaderboards, match details, search) for each league, plus cross-league and knowledge graph tools. Dataset summaries and league-specific searches ensure no dead ends. Minor gaps like missing update/delete are expected for a read-only data server.
Related MCP Connectors
MCP tools for FIFA World Cup 2026 football, Formula 1, and IPL cricket — sims, strategy, fantasy.
Cricket MCP — wraps CricAPI (api.cricapi.com) for live cricket data.
236 MCP tools free (rate-limited): token safety, OCR, DNS, 228 x402 routes. No key.
AI-driven DFS lineup optimizer for MLB & NBA — build FanDuel & DraftKings lineups via MCP.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceAn MCP server that enables natural language querying of over 10 million ball-by-ball cricket deliveries stored in a local DuckDB database. It provides 26 tools for analyzing player matchups, situational stats, and historical records across all major cricket formats and tournaments.3-
- AlicenseAqualityBmaintenance48 AI-callable tools for FIFA World Cup 2026 football, Formula 1, and IPL cricket — Monte-Carlo bracket simulations, F1 pit-strategy modeling, and a Dream11 ILP optimizer, plus live odds and value-bet detection. Free, open-source, and works with any MCP client via uvx.4624 PyPI10MIT
- FlicenseNot gradedqualityDmaintenanceEnables cricket analytics via natural language, including player stats, team performance, match results, comparisons, and news, powered by OpenAI and MCP.-
- AlicenseNot gradedqualityBmaintenanceEnables plain-language cricket analytics for MCP clients, including calibrated win probability, ball-by-ball match archives, career and matchup records, venue and phase stats, and live scores, all without an API key.BSD 3-Clause