Skip to main content
Glama
CricketStudio MCP

CricketStudio MCP

by i-m-arul

cricketstudio-mcp

npm version License: MIT Data: CC BY 4.0

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-mcp

Any 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

get_dataset_summary

Top-level corpus overview: seasons, matches, players, deliveries

/

search_players

Player discovery by name or team

n/a

get_player_profile

Headline stats across all five pillars (P1–P5)

/players/{slug}

get_player_pillar

Claims from a specific pillar (P1 recaps, P2 moments, P3 form, P4 season, P5 notebook)

/players/{slug} filtered

list_atomic_claims

Filtered query across all ClaimReview entries

various

compare_players

Side-by-side stat comparison for two or more players

/compare/players?slugs=…

get_team_profile

Team headline stats and season summary

/teams/{slug}

get_team_h2h

Head-to-head record between two franchises

/teams/{a}/vs/{b}

get_venue_hub

Aggregated venue patterns: par scores, toss impact, phase splits

/venues/{slug}

get_standings

IPL 2026 points table with NRR

/standings

get_trend

A single trend insight with full claim set

/trends/{id}

list_trends

Browse trends by category (conditional, momentum, venue, toss, anomaly)

/trends

get_player_h2h

Batter vs bowler matchup record

/h2h/{batter}-vs-{bowler}

get_season_stats

Season leaderboard for a given aspect (runs, wickets, strike rate, economy, …)

/season/ipl-2026/{aspect}

get_fielding_stats

Catches, run-outs, and fielding contributions for a player or the full season

/players/{slug} · /season/ipl-2026/catches

get_partnerships

Partnership records for a match or player pair

/matches/{id}

get_dismissal_analysis

Dismissal mode breakdown for a batter or bowler

/players/{slug}

list_fixtures

Full schedule with match status, venue, and result

/matches

get_match_state

Live or final scorecard with ball-by-ball state

/matches/{fixture-id}

get_match_recap

Atomic claim set for a completed match

/matches/{fixture-id}

Major League Cricket (8 tools)

Tool

What it returns

Maps to URL

get_mlc_dataset_summary

MLC corpus overview: seasons, matches, players, deliveries

/leagues/mlc

search_mlc_players

Player discovery within the MLC corpus

/leagues/mlc/players

get_mlc_player_profile

MLC career and season stats for a player

/leagues/mlc/players/{slug}

get_mlc_team_profile

Franchise profile and season history

/leagues/mlc/teams/{slug}

get_mlc_match

Match scorecard and key claims

/leagues/mlc/matches/{id}

get_mlc_match_claim

A single typed claim for an MLC match (top scorer, best figures, etc.)

/leagues/mlc/matches/{id}/c/{kind}

list_mlc_matches

All MLC matches with status and results

/leagues/mlc/matches

list_mlc_leaderboards

Season or all-time leaderboard for a given MLC aspect

/leagues/mlc/leaderboards/{aspect}

WPL — Women's Premier League (5 tools)

Tool

What it returns

Maps to URL

get_wpl_dataset_summary

WPL corpus overview: seasons, matches, players, deliveries (2022/23–2025/26)

/leagues/wpl

search_wpl_players

Player discovery within the WPL corpus

/leagues/wpl/players

get_wpl_player_profile

WPL career and season stats for a player

/leagues/wpl/players/{slug}

get_wpl_leaderboard

Season or all-time leaderboard for any WPL aspect (runs, wickets, economy, …)

/leagues/wpl/leaderboards/{aspect}

get_wpl_team_profile

Franchise profile, season record, and squad stats

/leagues/wpl/teams/{slug}

ICC T20 World Cup (5 tools)

Tool

What it returns

Maps to URL

get_t20wc_dataset_summary

T20 WC corpus overview: editions, matches, players, deliveries (2013/14–2025/26)

/leagues/t20wc

search_t20wc_players

Player discovery within the T20 WC corpus

/leagues/t20wc/players

get_t20wc_player_profile

T20 WC career stats for a player across all editions

/leagues/t20wc/players/{slug}

