Skip to main content
Glama

DunkAPI

Server Details

NBA, WNBA and college basketball data: play-by-play, shot locations, box scores, odds. REST and MCP.

Ownership verified
Status
Healthy
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
noahowsh/dunkapi-mcp
GitHub Stars
0

TDQS

Score is being calculated.

Available Tools

18 tools
get_game
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
game_idYesESPN game id, from list_games or get_schedule.

Output Schema

ParametersJSON Schema
NameRequiredDescription
gameYes
oddsYes
playsYes
playersYes
team_statsYes
box_score_noteNo
win_probabilityYes
get_injuries
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateNoThe report as of this day, YYYY-MM-DD (default: the latest).
teamNoOne team (id or abbreviation).
leagueNoLeague. Defaults to nba. One of: nba, wnba.

Output Schema

ParametersJSON Schema
NameRequiredDescription
dateYes
noteNo
countYes
injuriesYes
get_leaders
Read-only
Inspect

Use for a season's statistical leaders (per game, shooting percentages with a volume floor, or totals) from every box score. Costs 5 credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
statYesStat to rank by.
limitNo
leagueNoLeague. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
seasonNoSeason by the year it ends: 2025 = 2024-25 (default: the latest).
min_gamesNoMinimum games played (default: a quarter of the season).
season_typeNoDefault regular.

Output Schema

ParametersJSON Schema
NameRequiredDescription
statYes
countYes
labelYes
seasonYes
leadersYes
min_gamesYes
get_line_movement
Read-only
Inspect

Use to see how a game's line moved before tip-off: our pre-game snapshots of each sportsbook's moneyline, spread and total (ESPN's once a day, The Odds API's every hour for games in the next two days). Costs 10 credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
game_idYesGame id.
providerNoOne sportsbook, e.g. DraftKings.

Output Schema

ParametersJSON Schema
NameRequiredDescription
gameYes
noteNo
movementYes
snapshotsYes
get_odds
Read-only
Inspect

Use for betting lines: each sportsbook's moneyline, spread and total for a game (opening and closing per book from July 2020 from The Odds API, and from 2023-24 from ESPN; ESPN's final line only 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).

ParametersJSON Schema
NameRequiredDescriptionDefault
dateNoA day's games, YYYY-MM-DD (US Eastern).
leagueNoLeague. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
game_idNoOne game.

Output Schema

ParametersJSON Schema
NameRequiredDescription
noteNo
toolNo
countNo
gamesNo
creditsNo
estimate_onlyNo
get_player
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
player_idYesESPN athlete id, from search_players.

Output Schema

ParametersJSON Schema
NameRequiredDescription
playerYes
seasonsYes
recent_gamesYes
get_player_games
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMax games (default 100).
leagueNoLeague. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
offsetNo
seasonNoSeason by the year it ends: 2025 = 2024-25 (default: the latest).
player_idYesESPN athlete id.
season_typeNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
gamesYes
player_idYes
next_offsetNo
get_player_props
Read-only
Inspect

