{
  "markdown": "# 🏏 Cricket MCP Server\n\n[![MCP](https://img.shields.io/badge/MCP-server-blue)](https://modelcontextprotocol.io)\n[![Go](https://img.shields.io/badge/go-1.25%2B-00ADD8)](https://go.dev)\n[![License](https://img.shields.io/badge/license-BSD--3--Clause-green)](LICENSE)\n\n> Cricket analytics for Claude Desktop, Claude Code, Cursor and any other MCP\n> client — a calibrated win-probability model, 22,479 archived matches, and\n> live prediction-market prices.\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server that gives\nAI assistants real cricket knowledge: a **calibrated win-probability model**, a\n**ball-by-ball archive of 22,000+ matches**, live prediction-market prices,\ncareer records, and live scores.\n\nAsk cricket questions in plain language and get answers computed from data\nrather than recalled from training.\n\n## ⚡ Add it in one step\n\nIt is hosted. There is nothing to install, download, build or configure.\n\n```\nhttps://cricketfornoobs.com/mcp\n```\n\nPaste that into your client's connector settings and you are done.\n\n| Client | Where |\n|---|---|\n| **Claude** (free plan included) | Customize → Connectors → Add custom connector |\n| **ChatGPT** | Settings → Apps → Developer mode → add server |\n| **Claude Code** | `claude mcp add --transport http cricket https://cricketfornoobs.com/mcp` |\n| **Cursor / VS Code** | one-click buttons at [cricketfornoobs.com/mcp](https://cricketfornoobs.com/mcp) |\n| **Gemini CLI** | add `{\"cricket\": {\"httpUrl\": \"https://cricketfornoobs.com/mcp\"}}` to `~/.gemini/settings.json` |\n\nNo account, no API key, no data pipeline. Read-only.\n\nPrefer to run it on your own machine? See [Quick start](#-quick-start) below:\nsame tools, one static binary.\n\n## 💬 Things to ask it\n\n- *\"Who's winning the India match right now, and what does the model say?\"*\n- *\"Who is favoured at 149 for 7 chasing 178 with three overs left?\"*\n- *\"How does Kohli bat against Bumrah in T20s?\"*\n- *\"What does the market think versus your model for Welsh Fire vs Southern Brave?\"*\n- *\"How does Bumrah get his wickets — bowled, caught, lbw?\"*\n- *\"What's Rashid Khan's dot-ball percentage in T20s?\"*\n- *\"Is Kohli better batting first or chasing?\"*\n- *\"Who does Rohit Sharma score most of his runs with?\"*\n- *\"Does Grand Prairie Stadium favour chasing?\"*\n- *\"Show me Pooran's death-overs record.\"*\n- *\"What actually is a googly?\"*\n\nThe same win model runs in production at\n**[cricketfornoobs.com](https://cricketfornoobs.com)**, a live cricket explainer\nfor American sports fans. This server exposes the analytics side of it to any\nMCP client.\n\n## ✨ What makes this different\n\nMost sports MCP servers wrap a scores API. This one ships analysis:\n\n- **Win probability from a fitted model** — logistic regression per format and\n  innings over 17,907 matches (5.6M ball states), with pre-match Elo ratings.\n  Held-out log loss 0.42 (T20 chases) / 0.40 (ODI chases); ~91% accurate on\n  confident calls. It knows that 149/7 chasing 178 is not the same story as\n  149/2.\n- **Ball-by-ball archive** — 22,479 matches and 11.4M deliveries across T20,\n  ODI/List-A, Tests and domestic multi-day cricket.\n- **Career and matchup records** — batter-vs-bowler head-to-heads, phase\n  splits (powerplay / middle / death), venue reports, league leaderboards.\n- **Baseball translations** — every cricket term explained through its closest\n  baseball equivalent, for newcomers to the sport.\n\n## 🛠️ Tools\n\n| Tool | What it does |\n|------|-------------|\n| `cricket_win_probability` | Win probability for any live or hypothetical match state |\n| `cricket_head_to_head` | Career batter-vs-bowler record (balls, runs, dismissals, strike rate) |\n| `cricket_player_career` | Career aggregates per format, men's and women's cricket |\n| `cricket_match_archive` | Scorecard for an archived match, searched by teams / league / year |\n| `cricket_phase_stats` | Batting and bowling split by powerplay, middle overs and death |\n| `cricket_venue_stats` | Ground report: average first-innings score, chase win rate |\n| `cricket_leaders` | League and season leaderboards for runs or wickets |\n| `cricket_team_form` | A team's recent archived results |\n| `cricket_dismissals` | How a batter gets out, or how a bowler takes wickets |\n| `cricket_discipline` | Dot-ball and boundary percentage, the numbers no scorecard shows |\n| `cricket_situational` | A batter's record batting first versus chasing |\n| `cricket_partnerships` | Runs added with each partner at the crease, and the best stand |\n| `cricket_market_odds` | Live prediction-market prices (Kalshi) beside this model's number |\n| `cricket_live_matches` | Matches live and upcoming right now |\n| `cricket_explain_term` | Any cricket term, with its baseball equivalent |\n\nAll tools are read-only.\n\n## 🚀 Quick start\n\n### 1. Install\n\nOne static binary, no runtime, no interpreter, no dependencies.\n\n```bash\ngo install github.com/asaraog/mcp-cricket/cmd/cricket-mcp@latest\n```\n\nOr download a prebuilt binary for macOS (Apple silicon or Intel), Linux\n(x86-64 or arm64) or Windows from\n[Releases](https://github.com/asaraog/mcp-cricket/releases).\n\nRegister it with Claude Code:\n\n```bash\nclaude mcp add cricket -- ~/go/bin/cricket-mcp\n```\n\n### 2. Or configure a desktop client\n\nAdd the server to your client's config — for Claude Desktop:\n\n| OS | Config file |\n|----|-------------|\n| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Windows | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n| Linux | `~/.config/Claude/claude_desktop_config.json` |\n\n\n```json\n{\n  \"mcpServers\": {\n    \"cricket\": {\n      \"command\": \"/ABSOLUTE/PATH/TO/cricket-mcp\"\n    }\n  }\n}\n```\n\nRestart the client and the cricket tools appear. **That's the whole setup** —\non first use the server downloads the prebuilt archive once (~200 MB) into\nyour OS cache directory (`~/Library/Caches` on macOS, `~/.cache` on Linux,\n`%LocalAppData%` on Windows) and reuses it from then on. No account, no API key, no\ndata pipeline to run.\n\n<details>\n<summary>Building the archive yourself instead</summary>\n\nThe archive is generated from public [Cricsheet](https://cricsheet.org) data,\nso you can build your own rather than downloading ours:\n\n```bash\ncurl -O https://cricsheet.org/downloads/all_json.zip\npython3 scripts/histgen.py all_json.zip history.db\n```\n\nThen point `HISTORY_DB` at the result. Limited-overs-only archives work too —\ntools degrade gracefully when a format is absent.\n</details>\n\n## ⚙️ Configuration\n\n| Variable | Purpose |\n|----------|---------|\n| `HISTORY_DB` | Where the archive lives (default: your OS cache directory) |\n| `HISTORY_DB_URL` | Override the archive download URL |\n| `HISTORY_DB_TOKEN` | Bearer token, if that URL needs auth |\n| `HISTORY_QUERY_TIMEOUT` | Query deadline, default `3s`; raise for heavy leaderboards |\n\nLive-score tools work without any archive; archive tools report clearly when\nthe database is missing rather than inventing an answer.\n\n## 📊 About the model\n\nThe win model is fitted offline, not guessed at runtime. Features are match\nstate (runs, wickets, balls remaining, required rate), pre-match Elo, and a\nwickets × required-rate interaction — because thin batting hurts far more when\nthe asking rate is steep. Calibration is measured by wickets in hand: within\nabout one point across most of the range.\n\n**Par is per ground.** A first-innings score only means something relative to\nwhat the ground usually yields, so the innings-one segments are fitted against\na table of 371 grounds and 7 leagues rather than one global constant. Real pars\nrun from 153.7 to 172.5 by league alone, and further by ground. Pass `venue`\n(and `league`) to `cricket_win_probability` and the same 80/2 at ten overs is\n47% at Chinnaswamy and 60% at Newlands. Without a venue it falls back\nground → league → global, which costs about 0.006 of held-out log loss.\n\nIt cannot see injuries, weather, pitch reports or team news.\n\n## 📈 Markets\n\n`cricket_market_odds` reads public prices from [Kalshi](https://kalshi.com), a\nCFTC-regulated US exchange where contracts settle at $1 and a price in cents\n*is* the implied probability. Put beside `cricket_win_probability`, the gap\nbetween the two is the edge a trader would be claiming.\n\nThis is informational only — read-only market data, no account, no orders, no\nadvice. The model cannot see injuries, weather or team news, which is often\nexactly why it disagrees with the market. Event contracts are legal in some\njurisdictions and not others.\n\n## 🙏 Data\n\nBall-by-ball data from [Cricsheet](https://cricsheet.org), licensed\n[CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/). Live scores\nfrom public ESPNcricinfo endpoints; market prices from Kalshi's public API.\nThis project is unaffiliated with any of them.\n\n## 📝 License\n\nBSD 3-Clause. See [LICENSE](LICENSE).\n",
  "bytes": 8783,
  "sha": "c357fef290dd67ff81c6d1a0a0e50d8c42b8b8cfb4dee584283a15b2b4856b9e",
  "repo_slug": "asaraog/mcp-cricket",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_asaraog_mcp_cricket_d0f6930b/readme"
}