get_t20wc_leaderboard

All-edition leaderboard for any T20 WC aspect

/leagues/t20wc/leaderboards/{aspect}

get_t20wc_team_stats

National team career record across all T20 WC editions

/leagues/t20wc/teams/{slug}

BBL — Big Bash League (5 tools)

Tool

What it returns

Maps to URL

get_bbl_dataset_summary

BBL corpus overview: seasons, matches, players, deliveries (2011/12–2025/26)

/leagues/bbl

search_bbl_players

Player discovery within the BBL corpus

/leagues/bbl/players

get_bbl_player_profile

BBL career and season stats for a player

/leagues/bbl/players/{slug}

get_bbl_leaderboard

Season or all-time leaderboard for any BBL aspect (runs, wickets, economy, sixes, …)

/leagues/bbl/leaderboards/{aspect}

get_bbl_team_profile

Franchise profile, season history, and career stats

/leagues/bbl/teams/{slug}

PSL — Pakistan Super League (5 tools)

Tool

What it returns

Maps to URL

get_psl_dataset_summary

PSL corpus overview: seasons, matches, players, deliveries (2016–2026)

/leagues/psl

search_psl_players

Player discovery within the PSL corpus

/leagues/psl/players

get_psl_player_profile

PSL career and season stats for a player

/leagues/psl/players/{slug}

get_psl_leaderboard

Season or all-time leaderboard for any PSL aspect (runs, wickets, economy, sixes, …)

/leagues/psl/leaderboards/{aspect}

get_psl_team_profile

Franchise profile, season history, and career stats

/leagues/psl/teams/{slug}

Cross-league (3 tools)

Tool

What it returns

Maps to URL

get_cross_league_leaders

Top performers on a metric (runs, wickets, economy, sixes, fours) across MLC, T20 WC, BBL, and PSL

n/a

get_player_all_leagues

A player's stats across every league in the corpus (IPL, MLC, WPL, T20 WC, BBL, PSL)

/players/{slug}

get_women_cricket_leaders

WPL leaderboard with gender context — top women's T20 performers

/leagues/wpl/leaderboards/{aspect}

IPL Career / Historical (1 tool)

Tool

What it returns

Maps to URL

get_ipl_leaderboard

All-time IPL leaderboard for any aspect across 18 seasons (2007/08–2025) — runs, wickets, sixes, centuries, economy, and more

/leagues/ipl/leaderboards/{aspect}

Research (2 tools)

Tool

What it returns

Maps to URL

list_research_reports

Index of all published data investigations (venue, rivalry, strategy, era, cross-league, season)

/stories

get_research_report

A single focused report with one question, one dataset, one citable answer

/stories/{slug}

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

get_related_entities

Entities connected to a player or franchise, by edge type and direction

/players/{slug} · /teams/{slug}

get_player_connections

A player's franchise + most-faced bowlers + bowlers who dismissed them most, in one call

/players/{slug}

get_graph_path

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:

  1. Sample-size floors — ≥30 batting balls, ≥15 bowling deliveries, ≥3 venue fixtures, ≥5 H2H deliveries, ≥3 matches for trends. Disclosed publicly on every page.

  2. Explicit date windows — every claim specifies its window (ipl-2026, ipl-career, last-N-matches). No "all-time" labels without a defined window.

  3. Provenance to ball-by-ball — every numeric claim traces to a specific match, delivery count, and computation timestamp.

  4. Atomic claim format — under 30 words, structured as [Subject] [metric] [value] [comparator] [period].

  5. 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 tsx

Smoke-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 smoke

Building 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 LICENSE

  • Data: CC BY 4.0 — free to cite with attribution to CricketStudio (https://players.cricketstudio.ai). Attribution flows automatically via the canonicalUrl field 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 tools
compare_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.

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

    A4.1/5.0

    Scored across 57 tools

    Disambiguation5/5

    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).

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • F
      license
      Not graded
      quality
      B
      maintenance
      An 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
      -
    • A
      license
      A
      quality
      B
      maintenance
      48 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.
      46
      24 PyPI
      10
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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