Servers Playground How we check Submit a server

DunkAPI

Working · 1.3 s

io.github.noahowsh/dunkapiv1.1.6

NBA player props by sportsbook since 2023, plus play-by-play, shot locations and odds. REST and MCP.

Entertainment & Games

Source Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.dunkapi.com/mcp

x-api-key (required)

Your DunkAPI API key. Get a free key (500 credits every month) at dunkapi.com/signup

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

get_game

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. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

game_idstring, required

Game id, from list_games or get_schedule.

leaguestring

League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.

DunkAPI MCP server | mcptry

Tools (18)

get_game

read-only

Argument	Type	Description
league	string	League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
game_id*	string	Game id, from list_games or get_schedule.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "game_id"
  ],
  "properties": {
    "league": {
      "enum": [
        "nba",
        "wnba",
        "ncaam",
        "ncaaw"
      ],
      "type": "string",
      "description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw."
    },
    "game_id": {
      "type": "string",
      "description": "Game id, from list_games or get_schedule."
    }
  }
}

get_injuries

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.

read-only

Argument	Type	Description
date	string	The report as of this day, YYYY-MM-DD (default: the latest).
team	string	One team (id or abbreviation).
league	string	League. Defaults to nba. One of: nba, wnba.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "date": {
      "type": "string",
      "description": "The report as of this day, YYYY-MM-DD (default: the latest)."
    },
    "team": {
      "type": "string",
      "description": "One team (id or abbreviation)."
    },
    "league": {
      "enum": [
        "nba",
        "wnba"
      ],
      "type": "string",
      "description": "League. Defaults to nba. One of: nba, wnba."
    }
  }
}

get_leaders

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

read-only

Argument	Type	Description
stat*	string	Stat to rank by.
limit	integer
league	string	League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
season	number \| string	Season by the year it ends: 2025 = 2024-25 (default: the latest).
min_games	integer	Minimum games played (default: a quarter of the season).
season_type	string	Default regular.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "stat"
  ],
  "properties": {
    "stat": {
      "enum": [
        "pts",
        "reb",
        "ast",
        "stl",
        "blk",
        "tpm",
        "min",
        "plus_minus",
        "fg_pct",
        "tp_pct",
        "ft_pct",
        "ts_pct",
        "total_pts"
      ],
      "type": "string",
      "description": "Stat to rank by."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "league": {
      "enum": [
        "nba",
        "wnba",
        "ncaam",
        "ncaaw"
      ],
      "type": "string",
      "description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw."
    },
    "season": {
      "type": [
        "number",
        "string"
      ],
      "description": "Season by the year it ends: 2025 = 2024-25 (default: the latest)."
    },
    "min_games": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Minimum games played (default: a quarter of the season)."
    },
    "season_type": {
      "enum": [
        "regular",
        "postseason",
        "play_in",
        "preseason"
      ],
      "type": "string",
      "description": "Default regular."
    }
  }
}

get_line_movement

Use to see how a game's line moved before tip-off: our pre-game snapshots of each sportsbook's moneyline, spread and total (captured once a day, and every hour for games in the next four days). 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.

read-only

Argument	Type	Description
league	string	League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
game_id*	string	Game id.
provider	string	One sportsbook, e.g. DraftKings.
all_snapshots	boolean	Every hourly capture. By default a capture identical to the one before it is left out (the latest is always kept), which keeps every move and its time.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "game_id"
  ],
  "properties": {
    "league": {
      "enum": [
        "nba",
        "wnba",
        "ncaam",
        "ncaaw"
      ],
      "type": "string",
      "description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw."
    },
    "game_id": {
      "type": "string",
      "description": "Game id."
    },
    "provider": {
      "type": "string",
      "description": "One sportsbook, e.g. DraftKings."
    },
    "all_snapshots": {
      "type": "boolean",
      "description": "Every hourly capture. By default a capture identical to the one before it is left out (the latest is always kept), which keeps every move and its time."
    }
  }
}

get_odds

