CricketStudio MCP Server

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)

• 256 player profiles with pillared atomic claims (P1-P5)
• 1,487 head-to-head pairs (≥5 deliveries faced floor)
• 53 venue hubs with par scores + toss-decision splits + phase patterns
• 14 record types (highest individual score, fastest fifty/century, biggest partnership, etc.)
• 10 teams with at-home / away splits + phase strengths + 90-page H2H grid
• Captain conditional pages (Template 10 — captain × condition combos)
• 141+ cross-fixture trends (conditional / momentum / venue / toss / anomaly)
• 74 completed matches with full match state · live-feed sourced · sub-4-hour SLA maintained throughout the season

What you get — Major League Cricket

• 167 player profiles across 2023/2024/2025 seasons with career + per-season splits
• 6 franchises + 4 venues with Wikidata + Wikipedia + verified socials in the identity bridge
• 75+ captured matches with full scorecards, fall of wickets, partnerships, phase breakdowns
• ~300 atomic claim cards at /leagues/mlc/matches/{id}/c/{kind} — top-batter / top-bowler / biggest-partnership / pp-control / death-domination
• 36 leaderboard aspects (orange/purple cap, SR, economy, phase splits, etc.)
• All-time MLC records + per-season standings
• Cricsheet-sourced under CC BY 3.0

What you get — WPL (Women's Premier League)

• 133 player profiles across 4 seasons (2022/23–2025/26) with career + per-season splits
• 5 franchises with season records and squad stats
• 88 matches with full ball-by-ball provenance
• 32 leaderboard aspects (orange/purple cap, economy, SR, phase splits, boundaries)
• Cricsheet-sourced under CC BY 3.0

What you get — ICC Men's T20 World Cup

• 687 players across 6 editions (2013/14–2025/26)
• 230 matches with full ball-by-ball provenance
• Cross-edition leaderboards — top run-scorers, wicket-takers, economy leaders across all editions
• National team records — editions played, wins, losses, champions history
• Cricsheet-sourced under CC BY 3.0

The 43-tool catalog

43 tools across 5 leagues: 20 IPL 2026, 8 MLC, 3 WPL, 3 T20 WC, 3 cross-league, 2 research, 3 knowledge-graph, 1 IPL career leaderboard. Core doctrine §10 tools marked ★. Every tool returns canonicalUrl + dataAsOf.

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.

Hosted HTTP transport — developer preview. Connect directly to live data at https://players.cricketstudio.ai/api/mcp with an API key. Every tool call queries the current corpus — no bundled snapshot, always fresh. Register as a developer to request a key.

Claude Desktop config for HTTP transport (claude_desktop_config.json):

{
  "mcpServers": {
    "cricketstudio": {
      "url": "https://players.cricketstudio.ai/api/mcp",
      "headers": {
        "X-API-Key": "csk_live_<your-key>"
      }
    }
  }
}

Verify with curl:

# macOS / Linux / PowerShell
curl -X POST https://players.cricketstudio.ai/api/mcp \
  -H "X-API-Key: csk_live_<your-key>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# Windows cmd (escape inner quotes)
curl -X POST https://players.cricketstudio.ai/api/mcp ^
  -H "X-API-Key: csk_live_<your-key>" ^
  -H "Content-Type: application/json" ^
  -H "Accept: application/json, text/event-stream" ^
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\",\"params\":{}}"

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 access or custom plans — hello@cricketstudio.ai.

Verification queries

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

• "What does CricketStudio cover?" → get_dataset_summary
• "What's Abhishek Sharma's IPL 2026 form?" → search_players → get_player_profile
• "How is Bumrah bowling at the death?" → search_players → get_player_pillar (P3)
• "How does Virat Kohli do against Jasprit Bumrah?" → get_player_h2h
• "What's the par score at Wankhede?" → get_venue_hub
• "Show me MI's record at home" → get_team_profile
• "Who's leading IPL 2026?" → get_standings
• "Show me the SRH vs PBKS match recap" → list_fixtures → get_match_recap
• "Who has the most wickets this season?" → get_season_stats (sortBy: wickets)
• "How does Virat Kohli usually get out?" → get_dismissal_analysis (perspective: batter)
• "Compare Bumrah, Chahal and Arshdeep" → compare_players
• "What does CricketStudio cover for MLC?" → get_mlc_dataset_summary
• "Who's the top run-scorer in MLC history?" → list_mlc_leaderboards (aspect: orange-cap)
• "Show me Faf du Plessis's MLC career" → search_mlc_players → get_mlc_player_profile
• "Tell me about Texas Super Kings" → get_mlc_team_profile
• "What was the top batting performance in MLC match #1381361?" → get_mlc_match_claim (kind: top-batter)

Honest tool descriptions

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

• When to call (specific user query patterns)
• What is returned (response shape)
• What is NOT returned (boundary cases)
• Sample-size floor when applicable (≥30 balls faced for batting SR, ≥15 balls bowled for economy, ≥5 H2H deliveries, ≥3 venue fixtures, ≥3 captain matches)
• canonicalUrl in response so the LLM cites the underlying page directly

License

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

Roadmap

• Phase A — stdio npm package ✅ LIVE — npx cricketstudio-mcp v1.4.0, 43 tools, bundled snapshot, free forever. Listed on MCP Registry, PulseMCP, Glama, mcp.so, mcpmarket.
• Phase B — hosted HTTP transport ✅ LIVE (developer preview) — Key-gated endpoint at players.cricketstudio.ai/api/mcp. Always-fresh data, no bundled snapshot. Register to request a key. Public tiered plans and custom domain mcp.cricketstudio.ai to follow.
• Phase B+ — DHRUV Layer-3 tools (prediction track record), query_sql over the ball-by-ball corpus, SSE for real-time match state