# The Stats Desk
> Ask cricket questions in plain English and get answers backed by 7.6 million ball-by-ball deliveries — no account required.

## What this is
The Stats Desk answers cricket statistics questions from ball-by-ball data: 16,850 matches from 2005–2026, men's and women's cricket, Tests, ODIs, T20Is, and the major T20 leagues (IPL, BBL, PSL, CPL, SA20, ILT20, MLC, The Hundred, T20 Blast, LPL, Super Smash). Every answer comes with a written summary, the SQL query that produced it, a results table you can download as CSV, and a chart (bar, line, worm, wagon wheel, pitch map, or Manhattan) when one fits the data.

## How to ask
- Web: https://stats-desk.aryaman.ink — type a question, no account needed.
- API: `POST /query`, a free public JSON endpoint, rate-limited per IP:

  ```json
  {"question": "Bumrah's economy in death overs in T20Is"}
  ```

  Full request/response schema: /openapi.json

## Data coverage and freshness
7.6 million deliveries across 16,850 matches, 2005–2026. Refreshed regularly from Cricsheet.

## Licensing and attribution
Ball-by-ball data is from Cricsheet (https://cricsheet.org), used under the Open Database License (ODbL: https://opendatacommons.org/licenses/odbl/1-0/). Every answer that draws on it carries that attribution.

## Sharing
Any answer can be published as a public, read-only link with a preview card for social and chat previews.

## Betas
Advanced metrics (Delta, RAA, WAR, and role-based stats), sign-in with saved history, and the MCP server described below are invite-only betas.

## For AI agents
- Agent documentation: /agents
- Remote MCP (Streamable HTTP): /mcp
- OAuth protected-resource metadata: /.well-known/oauth-protected-resource/mcp
- OpenAPI: /openapi.json

MCP is an invite beta. OAuth and csd_sk_ service secrets are supported. Public widget, csd_pub_, and legacy csd_ credentials cannot authorize MCP.

Prefer tools in this order: lookup_player; discover_cricket_data or explore_values; parameterized player_stats, head_to_head, or leaderboard; cricket_sql only when explicitly listed for a secret credential. ask_cricket returns a finished natural-language answer.

Raw SQL is standard-data-only and read-only. Raw advanced SQL, advanced table discovery, filesystem/network functions, catalogs, multiple statements, and unbounded results are unavailable.

Every applicable result includes source attribution. Standard descriptive data is derived from Cricsheet under ODbL; use discover_cricket_data for the deployed coverage watermark.