Use for betting lines: each sportsbook's moneyline, spread and total for a game (opening and closing per book from July 2020; before that, each book's final pregame line only), 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). Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

read-only

Argument	Type	Description
date	string	A day's games, YYYY-MM-DD (US Eastern).
league	string	League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
game_id	string	One game.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "date": {
      "type": "string",
      "description": "A day's games, YYYY-MM-DD (US Eastern)."
    },
    "league": {
      "enum": [
        "nba",
        "wnba",
        "ncaam",
        "ncaaw"
      ],
      "type": "string",
      "description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw."
    },
    "game_id": {
      "type": "string",
      "description": "One game."
    }
  }
}

get_player

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.

read-only

Argument	Type	Description
league	string	League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
player_id*	string	Player id, from search_players.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "player_id"
  ],
  "properties": {
    "league": {
      "enum": [
        "nba",
        "wnba",
        "ncaam",
        "ncaaw"
      ],
      "type": "string",
      "description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw."
    },
    "player_id": {
      "type": "string",
      "description": "Player id, from search_players."
    }
  }
}

get_player_games

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.

read-only

Argument	Type	Description
limit	integer	Max games (default 100).
league	string	League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
offset	integer
season	number \| string	Season by the year it ends: 2025 = 2024-25 (default: the latest).
player_id*	string	Player id.
season_type	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "player_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Max games (default 100)."
    },
    "league": {
      "enum": [
        "nba",
        "wnba",
        "ncaam",
        "ncaaw"
      ],
      "type": "string",
      "description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "season": {
      "type": [
        "number",
        "string"
      ],
      "description": "Season by the year it ends: 2025 = 2024-25 (default: the latest)."
    },
    "player_id": {
      "type": "string",
      "description": "Player id."
    },
    "season_type": {
      "enum": [
        "regular",
        "postseason",
        "play_in",
        "preseason"
      ],
      "type": "string"
    }
  }
}

get_player_props

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. Outside football the archive mostly holds one pre-game capture per line, so the opening and closing lines are usually the same; the opening line differs only where a second capture was taken (live capture from October 2026, and wherever else it is held). Set estimate_only to get the price without being charged. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

read-only

Argument	Type	Description
league	string	League. Defaults to nba. One of: nba, wnba, ncaam.
market	string	One 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_id	string	Game id: every player's props for that game.
to_date	string	With player_id: last date (default: no end), YYYY-MM-DD (the game's date).

get_plays

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.

read-only

Argument	Type	Description
made	boolean	Only made (true) or missed (false) shots.
team	string	A team's plays (id or abbreviation).
zone	string	One shot zone.
limit	integer	Max plays (default 200).
clutch	boolean	Last 5 minutes of the 4th quarter (college men: 2nd half) or overtime, score within 5.
league	string	League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
offset	integer
period	integer
season	number \| string

get_prop_history

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 same as the close wherever only one capture was taken), 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. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

read-only

Argument	Type	Description
limit	integer	Games to return, oldest first (default 50, max 200). next_from_date says where to continue.
league	string	League. Defaults to nba. One of: nba, wnba, ncaam.
market*	string	The 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_date	string	Last date, YYYY-MM-DD (the game's date).
bookmaker	string	One book's closing line instead of the median across books, e.g. draftkings.
from_date	string

get_ratings

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.

read-only

Argument	Type	Description
league	string	League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
season	number \| string	Season by the year it ends (default: the latest).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "league": {
      "enum": [
        "nba",
        "wnba",
        "ncaam",
        "ncaaw"
      ],
      "type": "string",
      "description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw."
    },
    "season": {
      "type": [
        "number",
        "string"
      ],
      "description": "Season by the year it ends (default: the latest)."
    }
  }
}

get_schedule

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. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

read-only

Argument	Type	Description
days	integer	Days ahead (default 7).
team	string	Team id or abbreviation.
league	string	League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 30,
      "minimum": 1,
      "description": "Days ahead (default 7)."
    },
    "team": {
      "type": "string",
      "description": "Team id or abbreviation."
    },
    "league": {
      "enum": [
        "nba",
        "wnba",
        "ncaam",
        "ncaaw"
      ],
      "type": "string",
      "description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw."
    }
  }
}

