CricketStudio MCP

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](https://okf.cricketstudio.ai/evals/leaderboard)).

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)

Major League Cricket (8 tools)

WPL — Women's Premier League (5 tools)

ICC T20 World Cup (5 tools)

BBL — Big Bash League (5 tools)

PSL — Pakistan Super League (5 tools)

Cross-league (3 tools)

IPL Career / Historical (1 tool)

Research (2 tools)

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

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

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 re