{"sport":"cricket","brand":"YorkerAPI","base_url":"https://mcp.yorkerapi.com","mcp_url":"https://mcp.yorkerapi.com/mcp","tools":[{"name":"get_schedule","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: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.","credits":2,"category":"Basic lookup","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"competition":{"description":"Competition key, e.g. bbl, ipl, test, t20i.","type":"string"},"team_id":{"description":"Team id from list_teams.","type":"string"},"days":{"description":"Days ahead (default 7).","type":"integer","minimum":1,"maximum":45},"gender":{"type":"string","enum":["male","female"]},"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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"additionalProperties":false}},{"name":"list_competitions","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.","credits":1,"category":"Static reference","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"gender":{"type":"string","enum":["male","female"]},"format":{"description":"test, odi, t20 (T20Is and T20 leagues), first_class, list_a.","type":"string","enum":["test","odi","t20","first_class","list_a"]},"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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"additionalProperties":false}},{"name":"list_teams","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.","credits":1,"category":"Static reference","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"competition":{"description":"Competition key from list_competitions (ipl, bbl, psl, blast, hundred, county, test, odi, t20i, ...).","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"},"gender":{"type":"string","enum":["male","female"]},"search":{"description":"Part of the team name.","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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"additionalProperties":false}},{"name":"get_matches","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.","credits":2,"category":"Basic lookup","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"competition":{"description":"Competition key from list_competitions (ipl, bbl, psl, blast, hundred, county, test, odi, t20i, ...).","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"},"opponent_id":{"description":"Only matches against this team too.","type":"string"},"venue":{"description":"Part of the ground or city name.","type":"string"},"date":{"description":"A day the match was played (YYYY-MM-DD); multi-day matches match on any day.","type":"string"},"from":{"description":"Start date on or after (YYYY-MM-DD).","type":"string"},"to":{"description":"Start date on or before (YYYY-MM-DD).","type":"string"},"format":{"type":"string","enum":["test","odi","t20","first_class","list_a"]},"gender":{"type":"string","enum":["male","female"]},"limit":{"description":"Max matches (default 50).","type":"integer","minimum":1,"maximum":500},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"additionalProperties":false}},{"name":"get_match","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: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.","credits":5,"category":"Multi-table","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"match_id":{"type":"string","description":"Match id from get_matches or get_schedule."},"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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"required":["match_id"],"additionalProperties":false}},{"name":"get_deliveries","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.","credits":10,"category":"Time-series","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"match_id":{"description":"Match id from get_matches.","type":"string"},"innings":{"type":"integer","minimum":1,"maximum":8},"batter_id":{"description":"Player id from search_players.","type":"string"},"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"},"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"},"over_from":{"description":"First over, 0-based as scorers count (0 is the first over).","type":"integer","minimum":0,"maximum":9007199254740991},"over_to":{"description":"Last over, 0-based.","type":"integer","minimum":0,"maximum":9007199254740991},"wickets_only":{"type":"boolean"},"boundaries_only":{"type":"boolean"},"limit":{"description":"Max balls (default 600 for a match, 200 otherwise).","type":"integer","minimum":1,"maximum":3000},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"additionalProperties":false}},{"name":"search_players","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.","credits":1,"category":"Static reference","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"description":"Part of the name, e.g. \"kohli\".","type":"string"},"team_id":{"description":"Team id from list_teams.","type":"string"},"limit":{"type":"integer","minimum":1,"maximum":100},"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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"additionalProperties":false}},{"name":"get_player","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.","credits":5,"category":"Stats + aggregation","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"player_id":{"type":"string","description":"Player id from search_players."},"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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"required":["player_id"],"additionalProperties":false}},{"name":"get_player_stats","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.","credits":5,"category":"Stats + aggregation","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"player_id":{"type":"string","description":"Player id from search_players."},"by":{"description":"How to split (default format).","type":"string","enum":["season","competition","phase","format"]},"format":{"type":"string","enum":["test","odi","t20","first_class","list_a"]},"competition":{"description":"Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...).","type":"string"},"season":{"description":"Season: a year (2024) or a split season (2024/25).","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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"required":["player_id"],"additionalProperties":false}},{"name":"get_player_matches","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.","credits":5,"category":"Stats + aggregation","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"player_id":{"type":"string","description":"Player id from search_players."},"format":{"type":"string","enum":["test","odi","t20","first_class","list_a"]},"competition":{"description":"Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...).","type":"string"},"season":{"description":"Season: a year (2024) or a split season (2024/25).","type":"string"},"limit":{"description":"Max matches (default 50).","type":"integer","minimum":1,"maximum":500},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"required":["player_id"],"additionalProperties":false}},{"name":"get_matchup","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.","credits":5,"category":"Stats + aggregation","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"batter_id":{"type":"string","description":"Batter's player id."},"bowler_id":{"type":"string","description":"Bowler's player id."},"format":{"type":"string","enum":["test","odi","t20","first_class","list_a"]},"competition":{"description":"Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...).","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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"required":["batter_id","bowler_id"],"additionalProperties":false}},{"name":"get_leaders","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.","credits":5,"category":"Stats + aggregation","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"stat":{"type":"string","enum":["runs","batting_average","strike_rate","sixes","wickets","economy","bowling_average"]},"competition":{"description":"Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...).","type":"string"},"season":{"description":"Season: a year (2024) or a split season (2024/25).","type":"string"},"format":{"type":"string","enum":["test","odi","t20","first_class","list_a"]},"gender":{"type":"string","enum":["male","female"]},"min_balls":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":100},"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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"required":["stat"],"additionalProperties":false}},{"name":"get_ratings","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.","credits":2,"category":"Basic lookup","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"format":{"type":"string","enum":["test","odi","t20","first_class","list_a"]},"gender":{"type":"string","enum":["male","female"]},"team_type":{"type":"string","enum":["international","club"]},"active_since":{"description":"Only teams with a match since this date (YYYY-MM-DD; default two years ago).","type":"string"},"limit":{"type":"integer","minimum":1,"maximum":300},"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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"required":["format"],"additionalProperties":false}},{"name":"get_venue","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.","credits":5,"category":"Stats + aggregation","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"venue":{"type":"string","description":"Part of the ground or city, e.g. \"wankhede\" or \"adelaide\"."},"format":{"type":"string","enum":["test","odi","t20","first_class","list_a"]},"competition":{"description":"Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...).","type":"string"},"since":{"description":"Only matches from this date (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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"required":["venue"],"additionalProperties":false}},{"name":"get_win_probability","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.","credits":10,"category":"Time-series","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"match_id":{"type":"string","description":"Match id from get_matches."},"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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"required":["match_id"],"additionalProperties":false}},{"name":"get_market_vs_model","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.","credits":10,"category":"Time-series","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"match_id":{"type":"string","description":"Match id from get_matches."},"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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"required":["match_id"],"additionalProperties":false}},{"name":"get_odds","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: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.","credits":5,"category":"Multi-table","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"match_id":{"description":"Match id from get_matches.","type":"string"},"competition":{"description":"Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...).","type":"string"},"season":{"type":"string"},"date":{"description":"A day of the match (YYYY-MM-DD).","type":"string"},"limit":{"description":"Max matches (default 20).","type":"integer","minimum":1,"maximum":100},"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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"additionalProperties":false}},{"name":"get_line_movement","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: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.","credits":10,"category":"Time-series","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"match_id":{"type":"string","description":"Match id from get_matches."},"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.","type":"string","enum":["cricket","test","odi","t20i","ipl","bbl","psl","cpl","blast","hundred","sa20","ilt20","county","wbbl","wpl","hundred_women"]}},"required":["match_id"],"additionalProperties":false}}]}