# DunkAPI [Health: Active]

**Category:** 🏃 Sports  
**Repository:** https://github.com/noahowsh/dunkapi-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/dunkapi

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

## Tools
Capabilities this server exposes over MCP:

- **list_teams** — Team ids, abbreviations and colours for a season
- **search_players** — Find players by name
- **list_games** — Games with scores by season, date, range or team
- **get_schedule** — Upcoming games with the median line across sportsbooks
- **get_standings** — Standings from every final game: overall, conference, home, away, last 10
- **get_injuries** — The latest injury report: status, injury and expected return (NBA, WNBA)
- **get_ratings** — Our team Elo ratings, ranked
- **get_game** — One game: both box scores, every player's line, each book's line, win probability
- **get_player** — Profile, per-season averages and shooting splits, last 10 games
- **get_player_games** — A player's full game log
- **get_leaders** — Season leaders per game, by percentage or in total
- **get_team_stats** — Pace, offensive, defensive and net rating, and the four factors
- **get_odds** — Every sportsbook's moneyline, spread and total for a game (5) or a day (10), with results against the line
- **get_plays** — Play-by-play with shot locations, zones, expected points and win probability
- **get_shot_chart** — Shot profile by zone for a player, team or defence, with every shot's x/y
- **get_line_movement** — Snapshots of each sportsbook's line before tip-off
- **get_player_props** — Player prop lines by sportsbook, opening and closing
- **get_prop_history** — A player's prop lines against the result, game by game

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What the DunkAPI MCP server does

DunkAPI MCP server connects an MCP client to DunkAPI's basketball data API. It covers NBA, WNBA, men's Division I college basketball, and women's Division I college basketball. The available data includes schedules, scores, standings, injuries, player profiles, team metrics, play-by-play events, shot coordinates, sportsbook lines, and player prop results.

The service is suitable for questions that require structured basketball data across games or seasons. Examples include comparing team efficiency, reviewing a player's game log, identifying shot locations by zone, checking closing lines, or measuring a player's results against historical prop lines. League selection is supported through a `league` parameter, with NBA as the default.

## How it works

DunkAPI MCP server is hosted at `https://mcp.dunkapi.com/mcp` and uses Streamable HTTP, so there is no local MCP package to install. Add the endpoint to an MCP-compatible client and provide an API key in the URL, an `x-api-key` header, or an `Authorization: Bearer` header. A connection can enumerate the tools without authentication, but tool calls require a key.

The same service exposes REST-style POST endpoints at `/v1/{tool}`. Each request sends its arguments as JSON. The repository also includes standard-library Python and Node 18 examples, plus Claude skills that describe when to use the tools and how to analyze returned data. Those skills can be used with the server or with local CSV and JSON files; local-file use does not require an API key.

## Setup and configuration

For Claude Code, register the remote endpoint with its HTTP transport and an API key. Claude Desktop, Cursor, and other MCP clients can use the same URL in their MCP server configuration. The repository documents the following environment variable for its example scripts:

- `DUNKAPI_API_KEY`: API key used by the Python and Node examples.

Keys are available through DunkAPI's signup page. The service includes 500 free credits per month without a card; paid plans and additional credit options are described separately by the provider.

## Tools and capabilities

DunkAPI MCP server exposes 18 tools, including:

- Discover teams, players, games, schedules, standings, injuries, leaders, and Elo ratings.
- Retrieve player profiles, seasonal averages, shooting splits, recent games, and complete game logs.
- Inspect team pace, offensive rating, defensive rating, net rating, and the four factors.
- Query game box scores, player lines, win probabilities, play-by-play events, shot zones, and individual shot coordinates.
- Compare sportsbook moneylines, spreads, totals, line movement, player props, opening and closing prices, and results against the line.

## Limitations and notes

Coverage differs by league, season, and data type. NBA play-by-play and shot-location data extends back to the 2003-04 season. Prop availability begins in May 2023 for NBA and WNBA data and in the 2023-24 season for men's college basketball; women's college basketball has no player props in the stated coverage. Injury data is listed for NBA and WNBA, while sportsbook history varies by season and source.

The data combines public ESPN data with sportsbook information from ESPN and The Odds API. Team ratings are produced by DunkAPI. The provider states that it is not affiliated with the NBA, WNBA, NCAA, or any team, so applications should check the documented coverage before depending on a particular league, date range, sportsbook, or metric.

_Full upstream README: https://allmcps.com/mcp/dunkapi/readme_