MCP tools

16 tools, generated from the same list as the endpoints: what each does, its arguments, the call it makes and what the free key gets.

find

Find players, teams, venues and competitions by name, including the other names a player has been recorded under. Returns the address each of the other tools takes. Use it first whenever you have a name.

Calls GET /v1/search; on the free key: Free.

q string, required: A name, at least 2 characters.

search_matches

Matches, newest first, filtered by date, team, venue, competition, format, gender or coverage. Ball by ball runs from December 2001; every men's Test, ODI and T20 international back to 1877 is listed with its scorecard (coverage scorecard), its innings totals (coverage totals) or its result (coverage result_only). The free key sees the last 30 days.

Calls GET /v1/matches; on the free key: 30 days free.

date string: One day, YYYY-MM-DD.
from string: On or after this day, YYYY-MM-DD.
to string: On or before this day, YYYY-MM-DD.
year integer: A calendar year.
month integer: With year, 1 to 12.
format string: Format: test, odi, t20i, t20, multi-day or one-day.
gender string: male or female.
team string: A team address from find.
venue string: A venue address from find.
competition string: A competition address from find.
coverage string: full (ball by ball, with its scorecard), scorecard (each batter's and bowler's line, no balls), totals (innings totals, extras and fall of wickets) or result_only (the result only).
limit integer: How many, 1 to 100 (default 50).

latest_results

Every result from the latest day in the database.

Calls GET /v1/results/yesterday; on the free key: Free.

No arguments.

live_scores

Matches in play now, men and women, international and domestic, with the score and the state of play, updated every minute. state=upcoming lists the next 24 hours, finished the last 48. Match Week, Pro and Analyst Pro.

Calls GET /v1/live; on the free key: Match Week.

state string: live (default), upcoming, finished or all.
international string: true for Tests, ODIs and T20 internationals only.

live_match

One live match: batting and bowling so far, who is in and on strike, the bowler, the partnership, the chase and the last 12 balls. Match Week, Pro and Analyst Pro.

Calls GET /v1/live/{match}; on the free key: Match Week.

match string, required: The live match address, like 2026-10-03-india-v-west-indies. live_scores gives it.

get_match

One 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.

Calls GET /v1/matches/{match}; on the free key: 30 days free.

match string, required: The match address, like 2026-09-17-sri-lanka-v-england. search_matches and latest_results give it.

get_scorecard

The full scorecard: batting with dismissals, bowling, extras, did not bat and fall of wickets, and the weather at the ground on each day. Older internationals held without their balls (coverage scorecard) answer each batter's and bowler's line, with balls_per_over.

Calls GET /v1/matches/{match}/scorecard; on the free key: 30 days free.

match string, required: The match address, like 2026-09-17-sri-lanka-v-england. search_matches and latest_results give it.

get_deliveries

Every ball of a match: batter, non-striker, bowler, runs, extras and wickets. The free key gets the first over.

Calls GET /v1/matches/{match}/deliveries; on the free key: First over free.

match string, required: The match address, like 2026-09-17-sri-lanka-v-england. search_matches and latest_results give it.

get_partnerships

Every partnership in a match: the pair, runs, balls and how it ended.

Calls GET /v1/matches/{match}/partnerships; on the free key: Match Week.

match string, required: The match address, like 2026-09-17-sri-lanka-v-england. search_matches and latest_results give it.

player_career

Career batting and bowling for a player, format by format.

Calls GET /v1/players/{player}/stats; on the free key: Free.

player string, required: The player address, like je-root. find gives it.

player_innings

Every batting innings of a player, newest first. Lower plans get the last ten.

Calls GET /v1/players/{player}/innings; on the free key: Last 10 free.

player string, required: The player address, like je-root. find gives it.
format string: Format: test, odi, t20i, t20, multi-day or one-day.
year integer: A calendar year.
limit integer: How many, 1 to 100 (default 50).

head_to_head

Two teams against each other, by format, with the last ten meetings.

Calls GET /v1/teams/{team}/head-to-head/{other}; on the free key: Archive.

team string, required: A team address from find, like england.
other string, required: The other team address, like australia.

competition

A competition: the names it was filed under, titles by team and its all-time leaders.

Calls GET /v1/competitions/{competition}; on the free key: Free.

competition string, required: A competition address from find.

top_performances

Record lists: most runs, most wickets, highest scores, best bowling or team totals. Lower plans get the top 10.

Calls GET /v1/records; on the free key: Top 10 free.

type string, required: Which list.
format string: Format (default test).
gender string: male or female (default male).

batter_vs_bowler

One batter against one bowler: balls, runs, dismissals, strike rate and average. Analyst Pro adds dots, boundaries, how out and each format.

Calls GET /v1/analytics/matchups; on the free key: Headline free.

batter string, required: The batter address from find.
bowler string, required: The bowler address from find.

player_splits

A player by opposition, venue, year, innings and batting position; bowling by opposition, venue, year and innings.

Calls GET /v1/analytics/players/{player}/splits; on the free key: Analyst Pro.

player string, required: The player address, like je-root. find gives it.
format string: Format: test, odi, t20i, t20, multi-day or one-day.