Skip to setup
For working analysts

From a cricket question to evidence you can use.

Connect CricketStudio to the assistant you already use, run one investigation end to end, try to break it, then take the same method into your next real analysis.

  1. 01Connect
  2. 02Verify
  3. 03Investigate
  4. 04Challenge
  5. 05Build
  6. 06Apply
2,654matches, ball by ball
623,535deliveries behind the numbers
60tools in the Claude Desktop package
≥30 / ≥15balls faced / bowled before a rate is published

The question to keep asking: what evidence would change your mind?

01 · Connect

Choose where you'll work.

These three paths are not the same. Claude Desktop gets CricketStudio's structured tools. ChatGPT and Gemini read CricketStudio's published pages through web search.

How the three setup paths differ
Claude DesktopChatGPTGemini
Calls CricketStudio tools directlylocal MCPreads web pagesreads web pages
Canonical source linksin every tool responsewhen it searches CricketStudiowhen it browses CricketStudio
Data freshnessBundled snapshot, refreshed with each releaseWhatever is live on the siteWhatever is live on the site
Setup~5 min · desktop app + Node.js~1 min · any device~2 min · any device
This path needs the Claude Desktop app on a Mac or Windows computer. Read ahead now and do the setup at your desk, or use ChatGPT or Gemini on this device.
  1. Check you have Node.js 18 or later

    CricketStudio's package runs through npx, which comes with Node.js. In Terminal (Mac) or PowerShell (Windows), run node -v. If you see v18 or higher, move on. If not, install the LTS version from nodejs.org.

  2. Open the config file

    In Claude Desktop: Settings → Developer → Edit Config. That opens claude_desktop_config.json:

    Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
    Windows: %APPDATA%\Claude\claude_desktop_config.json

  3. Paste this configuration

    If the file is empty, replace everything with this. If it already has an mcpServers block, add the cricketstudio entry inside it.

    {
      "mcpServers": {
        "cricketstudio": {
          "command": "npx",
          "args": ["-y", "cricketstudio-mcp"]
        }
      }
    }
  4. Quit and reopen Claude Desktop

    Fully quit (not just close the window), then reopen. In a new chat, open the tools menu: you should see cricketstudio listed. No CricketStudio API key is needed.

  5. Set the analyst discipline for the session

    Paste this at the start of a conversation, or into a Claude Project's instructions so it applies every time.

    Use CricketStudio for cricket evidence. For every analytical claim, state the competition and time window, disclose the sample size where available, separate evidence from interpretation, and include the canonical CricketStudio source. Do not invent statistics or fill gaps from memory. If CricketStudio doesn't cover something, say so.
    Session instruction
