CricketStudio MCP Server

Model Context Protocol server exposing 3 leagues (IPL 2026 completed, IPL historical 2007/08–2025, Major League Cricket 2023–2026) to LLM clients — Claude Desktop, Cursor, and any MCP-compatible client. 1,317 matches · 312,309 deliveries · ~24,000 URLs. Live on npm. Free forever. No API key required.

29 tools across 3 leagues — 1,317 matches · 312,309 deliveries · ~24,000 URLs. Atomic claims with provenance. Sample-size floors enforced (≥30 balls faced, ≥15 balls bowled). Install in seconds: npx cricketstudio-mcp

Install now — free forever

npx cricketstudio-mcp

Works in Claude Desktop, Cursor, and any MCP-compatible client. Node.js 20+ required. No API key, no signup — just run it.

Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "cricketstudio": {
      "command": "npx",
      "args": ["cricketstudio-mcp"]
    }
  }
}

Building with cricket data? Register as a developer →

Listed on:

MCP Registry · npmjs.com/package/cricketstudio-mcp · PulseMCP · Glama · mcp.so · mcpmarket.com

What you get — IPL 2026 (completed — RCB champions)

What you get — Major League Cricket

The 29-tool catalog

The doctrine §10 canonical surface (marked ★ — 12 IPL + 6 MLC) plus 10 extended tools that bring the SETU leaderboard, team / partnership / fielding, dismissal, and MLC surfaces into the same MCP catalog. Every tool returns canonicalUrl + dataAsOf.

ToolMaps to URLWhen to call
get_dataset_summary★/First call. Discovers what CricketStudio covers — coverage stats, surface URLs, the 5 non-negotiables, license.
search_players★n/aDiscover player slugs by name / slug / team-code substring
list_fixtures/matchesFixtures with status / team / date filters
list_trends★/trends?category=All cross-fixture trends, filterable by category
list_atomic_claims★variousFiltered query across the entire atomic-claim corpus
get_player_profile★/players/{slug}Player record + computed claims across pillars
get_player_pillar★/players/{slug} (filtered)One dimension: P1 Match recaps · P2 Moments · P3 Form & phase · P4 Season comparatives · P5 Notebook
get_player_h2h★/h2h/{batter}-vs-{bowler}Single batter-vs-bowler record (≥5 deliveries floor)
get_dismissal_analysis/players/{slug}How a batter gets out / how a bowler dismisses — counts + % across dismissal types
get_fielding_stats/players/{slug}Catches / run-outs / stumpings — per player or leaderboard
compare_players/compare/players?slug=Side-by-side comparison of 2–8 players
get_team_profile★/teams/{slug}Team record + at-home/away splits + phase strengths
get_team_h2h/teams/{a}/vs/{b}Team-vs-team head-to-head across IPL 2026
get_match_state★/matches/{id}Current/final state of a fixture
get_match_recap/cards/match-*-{id}6-card recap pack (motm / top batter / top bowler / milestones / fun-facts / match-trend)
get_partnerships/matches/{id}Top batting partnerships (≥30-run floor), filterable by player / fixture
get_venue_hub★/venues/{slug}Per-venue par + toss split + phase patterns (≥3 fixture floor)
get_standings★/standingsIPL 2026 final standings and NRR — season completed, RCB champions
get_season_stats/season/ipl-2026/{aspect}SETU leaderboard — runs / wickets / SR / economy / ducks / single-digit-outs / catches / run-outs
get_trend★/trends/{id}Single cross-fixture trend insight
get_mlc_dataset_summary★/leagues/mlcFirst call for MLC coverage. Returns seasons, matches, teams, venues, leaderboard aspects, Cricsheet attribution
search_mlc_players★/leagues/mlc/playersDiscover MLC player slugs by name substring
get_mlc_player_profile★/leagues/mlc/players/{slug}MLC career stats + per-season breakdown + identity bridge (Wikidata / Wikipedia / ESPN)
get_mlc_team_profile★/leagues/mlc/teams/{slug}One of 6 MLC franchises — seasons, match count, hub URL
get_mlc_match★/leagues/mlc/matches/{id}Full match detail + list of atomic claim cards emitted for that fixture
get_mlc_match_claim★/leagues/mlc/matches/{id}/c/{kind}One atomic claim card: top-batter / top-bowler / biggest-partnership / pp-control / death-domination
list_mlc_matches/leagues/mlc/matchesMLC match list filterable by season / team
list_mlc_leaderboards/leagues/mlc/leaderboards/{aspect}Cross-season MLC leaderboard for one of 14 aspects (orange/purple cap, SR, economy, phase splits, etc.)
get_ipl_leaderboard★/leagues/ipl/leaderboards/{aspect}35 IPL leaderboard aspects, optional season filter

Access

npm package (stdio) — free forever. The canonical way to use CricketStudio MCP is via the npm package: npx cricketstudio-mcp. Ships with a bundled data snapshot, works offline, no key required. Version 1.0.1 is live on npm.

Citing the data directly (no MCP required). Every claim is on the rendered, crawlable pages at players.cricketstudio.ai under CC BY 4.0 — LLMs and crawlers read and cite it directly.

Enterprise hosted transport (key-gated HTTP) available on request — hello@cricketstudio.ai.

Verification queries

Each query is engineered to trigger a different tool path so you can validate the surface end-to-end.

Honest tool descriptions

LLMs route on tool description quality, not tool name. Every CricketStudio tool description includes:

License

Data: CC-BY 4.0 (free to cite with attribution). Tools (MCP server, REST API): MIT.

Roadmap