{"sport":"nba","brand":"DunkAPI","base_url":"https://mcp.dunkapi.com","mcp_url":"https://mcp.dunkapi.com/mcp","tools":[{"name":"list_teams","description":"Use to find team ids and abbreviations for a season (default: the latest). Every other tool takes a team as an id or abbreviation. Pass league for the WNBA (wnba) or college (ncaam, ncaaw); default NBA. Costs 1 credit.","credits":1,"category":"Static reference","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"season":{"description":"Season by the year it ends: 2025 = 2024-25. WNBA: the calendar year.","type":["number","string"]},"league":{"description":"League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.","type":"string","enum":["nba","wnba","ncaam","ncaaw"]}},"additionalProperties":false}},{"name":"list_games","description":"Use to list games with scores by season, date, date range or team, newest first. For upcoming games with lines use get_schedule; for one game's box score use get_game. Costs 2 credits.","credits":2,"category":"Basic lookup","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"season":{"description":"Season by the year it ends: 2025 = 2024-25.","type":["number","string"]},"season_type":{"description":"regular, postseason, play_in or preseason.","type":"string","enum":["regular","postseason","play_in","preseason"]},"team":{"description":"Team id or abbreviation.","type":"string"},"date":{"description":"One date, YYYY-MM-DD (US Eastern).","type":"string"},"from":{"description":"From date, YYYY-MM-DD.","type":"string"},"to":{"description":"To date, YYYY-MM-DD.","type":"string"},"status":{"type":"string","enum":["scheduled","final"]},"limit":{"description":"Max games (default 50).","type":"integer","minimum":1,"maximum":200},"offset":{"description":"Page offset; use next_offset.","type":"integer","minimum":0,"maximum":9007199254740991},"league":{"description":"League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.","type":"string","enum":["nba","wnba","ncaam","ncaaw"]}},"additionalProperties":false}},{"name":"get_schedule","description":"Use for upcoming games (next 1-30 days, default 7) with the median line across posted sportsbooks: spread, total and moneylines. For every book's line use get_odds. Costs 2 credits.","credits":2,"category":"Basic lookup","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"days":{"description":"Days ahead (default 7).","type":"integer","minimum":1,"maximum":30},"team":{"description":"Team id or abbreviation.","type":"string"},"league":{"description":"League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.","type":"string","enum":["nba","wnba","ncaam","ncaaw"]}},"additionalProperties":false}},{"name":"get_game","description":"Use for one game in full: score, both teams' box scores, every player's line, each sportsbook's opening and closing line, and the win-probability range. For the play-by-play use get_plays. Costs 5 credits.","credits":5,"category":"Stats + aggregation","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"game_id":{"type":"string","description":"ESPN game id, from list_games or get_schedule."},"league":{"description":"League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.","type":"string","enum":["nba","wnba","ncaam","ncaaw"]}},"required":["game_id"],"additionalProperties":false}},{"name":"get_standings","description":"Use for a season's regular-season standings computed from every final game: overall, conference, home and away records, points for and against, margin and last 10. Costs 2 credits.","credits":2,"category":"Basic lookup","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"season":{"description":"Season by the year it ends (default: the latest).","type":["number","string"]},"league":{"description":"League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.","type":"string","enum":["nba","wnba","ncaam","ncaaw"]}},"additionalProperties":false}},{"name":"get_injuries","description":"Use for the injury report: every listed player's status (out, day-to-day), injury and expected return, as captured on the latest day (or the latest on or before date). NBA and WNBA. Costs 2 credits.","credits":2,"category":"Basic lookup","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"team":{"description":"One team (id or abbreviation).","type":"string"},"date":{"description":"The report as of this day, YYYY-MM-DD (default: the latest).","type":"string"},"league":{"description":"League. Defaults to nba. One of: nba, wnba.","type":"string","enum":["nba","wnba"]}},"additionalProperties":false}},{"name":"search_players","description":"Use to find a player's id by name (partial names work), most recent players first. Pass league for the WNBA (wnba) or college (ncaam, ncaaw); default NBA. Costs 1 credit.","credits":1,"category":"Static reference","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","description":"Full or partial name."},"limit":{"type":"integer","minimum":1,"maximum":50},"league":{"description":"League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.","type":"string","enum":["nba","wnba","ncaam","ncaaw"]}},"required":["name"],"additionalProperties":false}},{"name":"get_player","description":"Use for a player's profile, per-season averages and shooting splits (regular season and postseason separately) and last 10 games. For every game use get_player_games. 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":"ESPN athlete id, from search_players."},"league":{"description":"League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.","type":"string","enum":["nba","wnba","ncaam","ncaaw"]}},"required":["player_id"],"additionalProperties":false}},{"name":"get_player_games","description":"Use for a player's game log: every game's box-score line with opponent and result, newest first, optionally one 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":"ESPN athlete id."},"season":{"description":"Season by the year it ends: 2025 = 2024-25 (default: the latest).","type":["number","string"]},"season_type":{"type":"string","enum":["regular","postseason","play_in","preseason"]},"limit":{"description":"Max games (default 100).","type":"integer","minimum":1,"maximum":200},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"league":{"description":"League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.","type":"string","enum":["nba","wnba","ncaam","ncaaw"]}},"required":["player_id"],"additionalProperties":false}},{"name":"get_leaders","description":"Use for a season's statistical leaders (per game, shooting percentages with a volume floor, or totals) from every box score. 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":["pts","reb","ast","stl","blk","tpm","min","plus_minus","fg_pct","tp_pct","ft_pct","ts_pct","total_pts"],"description":"Stat to rank by."},"season":{"description":"Season by the year it ends: 2025 = 2024-25 (default: the latest).","type":["number","string"]},"season_type":{"description":"Default regular.","type":"string","enum":["regular","postseason","play_in","preseason"]},"min_games":{"description":"Minimum games played (default: a quarter of the season).","type":"integer","minimum":1,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":100},"league":{"description":"League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.","type":"string","enum":["nba","wnba","ncaam","ncaaw"]}},"required":["stat"],"additionalProperties":false}},{"name":"get_team_stats","description":"Use for team efficiency for a season: pace, offensive, defensive and net rating per 100 possessions, the four factors (eFG%, turnover %, offensive rebound %, free throw rate) and three-point rate, from every box score. Costs 5 credits.","credits":5,"category":"Stats + aggregation","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"season":{"description":"Season by the year it ends: 2025 = 2024-25 (default: the latest).","type":["number","string"]},"season_type":{"type":"string","enum":["regular","postseason","play_in","preseason"]},"team":{"description":"One team (id or abbreviation).","type":"string"},"league":{"description":"League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.","type":"string","enum":["nba","wnba","ncaam","ncaaw"]}},"additionalProperties":false}},{"name":"get_plays","description":"Use for play-by-play: every event of a game, or a player's or team's plays across a season, with shot location (feet), zone, our expected points, the score and the home win probability after each play (2018 on). Filter to shots, makes or misses, a zone, a period or clutch time. Pass league for the WNBA (wnba) or college (ncaam, ncaaw); default NBA. Costs 10 credits.","credits":10,"category":"Multi-table","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"game_id":{"description":"One game: every play in order.","type":"string"},"player_id":{"description":"A player's plays (with season).","type":"string"},"team":{"description":"A team's plays (id or abbreviation).","type":"string"},"season":{"description":"Season by the year it ends (default: the latest; ignored with game_id).","type":["number","string"]},"season_type":{"type":"string","enum":["regular","postseason","play_in","preseason"]},"shots_only":{"description":"Field goal and free throw attempts only.","type":"boolean"},"made":{"description":"Only made (true) or missed (false) shots.","type":"boolean"},"zone":{"description":"One shot zone.","type":"string","enum":["restricted_area","paint","midrange","corner_3","above_break_3","free_throw"]},"period":{"type":"integer","minimum":1,"maximum":10},"clutch":{"description":"Last 5 minutes of the 4th quarter (college men: 2nd half) or overtime, score within 5.","type":"boolean"},"limit":{"description":"Max plays (default 200).","type":"integer","minimum":1,"maximum":1000},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"league":{"description":"League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.","type":"string","enum":["nba","wnba","ncaam","ncaaw"]}},"additionalProperties":false}},{"name":"get_shot_chart","description":"Use for a shot profile: attempts, makes, percentage, points per shot and expected points per shot in each zone (restricted area, paint, midrange, corner three, above-the-break three, free throws) for a player, a team, a team's opponents or one game. include_shots adds every located shot's x/y and result for drawing a chart. Costs 10 credits.","credits":10,"category":"Multi-table","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"player_id":{"type":"string"},"team":{"description":"Team id or abbreviation.","type":"string"},"opponent":{"description":"With team: the shots its opponents took (its defence).","type":"boolean"},"game_id":{"type":"string"},"season":{"description":"Season by the year it ends (default: the latest).","type":["number","string"]},"season_type":{"type":"string","enum":["regular","postseason","play_in","preseason"]},"include_shots":{"description":"Add each shot's x, y and result (up to 3,000).","type":"boolean"},"league":{"description":"League. Defaults to nba. One of: nba, wnba.","type":"string","enum":["nba","wnba"]}},"additionalProperties":false}},{"name":"get_odds","description":"Use for betting lines: each sportsbook's moneyline, spread and total for a game (opening and closing from 2023-24; the final line before that), with implied probabilities and, for finished games, whether the home side covered and the total went over against the median close. Pass game_id for one game (5 credits) or date for a day's games (10 credits).","credits":5,"category":"Stats + aggregation","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"game_id":{"description":"One game.","type":"string"},"date":{"description":"A day's games, YYYY-MM-DD (US Eastern).","type":"string"},"league":{"description":"League. Defaults to nba. One of: nba, wnba, ncaam.","type":"string","enum":["nba","wnba","ncaam"]}},"additionalProperties":false}},{"name":"get_line_movement","description":"Use to see how a game's line moved before tip-off: our daily snapshot of each sportsbook's moneyline, spread and total. Costs 10 credits.","credits":10,"category":"Time-series","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"game_id":{"type":"string","description":"Game id."},"provider":{"description":"One sportsbook, e.g. DraftKings.","type":"string"},"league":{"description":"League. Defaults to nba. One of: nba, wnba, ncaam.","type":"string","enum":["nba","wnba","ncaam"]}},"required":["game_id"],"additionalProperties":false}},{"name":"get_ratings","description":"Use for our team power ratings (Elo from every final game in our data), ranked, as of the end of a season or today. Costs 2 credits.","credits":2,"category":"Basic lookup","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"season":{"description":"Season by the year it ends (default: the latest).","type":["number","string"]},"league":{"description":"League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.","type":"string","enum":["nba","wnba","ncaam","ncaaw"]}},"additionalProperties":false}}]}