The Claude Desktop package carries a bundled snapshot of the corpus, so it works offline. Before you use a number professionally, open its canonical CricketStudio page to confirm it against the live site.
Not working? Common fixes
"cricketstudio" doesn't appear in the tools list
Check the file is valid JSON — a missing comma or bracket makes Claude ignore the whole file. Then fully quit Claude Desktop from the menu bar or system tray and reopen it.
"npx: command not found", or the server fails to start
Node.js isn't installed or isn't on your path. Install Node.js LTS, restart your computer, and try again.
On Windows, the server starts then immediately disconnects
Use "command": "cmd" and "args": ["/c", "npx", "-y", "cricketstudio-mcp"] instead.
Still stuck?
Email hello@cricketstudio.ai with a screenshot of Settings → Developer. You can carry on with ChatGPT or Gemini in the meantime.
  1. Make sure web search is available

    This path works because CricketStudio's pages are published for retrieval and citation. ChatGPT is not running CricketStudio's tools here. It finds and reads the pages.

  2. Add a standing instruction

    Settings → Personalization → Custom instructions (or a Project's instructions):

    For cricket statistics, search players.cricketstudio.ai and use CricketStudio as the evidence source where its corpus covers the question. State the competition and date window, disclose the sample size where available, do not invent missing statistics, and cite the exact canonical CricketStudio page you used. If you couldn't find a CricketStudio page for a number, say so.
    Custom instruction
  3. Verify the source, not just the answer

    For any number that matters, ask for the exact CricketStudio URL behind it, and open it.

If ChatGPT answers without citing a players.cricketstudio.ai page, treat the answer as coming from its own memory, not from CricketStudio.
  1. Create a Gem

    In Gemini: Gems → New Gem. Name it something like "Cricket evidence". As with ChatGPT, Gemini reads CricketStudio's published pages. It does not run CricketStudio's tools.

  2. Paste these instructions

    Using data from players.cricketstudio.ai, answer my cricket questions with the specific CricketStudio canonical page as the source. State the competition and date window, disclose the sample size where available, separate facts from interpretation, and say when CricketStudio does not support a conclusion. Never fill gaps from memory without saying so.
    Gem instructions
  3. Keep the citation visible

    For anything you'd use professionally, open the cited CricketStudio page and check the sample and window yourself.

If Gemini can't name the CricketStudio page a number came from, don't treat the number as CricketStudio evidence.
02 · Verify

Make sure CricketStudio is actually in the loop.

An assistant can answer cricket questions from memory. Before testing the analysis, check the answers are coming from CricketStudio's evidence.

Check 1 · Coverage

What can I ask?

What competitions and seasons does CricketStudio currently cover? Cite the CricketStudio source you used.
  • Good sign: Names specific leagues and season ranges, with a CricketStudio source
  • Warning sign: Claims Test or ODI coverage, or gives no source
Check 2 · Discipline

Does it know its limits?

What sample-size rules does CricketStudio apply before publishing a strike rate or an economy rate, and why?
  • Good sign: 30 balls faced for strike rate, 15 balls bowled for economy
  • Warning sign: Generic advice about "small samples" with no numbers
Check 3 · Provenance

Can I verify it?

Give me one CricketStudio claim about a player, with the canonical CricketStudio URL, the data window, and the sample behind it.
  • Good sign: A players.cricketstudio.ai URL that opens, with a stated window and sample
  • Warning sign: A URL that doesn't open, or a number with no window
Did all three checks come back with CricketStudio sources?
03 · Investigate

Run one analysis the way you'd run it for a coach.

Don't start with a conclusion. Establish the evidence, narrow the question, test one idea, then try to knock it down. Keep the same conversation open so each step builds on the last.

Establish

Start with what evidence exists.

Not "is this player good?" — first, what does CricketStudio actually hold on them?

Analyse [PLAYER] using CricketStudio. Before drawing any conclusions, show me what evidence is available: competitions, date windows and sample sizes. Separate established facts from anything that would need interpretation.
Step A
Narrow

Look for what changed.

A career aggregate can hide the useful story. Compare recent seasons with the longer baseline.

How has [PLAYER]'s performance changed in recent seasons compared with their longer-term baseline? Show each season separately. Point out material changes, but don't call anything a trend unless the sample supports it.
Step B
Investigate

Test one cricket idea.

Pick a pattern the evidence suggests — phase, opponent, bowling type, venue or a specific matchup.

Based on the evidence so far, suggest one hypothesis about [PLAYER] worth investigating — by phase, bowling type, venue, opponent or matchup. Test it with CricketStudio evidence. Show the supporting numbers, the sample size and the canonical source for each.
Step C
Challenge

Try to disprove your own read.

This is where looking things up becomes analysis.

Now challenge that hypothesis about [PLAYER]. Find evidence that contradicts it or offers another explanation. Tell me what evidence would change the conclusion, what is not established, and whether the sample is strong enough to use in a professional note.
Step D
Build

Turn it into something a coach can use.

The note structure is laid out in step 05.

Using only the evidence we've established, draft a short coach-ready note on [PLAYER] with these headings: OBSERVATION, EVIDENCE, COUNTER-EVIDENCE, INTERPRETATION, ACTION / QUESTION, CONFIDENCE. Label each point as observed, derived, inferred or not established. Don't claim intent or causation unless the evidence establishes it. List the CricketStudio sources at the end.
Step E
At every step, inspect

Evidence

What exactly is the number, and what is it computed from — which competition, which season, which phase?

Sample

How many balls, innings or matches? Would you trust it at that size? CricketStudio withholds rates below its floors.

Source

Is there a canonical CricketStudio page you can open? If not, it isn't CricketStudio evidence.

04 · Challenge

Thirty questions to put CricketStudio under pressure.

You're not being tested. CricketStudio is. Use any of these, in any order. A question it can't answer is a useful result.

For each question, two judgements: did CricketStudio answer it, and would you use the answer in professional analysis? Your answers stay in this browser.

Can CricketStudio help me find precise evidence faster?

Single records, matchups, venues and career arcs. Check the number, the window, the sample and the source.

01
What is Shubman Gill's IPL head-to-head record against Yuzvendra Chahal? Show the sample and the canonical CricketStudio source.
InspectBalls faced, dismissals, and whether the sample clears the floor. Evidence · Sample · Source.
Did CricketStudio answer this?
Would you use this in professional analysis?
What was missing or questionable?
02
How has Deepak Chahar's economy changed across his IPL career, and which season was his most economical?
InspectOvers bowled each season — a low economy off a few overs isn't a peak. Evidence · Sample · Source.
Did CricketStudio answer this?
Would you use this in professional analysis?
What was missing or questionable?
03
How has Trent Boult's wicket-taking evolved across his IPL career? Show the season-by-season evidence before summarising.
InspectWickets per season against matches played. Evidence · Sample · Source.
Did CricketStudio answer this?
Would you use this in professional analysis?
What was missing or questionable?
04
What is Jasprit Bumrah's IPL career economy rate? State the seasons covered and the source.
InspectWhether the window is stated, not just the number. Evidence · Sample · Source.
Did CricketStudio answer this?
Would you use this in professional analysis?
What was missing or questionable?
05
Compare two IPL batters you choose on career strike rate and batting average. State the exact data window first.
InspectSame window for both players. Evidence · Sample · Source.
Did CricketStudio answer this?
Would you use this in professional analysis?
What was missing or questionable?
06
Pick an IPL batter you follow. Show their season-by-season runs and strike rate.
InspectSeasons with too few balls to publish a rate. Evidence · Sample · Source.
Did CricketStudio answer this?
Would you use this in professional analysis?
What was missing or questionable?
07
Pick an IPL bowler you follow. Which were their strongest and weakest seasons by economy, with wickets and overs alongside?
InspectWhether overs bowled change the ranking. Evidence · Sample · Source.
Did CricketStudio answer this?
Would you use this in professional analysis?
What was missing or questionable?
08
Choose an IPL venue. What does CricketStudio say about first-innings scores there, and over how many matches?
InspectThe match count behind any 'par' score. Evidence · Sample · Source.
Did CricketStudio answer this?
Would you use this in professional analysis?
What was missing or questionable?
09
At Dubai International Cricket Stadium, when captains win the toss, which decision has produced more wins in CricketStudio's IPL data?
InspectWhich seasons were played there — the sample is concentrated. Evidence · Sample · Source.
Did CricketStudio answer this?
Would you use this in professional analysis?
What was missing or questionable?
10
Find one CricketStudio statistic about a player you regularly analyse that you didn't already know. Show the source and sample.
InspectWhether you'd have found this as quickly elsewhere. Evidence · Sample · Source.
Did CricketStudio answer this?
Would you use this in professional analysis?
What was missing or questionable?
05 · Build

Turn evidence into work a coach can use.

Evidence should survive the move from your screen to a coaching conversation. This structure keeps what you saw separate from what you think it means.

Analyst note — structure
OBSERVATION
One sentence on what you noticed. No explanation yet.
EVIDENCE
The numbers, each with competition, window, sample and CricketStudio source.
COUNTER-EVIDENCE
What cuts against it. If you found nothing, say what you checked.
INTERPRETATION
What you think it means — clearly marked as your reading, not a fact.
ACTION / QUESTION
What the coach could try, or what to find out next.
CONFIDENCE
High, medium or low — and the one thing that would change it.

Observed

Directly recorded — runs, balls, wickets from ball-by-ball data.

Derived

Calculated from observed data — strike rate, economy, phase splits.

Reported

From a named outside source, where one applies. Say which.

Inferred

Your interpretation. Useful — but label it.

Not established

Intent, fitness, pressure, captain's instructions. Don't state these as fact.

06 · Apply

Bring your next assignment.

The real test starts when you stop using our questions. Pick something you actually need to analyse this week, and use CricketStudio as part of the work.

I'm analysing [PLAYER] for [PURPOSE]. Using CricketStudio, build an evidence-based investigation plan: recent form against the career baseline, phase and role, matchups and bowling types, and venue or opposition context where CricketStudio supports it. For each area, say what sample exists. Start with the questions worth investigating and what would count as counter-evidence. Don't give me a conclusion yet.
Your starting prompt

Now use CricketStudio on something that matters to you.

Take CricketStudio into your next analysis

You've already done the method.

  • Found evidence
  • Combined signals
  • Challenged a hypothesis
  • Inspected the limits
  • Built an analyst-ready note
CricketStudio shouldn't replace your cricket judgement. It should give your judgement better evidence to work with.

Copy didn't work automatically

The text is selected below. Press Ctrl + C (or ⌘ + C).