Server definition
- Hash
- sha256:4a6d41d3f88bcadbb74781203f48de648ccc08bfbf7435d88f79f2069726d216
- What it is
- What a remote MCP server returned when asked what it offers: 18 tools
The blob, as servednamed by its sha256
{
"instructions": "YorkerAPI -- 18 cricket data tools. Ball-by-ball for every format, men's and women's, Tests to T20 leagues, with players, venues, our Elo and per-ball win probability, and sportsbook match-winner prices from mid-2020.\n\n## First Steps\n\n1. Find a player's id with search_players (1 cr), a team's id with list_teams (1 cr), a competition's key with list_competitions (1 cr).\n2. Find matches with get_matches (2 cr) or get_schedule (2 cr). Match ids are numbers (\"1422119\"); a fixture keeps its id once played.\n3. Seasons are as the competition writes them: a year (\"2024\") or a split season (\"2024/25\"); a year also finds the split season that starts in it.\n\n## Tool Selection\n\n- Competition keys -> list_competitions (1 cr); team ids -> list_teams (1 cr); a player's id -> search_players (1 cr)\n- Upcoming and live matches -> get_schedule (2 cr); results -> get_matches (2 cr)\n- One match: batting and bowling cards, ratings, every book's price -> get_match (5 cr)\n- Every ball of a match, or a batter's or bowler's balls -> get_deliveries (10 cr)\n- A career by format -> get_player (5 cr); split by season, competition or phase -> get_player_stats (5 cr); match by match -> get_player_matches (5 cr)\n- Batter against bowler -> get_matchup (5 cr); leaders in a stat -> get_leaders (5 cr)\n- How a ground plays -> get_venue (5 cr); our team ratings -> get_ratings (2 cr)\n- A match's win-probability worm -> get_win_probability (10 cr)\n- Match-winner prices -> get_odds (5 cr); how a market moved, and in-play prices -> get_line_movement (10 cr)\n- The in-play market beside our model on the exact ball -> get_market_vs_model (10 cr)\n\n## Notes\n\n- Competitions are filters on one dataset: test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women and more (list_competitions). Women's sides are separate teams (ids end -women).\n- Overs are 0-based as scorers count them: over 0 is the first over. A ball's \"ball\" counts wides and no-balls; \"legal\" says whether it counted.\n- Batting and bowling figures are counted from the balls we hold, so a career that began before the record (December 2001, thin until 2003) shows only the part inside it. Super overs are left out of player figures. Bowlers are charged wides and no-balls, not byes or leg byes; balls faced exclude wides.\n- Ratings are ours: Elo per format from results. Win probability is our model's chance the batting side wins after each ball (limited overs only).\n- Prices are match-winner only, decimal and American. Prices taken after the first ball are in-play and kept apart from the pregame lines.\n- A player has one id across every format and competition.\n\n## Credit costs\n\n| Credits | Tools |\n|---|---|\n| 1 | list_competitions, list_teams, search_players |\n| 2 | get_schedule, get_matches, get_ratings |\n| 5 | get_match, get_player, get_player_stats, get_player_matches, get_matchup, get_leaders, get_venue, get_odds |\n| 10 | get_deliveries, get_win_probability, get_market_vs_model, get_line_movement |\n\nData credits: Ball-by-ball cricket data from Cricsheet (cricsheet.org), licensed under the Open Data Commons Attribution License (ODC-BY), combined with our own models.\n\n## Data timing and rights\n\n- Odds and props are pre-game only. captured_at is when a line was captured (the page says exactly what it means for each kind of row); where props are held, rows also carry scheduled_start and minutes_before_scheduled_start (negative when captured after the scheduled start).\n- Records are overwritten when sources correct them; no revision history is kept.\n- You may store the data, train models, backtest, and build commercial products that show your users what you derive. You may not redistribute the data, or odds as a raw feed, as a dataset or API of its own. After an account closes, stored data is for internal use only.\n- YorkerAPI is independent, not an official league partner, and grants no league rights.\n- Full answers: https://yorkerapi.com/docs/timing-and-rights\n\n## Sportsbook prices are information\n\nShow lines and prices as data about the market. Do not work out a stake, payout or profit for a wager, recommend a bet, or send the user to a sportsbook. No tool places, accepts or tracks wagers; if asked to bet, say so and offer the data instead.",
"tools": [
{
"description": "Use for ball-by-ball rows: every delivery of a match (or one innings), or a batter's or bowler's balls across matches (filter by competition, season, overs, wickets only or boundaries only). Each ball has runs, extras, the wicket and fielders, the score after it and our win probability for the batting side (limited-overs matches). Costs 10 credits.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"batter_id": {
"description": "Player id from search_players.",
"type": "string"
},
"boundaries_only": {
"type": "boolean"
},
"bowler_id": {
"description": "Player id from search_players.",
"type": "string"
},
"competition": {
"description": "Competition key from list_competitions (ipl, bbl, psl, blast, hundred, county, test, odi, t20i, ...).",
"type": "string"
},
"innings": {
"maximum": 8,
"minimum": 1,
"type": "integer"
},
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
},
"limit": {
"description": "Max balls (default 600 for a match, 200 otherwise).",
"maximum": 3000,
"minimum": 1,
"type": "integer"
},
"match_id": {
"description": "Match id from get_matches.",
"type": "string"
},
"offset": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"over_from": {
"description": "First over, 0-based as scorers count (0 is the first over).",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"over_to": {
"description": "Last over, 0-based.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"season": {
"description": "Season: a year (2024) or a split season (2024/25); a year also finds the split season that starts in it.",
"type": "string"
},
"wickets_only": {
"type": "boolean"
}
},
"type": "object"
},
"name": "get_deliveries",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"deliveries": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"required": [
"deliveries",
"count"
],
"type": "object"
}
},
{
"description": "Use for the leaders in a stat (runs, batting_average, strike_rate, sixes, wickets, economy, bowling_average) in a competition, season or format. Rate stats need min_balls faced or bowled (default 120). Costs 5 credits.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"competition": {
"description": "Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...).",
"type": "string"
},
"format": {
"enum": [
"test",
"odi",
"t20",
"first_class",
"list_a"
],
"type": "string"
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
},
"limit": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"min_balls": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"season": {
"description": "Season: a year (2024) or a split season (2024/25).",
"type": "string"
},
"stat": {
"enum": [
"runs",
"batting_average",
"strike_rate",
"sixes",
"wickets",
"economy",
"bowling_average"
],
"type": "string"
}
},
"required": [
"stat"
],
"type": "object"
},
"name": "get_leaders",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"leaders": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"min_balls": {
"type": "number"
},
"stat": {
"type": "string"
}
},
"required": [
"stat",
"min_balls",
"leaders",
"count"
],
"type": "object"
}
},
{
"description": "Use for how one match's market moved: every pregame snapshot by sportsbook (decimal and American), the median margin-free probability per snapshot, and with include_in_play the prices taken during the match. Costs 10 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"bookmaker": {
"description": "One book's key, e.g. \"pinnacle\".",
"type": "string"
},
"include_in_play": {
"type": "boolean"
},
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
},
"match_id": {
"description": "Match id from get_matches.",
"type": "string"
}
},
"required": [
"match_id"
],
"type": "object"
},
"name": "get_line_movement",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"consensus": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"count": {
"type": "number"
},
"in_play": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"match_id": {
"type": "string"
},
"pregame": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
}
},
"required": [
"match_id",
"pregame",
"consensus",
"in_play",
"count"
],
"type": "object"
}
},
{
"description": "Use to see a limited-overs match's in-play market beside our model, on the exact ball: at each in-play price snapshot, the median margin-free price on team 1, our win probability after the last ball bowled before it, the score at that moment and the gap. Costs 10 credits.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
},
"match_id": {
"description": "Match id from get_matches.",
"type": "string"
}
},
"required": [
"match_id"
],
"type": "object"
},
"name": "get_market_vs_model",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"match_id": {
"type": "string"
},
"method": {
"type": "string"
},
"note": {
"type": "string"
},
"snapshots": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"team1_id": {
"type": "string"
},
"team2_id": {
"type": "string"
},
"widest_gap": {
"anyOf": [
{
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
]
},
"winner_id": {
"type": [
"string",
"null"
]
}
},
"required": [
"match_id",
"team1_id",
"team2_id",
"winner_id",
"snapshots",
"widest_gap",
"count",
"method"
],
"type": "object"
}
},
{
"description": "Use for one match in full: result, toss, venue, player of the match, every innings with its batting card (runs, balls, fours, sixes, strike rate, how out, fall of wicket) and bowling card (overs, maidens, runs, wickets, economy), our team ratings before and after, and each sportsbook's opening and closing match-winner price. Costs 5 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
},
"match_id": {
"description": "Match id from get_matches or get_schedule.",
"type": "string"
}
},
"required": [
"match_id"
],
"type": "object"
},
"name": "get_match",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"innings": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"match": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"odds": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"ratings": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
}
},
"required": [
"match",
"innings",
"ratings",
"odds"
],
"type": "object"
}
},
{
"description": "Use for results: matches newest first with both scores, toss, result and margin. Filter by competition, season, team, opponent, venue, date or a date range. Costs 2 credits.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"competition": {
"description": "Competition key from list_competitions (ipl, bbl, psl, blast, hundred, county, test, odi, t20i, ...).",
"type": "string"
},
"date": {
"description": "A day the match was played (YYYY-MM-DD); multi-day matches match on any day.",
"type": "string"
},
"format": {
"enum": [
"test",
"odi",
"t20",
"first_class",
"list_a"
],
"type": "string"
},
"from": {
"description": "Start date on or after (YYYY-MM-DD).",
"type": "string"
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
},
"limit": {
"description": "Max matches (default 50).",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"offset": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"opponent_id": {
"description": "Only matches against this team too.",
"type": "string"
},
"season": {
"description": "Season: a year (2024) or a split season (2024/25); a year also finds the split season that starts in it.",
"type": "string"
},
"team_id": {
"description": "Team id from list_teams.",
"type": "string"
},
"to": {
"description": "Start date on or before (YYYY-MM-DD).",
"type": "string"
},
"venue": {
"description": "Part of the ground or city name.",
"type": "string"
}
},
"type": "object"
},
"name": "get_matches",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"matches": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"required": [
"matches",
"count"
],
"type": "object"
}
},
{
"description": "Use for a batter against a bowler: balls, runs, strike rate, dots, fours, sixes and every dismissal, overall and by format. Costs 5 credits.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"batter_id": {
"description": "Batter's player id.",
"type": "string"
},
"bowler_id": {
"description": "Bowler's player id.",
"type": "string"
},
"competition": {
"description": "Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...).",
"type": "string"
},
"format": {
"enum": [
"test",
"odi",
"t20",
"first_class",
"list_a"
],
"type": "string"
},
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
}
},
"required": [
"batter_id",
"bowler_id"
],
"type": "object"
},
"name": "get_matchup",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"batter": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"bowler": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"by_format": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"count": {
"type": "number"
},
"dismissals": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"summary": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"required": [
"batter",
"bowler",
"summary",
"by_format",
"dismissals",
"count"
],
"type": "object"
}
},
{
"description": "Use for match-winner prices by sportsbook (mid-2020 on, upcoming matches included): each book's opening and latest pregame decimal price, the American price and how many snapshots we hold. For one match, or a competition, season or date. Costs 5 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"competition": {
"description": "Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...).",
"type": "string"
},
"date": {
"description": "A day of the match (YYYY-MM-DD).",
"type": "string"
},
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
},
"limit": {
"description": "Max matches (default 20).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"match_id": {
"description": "Match id from get_matches.",
"type": "string"
},
"season": {
"type": "string"
}
},
"type": "object"
},
"name": "get_odds",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"matches": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
}
},
"required": [
"matches",
"count"
],
"type": "object"
}
},
{
"description": "Use for a player's career: teams played for, and batting (runs, balls, average, strike rate, fours, sixes, hundreds, fifties, highest score) and bowling (overs, wickets, average, economy, strike rate, five-wicket hauls, best) by format, all counted from the ball-by-ball record, which starts in December 2001, so an earlier career shows only the part since. Costs 5 credits.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
},
"player_id": {
"description": "Player id from search_players.",
"type": "string"
}
},
"required": [
"player_id"
],
"type": "object"
},
"name": "get_player",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"batting_by_format": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"bowling_by_format": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"player": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"teams": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
}
},
"required": [
"player",
"teams",
"batting_by_format",
"bowling_by_format"
],
"type": "object"
}
},
{
"description": "Use for a player's matches, newest first: team, opponent, result, and the player's batting (runs, balls, fours, sixes, out) and bowling (balls, runs, wickets) in each innings. Filter by format, competition or season. Costs 5 credits.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"competition": {
"description": "Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...).",
"type": "string"
},
"format": {
"enum": [
"test",
"odi",
"t20",
"first_class",
"list_a"
],
"type": "string"
},
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
},
"limit": {
"description": "Max matches (default 50).",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"offset": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"player_id": {
"description": "Player id from search_players.",
"type": "string"
},
"season": {
"description": "Season: a year (2024) or a split season (2024/25).",
"type": "string"
}
},
"required": [
"player_id"
],
"type": "object"
},
"name": "get_player_matches",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"matches": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"name": {
"type": "string"
},
"next_offset": {
"type": [
"number",
"null"
]
},
"player_id": {
"type": "string"
}
},
"required": [
"player_id",
"name",
"matches",
"count"
],
"type": "object"
}
},
{
"description": "Use for a player's batting and bowling split by season, competition, phase of the innings (powerplay, middle, death) or format, optionally inside one format, competition or season. Costs 5 credits.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"by": {
"description": "How to split (default format).",
"enum": [
"season",
"competition",
"phase",
"format"
],
"type": "string"
},
"competition": {
"description": "Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...).",
"type": "string"
},
"format": {
"enum": [
"test",
"odi",
"t20",
"first_class",
"list_a"
],
"type": "string"
},
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
},
"player_id": {
"description": "Player id from search_players.",
"type": "string"
},
"season": {
"description": "Season: a year (2024) or a split season (2024/25).",
"type": "string"
}
},
"required": [
"player_id"
],
"type": "object"
},
"name": "get_player_stats",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"batting": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"bowling": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"count": {
"type": "number"
},
"grouped_by": {
"type": "string"
},
"name": {
"type": "string"
},
"player_id": {
"type": "string"
}
},
"required": [
"player_id",
"name",
"grouped_by",
"batting",
"bowling",
"count"
],
"type": "object"
}
},
{
"description": "Use for our team ratings (Elo) in one format, best first: international sides and franchises, men's or women's, active in the last two years by default. Costs 2 credits.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"active_since": {
"description": "Only teams with a match since this date (YYYY-MM-DD; default two years ago).",
"type": "string"
},
"format": {
"enum": [
"test",
"odi",
"t20",
"first_class",
"list_a"
],
"type": "string"
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
},
"limit": {
"maximum": 300,
"minimum": 1,
"type": "integer"
},
"team_type": {
"enum": [
"international",
"club"
],
"type": "string"
}
},
"required": [
"format"
],
"type": "object"
},
"name": "get_ratings",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"active_since": {
"type": "string"
},
"count": {
"type": "number"
},
"format": {
"type": "string"
},
"method": {
"type": "string"
},
"ratings": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
}
},
"required": [
"format",
"active_since",
"ratings",
"count",
"method"
],
"type": "object"
}
},
{
"description": "Use for upcoming and live matches in every competition, soonest first: start time, teams, venue, status, each side's current rating where we rate it, and the favourite at the median sportsbook price where one is posted. A fixture keeps its match id once played, so get_match takes it then. Costs 2 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"competition": {
"description": "Competition key, e.g. bbl, ipl, test, t20i.",
"type": "string"
},
"days": {
"description": "Days ahead (default 7).",
"maximum": 45,
"minimum": 1,
"type": "integer"
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"include_live": {
"description": "Include matches in progress (default true).",
"type": "boolean"
},
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
},
"team_id": {
"description": "Team id from list_teams.",
"type": "string"
}
},
"type": "object"
},
"name": "get_schedule",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"days": {
"type": "number"
},
"matches": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
}
},
"required": [
"days",
"matches",
"count"
],
"type": "object"
}
},
{
"description": "Use for how a ground plays, by format: average first- and second-innings totals, how often the side batting first wins, how often the toss winner wins and what captains choose, and draws. Match by part of the ground or city name. Costs 5 credits.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"competition": {
"description": "Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...).",
"type": "string"
},
"format": {
"enum": [
"test",
"odi",
"t20",
"first_class",
"list_a"
],
"type": "string"
},
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
},
"since": {
"description": "Only matches from this date (YYYY-MM-DD).",
"type": "string"
},
"venue": {
"description": "Part of the ground or city, e.g. \"wankhede\" or \"adelaide\".",
"type": "string"
}
},
"required": [
"venue"
],
"type": "object"
},
"name": "get_venue",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"by_format": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"count": {
"type": "number"
},
"note": {
"type": "string"
},
"venues": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
}
},
"required": [
"venues",
"by_format",
"count",
"note"
],
"type": "object"
}
},
{
"description": "Use for a limited-overs match's win-probability worm: our chance the batting side wins at the end of every over (and from team 1's side), with the ten balls that moved it most. Costs 10 credits.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
},
"match_id": {
"description": "Match id from get_matches.",
"type": "string"
}
},
"required": [
"match_id"
],
"type": "object"
},
"name": "get_win_probability",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"biggest_swings": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"count": {
"type": "number"
},
"match_id": {
"type": "string"
},
"method": {
"type": "string"
},
"overs": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"team1_id": {
"type": "string"
},
"team2_id": {
"type": "string"
},
"winner_id": {
"type": [
"string",
"null"
]
}
},
"required": [
"match_id",
"team1_id",
"team2_id",
"winner_id",
"overs",
"biggest_swings",
"count",
"method"
],
"type": "object"
}
},
{
"description": "Use to see every competition we hold and its key: format, men's or women's, international or club, match count, first and last match, seasons. Costs 1 credit.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"format": {
"description": "test, odi, t20 (T20Is and T20 leagues), first_class, list_a.",
"enum": [
"test",
"odi",
"t20",
"first_class",
"list_a"
],
"type": "string"
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_competitions",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"competitions": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"count": {
"type": "number"
}
},
"required": [
"competitions",
"count"
],
"type": "object"
}
},
{
"description": "Use for team ids: international sides and franchises, most matches first. Women's sides end in -women (india-women). A renamed side lists its current id in now_plays_as, and filtering on either finds both. Filter by competition, season, gender or part of a name. Costs 1 credit.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"competition": {
"description": "Competition key from list_competitions (ipl, bbl, psl, blast, hundred, county, test, odi, t20i, ...).",
"type": "string"
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
},
"search": {
"description": "Part of the team name.",
"type": "string"
},
"season": {
"description": "Season: a year (2024) or a split season (2024/25); a year also finds the split season that starts in it.",
"type": "string"
}
},
"type": "object"
},
"name": "list_teams",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"teams": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
}
},
"required": [
"teams",
"count"
],
"type": "object"
}
},
{
"description": "Use to find a player's id by name (the scorecard short form, \"V Kohli\", or the full name), most matches first and their last team. Or list a team's players with team_id. Costs 1 credit.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"league": {
"description": "League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.",
"enum": [
"cricket",
"test",
"odi",
"t20i",
"ipl",
"bbl",
"psl",
"cpl",
"blast",
"hundred",
"sa20",
"ilt20",
"county",
"wbbl",
"wpl",
"hundred_women"
],
"type": "string"
},
"limit": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Part of the name, e.g. \"kohli\".",
"type": "string"
},
"team_id": {
"description": "Team id from list_teams.",
"type": "string"
}
},
"type": "object"
},
"name": "search_players",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"players": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
}
},
"required": [
"players",
"count"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:4a6d41d3f88bcadbb74781203f48de648ccc08bfbf7435d88f79f2069726d216 | sha256sum