Use for player prop lines by sportsbook: over/under on points, rebounds, assists, threes, points + rebounds + assists, blocks and steals, from May 2023 for the NBA and WNBA and the 2023-24 season for men's college basketball (DraftKings, FanDuel, BetMGM, ESPN BET, Pinnacle and others). Pass game_id for every player's props in one game (10 credits), or player_id with from_date (and to_date) for one player across games (10 credits per game returned, up to 100). Returns the closing line by default (the last before the game starts) or the opening line, with each book's over and under prices. Set estimate_only to get the price without being charged.

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to nba. One of: nba, wnba, ncaam.
marketNoOne market: player_points (points), player_rebounds (rebounds), player_assists (assists), player_threes (three-pointers made), player_points_rebounds_assists (points + rebounds + assists), player_blocks (blocks), player_steals (steals)
game_idNoGame id: every player's props for that game.
to_dateNoWith player_id: last date (default: no end), YYYY-MM-DD (the game's date).
bookmakerNoBookmaker key, e.g. draftkings, fanduel, pinnacle.
from_dateNoWith player_id: first date, YYYY-MM-DD (the game's date).
player_idNoPlayer id (e.g. 3945274) from search_players. With from_date: that player's props across games.
estimate_onlyNoReturn what this call would cost, without charging or running it.
snapshot_typeNoclosing (default): the last line before the game starts. opening: the first one captured.

Output Schema

ParametersJSON Schema
NameRequiredDescription
noteNo
toolNo
countNo
gamesNo
propsNo
creditsNo
estimate_onlyNo
snapshot_typeNo
next_from_dateNo
credits_per_gameNo
get_plays
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
madeNoOnly made (true) or missed (false) shots.
teamNoA team's plays (id or abbreviation).
zoneNoOne shot zone.
limitNoMax plays (default 200).
clutchNoLast 5 minutes of the 4th quarter (college men: 2nd half) or overtime, score within 5.
leagueNoLeague. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
offsetNo
periodNo
seasonNoSeason by the year it ends (default: the latest; ignored with game_id).
game_idNoOne game: every play in order.
player_idNoA player's plays (with season).
shots_onlyNoField goal and free throw attempts only.
season_typeNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
playsYes
next_offsetNo
get_prop_history
Read-only
Inspect

Use to see how a player did against his prop line over time: for one market (points, rebounds, assists, threes, points + rebounds + assists, blocks or steals), one row per game with the closing line (the median across books, or one book's), the opening line, the prices, what the player actually recorded from our box scores and the result against the line, plus the over rate. Costs 10 credits for up to 200 games.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoGames to return, oldest first (default 50, max 200). next_from_date says where to continue.
leagueNoLeague. Defaults to nba. One of: nba, wnba, ncaam.
marketYesThe market: player_points (points), player_rebounds (rebounds), player_assists (assists), player_threes (three-pointers made), player_points_rebounds_assists (points + rebounds + assists), player_blocks (blocks), player_steals (steals)
to_dateNoLast date, YYYY-MM-DD (the game's date).
bookmakerNoOne book's closing line instead of the median across books, e.g. draftkings.
from_dateNoFirst date, YYYY-MM-DD (the game's date).
player_idYesPlayer id (e.g. 3945274) from search_players.

Output Schema

ParametersJSON Schema
NameRequiredDescription
noteNo
statYes
toolNo
countYes
gamesYes
marketYes
creditsNo
summaryYes
bookmakerYes
player_idYes
truncatedNo
player_nameYes
estimate_onlyNo
next_from_dateNo
get_ratings
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
seasonNoSeason by the year it ends (default: the latest).

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
methodYes
seasonYes
ratingsYes
get_schedule
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
daysNoDays ahead (default 7).
teamNoTeam id or abbreviation.
leagueNoLeague. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.

Output Schema

ParametersJSON Schema
NameRequiredDescription
daysYes
countYes
gamesYes
get_shot_chart
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
teamNoTeam id or abbreviation.
leagueNoLeague. Defaults to nba. One of: nba, wnba.
seasonNoSeason by the year it ends (default: the latest).
game_idNo
opponentNoWith team: the shots its opponents took (its defence).
player_idNo
season_typeNo
include_shotsNoAdd each shot's x, y and result (up to 3,000).

Output Schema

ParametersJSON Schema
NameRequiredDescription
noteNo
shareNo
shotsNo
zonesYes
seasonYes
shots_noteNo
unlocated_noteNo
unlocated_attemptsNo
field_goal_attemptsYes
get_standings
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
seasonNoSeason by the year it ends (default: the latest).

Output Schema

ParametersJSON Schema
NameRequiredDescription
noteYes
countYes
seasonYes
standingsYes
get_team_stats
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
teamNoOne team (id or abbreviation).
leagueNoLeague. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
seasonNoSeason by the year it ends: 2025 = 2024-25 (default: the latest).
season_typeNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
teamsYes
methodYes
seasonYes
list_games
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
toNoTo date, YYYY-MM-DD.
dateNoOne date, YYYY-MM-DD (US Eastern).
fromNoFrom date, YYYY-MM-DD.
teamNoTeam id or abbreviation.
limitNoMax games (default 50).
leagueNoLeague. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
offsetNoPage offset; use next_offset.
seasonNoSeason by the year it ends: 2025 = 2024-25.
statusNo
season_typeNoregular, postseason, play_in or preseason.

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
gamesYes
next_offsetNo
list_teams
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
seasonNoSeason by the year it ends: 2025 = 2024-25. WNBA: the calendar year.

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
teamsYes
seasonYes
search_players
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesFull or partial name.
limitNo
leagueNoLeague. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
playersYes

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 18 tool updates
    • First observedget_game
    • First observedget_injuries
    • First observedget_leaders
    • First observedget_line_movement
    • First observedget_odds
    • First observedget_player
    • First observedget_player_games
    • First observedget_player_props
    • First observedget_plays
    • First observedget_prop_history
    • First observedget_ratings
    • First observedget_schedule
    • First observedget_shot_chart
    • First observedget_standings
    • First observedget_team_stats
    • First observedlist_games
    • First observedlist_teams
    • First observedsearch_players

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    MCP server for NBA live data and stats, providing read-only tools to query live scores, box scores, player info, standings, and more from NBA.com.
    15
    14 npm
    1
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Get live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, soccer, and more via MCP.
    139 npm
    2
    Apache 2.0
  • A
    license
    A
    quality
    A
    maintenance
    Live sports betting player props MCP server covering NBA, MLB, NFL, NHL, NCAA, and soccer. Unified from real sportsbooks into one REST API and a real MCP server (Streamable HTTP). Free tier, no card required.
    5
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    MCP server for querying validated EuroLeague and EuroCup basketball analytics, including possession-based metrics, four factors, and lineup-level on/off data reconstructed from play-by-play events.
    MIT
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.