get_shot_chart

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.

read-only

Argument	Type	Description
team	string	Team id or abbreviation.
league	string	League. Defaults to nba. One of: nba, wnba.
season	number \| string	Season by the year it ends (default: the latest).
game_id	string
opponent	boolean	With team: the shots its opponents took (its defence).
player_id	string
season_type	string
include_shots	boolean	Add each shot's x, y and result (up to 3,000).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "team": {
      "type": "string",
      "description": "Team id or abbreviation."
    },
    "league": {
      "enum": [
        "nba",
        "wnba"
      ],
      "type": "string",
      "description": "League. Defaults to nba. One of: nba, wnba."
    },
    "season": {
      "type": [
        "number",
        "string"
      ],
      "description": "Season by the year it ends (default: the latest)."
    },
    "game_id": {
      "type": "string"
    },
    "opponent": {
      "type": "boolean",
      "description": "With team: the shots its opponents took (its defence)."
    },
    "player_id": {
      "type": "string"
    },
    "season_type": {
      "enum": [
        "regular",
        "postseason",
        "play_in",
        "preseason"
      ],
      "type": "string"
    },
    "include_shots": {
      "type": "boolean",
      "description": "Add each shot's x, y and result (up to 3,000)."
    }
  }
}

get_standings

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.

read-only

Argument	Type	Description
league	string	League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
season	number \| string	Season by the year it ends (default: the latest).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "league": {
      "enum": [
        "nba",
        "wnba",
        "ncaam",
        "ncaaw"
      ],
      "type": "string",
      "description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw."
    },
    "season": {
      "type": [
        "number",
        "string"
      ],
      "description": "Season by the year it ends (default: the latest)."
    }
  }
}

get_team_stats

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.

read-only

Argument	Type	Description
team	string	One team (id or abbreviation).
league	string	League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
season	number \| string	Season by the year it ends: 2025 = 2024-25 (default: the latest).
season_type	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "team": {
      "type": "string",
      "description": "One team (id or abbreviation)."
    },
    "league": {
      "enum": [
        "nba",
        "wnba",
        "ncaam",
        "ncaaw"
      ],
      "type": "string",
      "description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw."
    },
    "season": {
      "type": [
        "number",
        "string"
      ],
      "description": "Season by the year it ends: 2025 = 2024-25 (default: the latest)."
    },
    "season_type": {
      "enum": [
        "regular",
        "postseason",
        "play_in",
        "preseason"
      ],
      "type": "string"
    }
  }
}

list_games

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.

read-only

Argument	Type	Description
to	string	To date, YYYY-MM-DD.
date	string	One date, YYYY-MM-DD (US Eastern).
from	string	From date, YYYY-MM-DD.
team	string	Team id or abbreviation.
limit	integer	Max games (default 50).
league	string	League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
offset	integer	Page offset; use next_offset.
season	number \| string	Season by the year it ends: 2025 = 2024-25.
status	string
season_type	string

list_teams

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.

read-only

Argument	Type	Description
league	string	League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.
season	number \| string	Season by the year it ends: 2025 = 2024-25. WNBA: the calendar year.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "league": {
      "enum": [
        "nba",
        "wnba",
        "ncaam",
        "ncaaw"
      ],
      "type": "string",
      "description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw."
    },
    "season": {
      "type": [
        "number",
        "string"
      ],
      "description": "Season by the year it ends: 2025 = 2024-25. WNBA: the calendar year."
    }
  }
}

search_players

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.

read-only

Argument	Type	Description
name*	string	Full or partial name.
limit	integer
league	string	League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Full or partial name."
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1
    },
    "league": {
      "enum": [
        "nba",
        "wnba",
        "ncaam",
        "ncaaw"
      ],
      "type": "string",
      "description": "League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw."
    }
  }
}