Cricsheet MCP server

@pipeworx/cricsheet

Ball-by-ball cricket data collapsed to the questions people actually ask: a match's result and scorecard, a player's career batting/bowling aggregates, and a head-to-head record between two teams. Covers Test matches, One Day Internationals, T20 Internationals, and the Indian Premier League. Fleet #2975.

Part of Pipeworx — an MCP gateway connecting AI agents to 1784+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

Tools

innings, the batting card (each batter's runs/balls/4s/6s/how out) and bowling card (each bowler's overs/runs/wickets). Use cricsheetfindmatches first to get a match_id.

• cricsheetmatch(matchid) — one match's full result plus, for every

and bowling aggregates (matches, runs, average, strike rate, 100s/50s; wickets, bowling average, economy). player is matched case-insensitively as a substring against the short-form names this pack stores (e.g. "Kohli" for "V Kohli"); an ambiguous query returns a candidate list instead of guessing. Optionally scope to one format.

• cricsheetplayerstats(player, format?) — a cricketer's career batting

matches, each team's wins, ties/no-results, and the most recent matches with their results. Team names must match Cricsheet's own strings (e.g. "India", "Mumbai Indians").

• cricsheetheadtohead(teama, team_b, format?, limit?, offset?) — total

— search the match index to discover match_ids. With no filters, returns the most recent matches held across every format.

• cricsheetfindmatches(team?, format?, season?, venue?, player?, limit?, offset?)

format accepts "Test", "ODI", "T20I" (international T20), or "IPL" (case-insensitive); omit it to search across all four.

What this pack does not do: it does not return individual deliveries (ball-by-ball). Every match file is parsed ball-by-ball once, at load time, and collapsed into match / innings / batting-card / bowling-card rows — storing every ball for ~11,000 matches would multiply the row count by roughly 150-200x for a question ("who scored what, who took which wickets") that the scorecard already answers.

Auth

Keyless. The tools answer only through the Pipeworx gateway, which holds the data; a standalone npm install has no data to read, and every tool throws a clear "not bound in this runtime" error there instead of returning an empty list.

Data sources

Internationals, T20 Internationals, and the Indian Premier League. Licence: ODC Attribution License (ODC-BY) — free to share, adapt and use (including commercially) with attribution to Cricsheet. Cricsheet publishes bulk per-match files only (no live API), so this pack builds a copy (scripts/cricsheet/load-data.mjs) into a D1 database rather than proxying per request, per CLAUDE.md's "build the copy" rule for a bulk-only source.

• Cricsheet — ball-by-ball match data for Test cricket, One Day

Known gaps — read before extending this pack

Only four of Cricsheet's ~60 competitions are loaded. Cricsheet also publishes first-class, List A, and ~50 domestic T20 leagues (Big Bash, T20 Blast, Pakistan Super League, Caribbean Premier League, The Hundred, and so on) as separate bulk files. This pack loads the four with the clearest cross-format demand (international Test/ODI/T20I plus the IPL, the league named explicitly in the originating demand signal). Adding another league is one more entry in BULK_FILES in the loader, using the same match-type-agnostic parser.

Women's matches are included wherever Cricsheet's own bulk file includes them, distinguished by the gender field Cricsheet carries per match — not filtered out, not separately tooled.

Shortened. The full README is on GitHub.