cricketstudio-mcp

cricketstudio-mcp

Citation infrastructure for cricket — 57 MCP tools (incl. a knowledge-graph layer), zero network calls, 2,654 matches, 623,535 deliveries.

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.

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:

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