findFreeFind players, teams, venues and competitions by name, including the other names a player has been recorded under.
GET /v1/searchConnect it in a minute
One address and your API key, sent as a Bearer token. The free key works; a paid plan opens more of every tool. Using an agent without MCP? Give it the agent skill.
In a terminal, with your key in place of YOUR_KEY
claude mcp add --transport http cricketdatabase https://cricketdatabase.com/mcp --header "Authorization: Bearer YOUR_KEY"
In .cursor/mcp.json
{ "mcpServers": { "cricketdatabase": {
"url": "https://cricketdatabase.com/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
} } }Any client that takes a streamable HTTP server
{ "url": "https://cricketdatabase.com/mcp",
"transport": "http",
"headers": { "Authorization": "Bearer YOUR_KEY" } }The tool list, straight from a terminal
curl -s https://cricketdatabase.com/mcp \
-H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'16 tools, one plan
Each tool is one call to the public API, so it answers with exactly what your plan answers. The label shows what the free key gets; every tool opens its page in the documentation.
search_matches30 days freeMatches, newest first, filtered by date, team, venue, competition, format, gender or coverage.
GET /v1/matcheslatest_resultsFreeEvery result from the latest day in the database.
GET /v1/results/yesterdaylive_scoresMatch WeekMatches in play now, men and women, international and domestic, with the score and the state of play, updated every minute.
GET /v1/livelive_matchMatch WeekOne live match: batting and bowling so far, who is in and on strike, the bowler, the partnership, the chase and the last 12 balls.
GET /v1/live/{match}get_match30 days freeOne match: teams, result, toss, venue, officials, player of the match and the innings totals; for an international without a scorecard, its innings totals, extras and fall of wickets when held.
GET /v1/matches/{match}get_scorecard30 days freeThe full scorecard: batting with dismissals, bowling, extras, did not bat and fall of wickets, and the weather at the ground on each day.
GET /v1/matches/{match}/scorecardget_deliveriesFirst over freeEvery ball of a match: batter, non-striker, bowler, runs, extras and wickets.
GET /v1/matches/{match}/deliveriesget_partnershipsMatch WeekEvery partnership in a match: the pair, runs, balls and how it ended.
GET /v1/matches/{match}/partnershipsplayer_careerFreeCareer batting and bowling for a player, format by format.
GET /v1/players/{player}/statsplayer_inningsLast 10 freeEvery batting innings of a player, newest first.
GET /v1/players/{player}/inningshead_to_headArchiveTwo teams against each other, by format, with the last ten meetings.
GET /v1/teams/{team}/head-to-head/{other}competitionFreeA competition: the names it was filed under, titles by team and its all-time leaders.
GET /v1/competitions/{competition}top_performancesTop 10 freeRecord lists: most runs, most wickets, highest scores, best bowling or team totals.
GET /v1/recordsbatter_vs_bowlerHeadline freeOne batter against one bowler: balls, runs, dismissals, strike rate and average.
GET /v1/analytics/matchupsplayer_splitsAnalyst ProA player by opposition, venue, year, innings and batting position; bowling by opposition, venue, year and innings.
GET /v1/analytics/players/{player}/splitsHow it works
Nothing new to learn: the tools are the API, with the same key, limits and plans.
1
Your key, your plan
The server passes every call to the API with your own key, so the answers are exactly what your plan returns.
Authorization: Bearer cdb_live_...
2
The same limits
Each tool call counts as one API call against your daily limit and your pace per minute, shown on your account.
50 a day on the free key 100,000 a day on Analyst Pro
3
Clear refusals
A tool your plan does not open says so, names the plan that does, and links the pricing page, so your assistant can tell you.
{"isError": true, "content": [{"type": "text",
"text": "Splits need Analyst Pro:
cricketdatabase.com/pricing"}]}Start with the free key
One step with Google, no card. Fifty tool calls a day on real matches.