# DunkAPI

> DunkAPI is a freemium MCP server for sports data. NBA play-by-play, shot charts, standings and sportsbook player props. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $19 a month
- **Platforms:** API, Web
- **Repository:** https://github.com/noahowsh/dunkapi-mcp
- **MCP Registry name:** io.github.noahowsh/dunkapi
- **Categories:** sports data, analytics and data
- **Listing updated:** 2026-11-16

## About

Play-by-play records carry shot locations, zone, expected points and win probability, which supports questions about shots at the rim or lineup trends. The data starts with the 2003-04 NBA season and extends to the WNBA and men's and women's Division I college basketball through the same tools.

A separate group of tools handles betting lines: moneylines, spreads and totals by sportsbook, opening and closing numbers, line movement snapshots, and player prop lines for points, rebounds, assists and threes, with results against each line. Prop coverage starts in May 2023 for the NBA and WNBA, and women's college has no props.

Standings, injuries, team Elo and box scores round it out. A key is needed to call tools; 500 free credits come each month.

## Features

- **Shot locations:** Every shot with x/y, zone and expected points.
- **Odds by book:** Moneyline, spread and total per sportsbook.
- **Line movement:** Snapshots of lines before tip-off.
- **Prop history:** A player's prop lines against results.
- **Team ratings:** Elo, pace and four-factor stats.
- **Four leagues:** NBA, WNBA, men's and women's college.

## Good for

- Chart a team's shot profile by zone
- Check how often a player cleared a points line
- Compare closing spreads across sportsbooks
- Read the latest injury report

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http dunkapi https://mcp.dunkapi.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.dunkapi.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "dunkapi": {
      "url": "https://mcp.dunkapi.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "dunkapi": {
      "type": "http",
      "url": "https://mcp.dunkapi.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "dunkapi": {
      "serverUrl": "https://mcp.dunkapi.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "dunkapi": {
      "type": "http",
      "url": "https://mcp.dunkapi.com/mcp"
    }
  }
}
```

## Tools

- `list_teams`: Team ids and colours
- `search_players`: Find players by name
- `list_games`: Games with scores
- `get_schedule`: Upcoming games with median lines
- `get_standings`: Standings
- `get_injuries`: Latest injury report
- `get_ratings`: Team Elo ratings
- `get_game`: Box scores, lines and win probability
- `get_player`: Profile and averages
- `get_player_games`: Game log
- `get_leaders`: Season leaders
- `get_team_stats`: Pace and efficiency ratings
- `get_odds`: Sportsbook moneyline, spread and total
- `get_plays`: Play-by-play with shot locations
- `get_shot_chart`: Shot profile by zone
- `get_line_movement`: Line snapshots before tip-off
- `get_player_props`: Player prop lines by sportsbook
- `get_prop_history`: Prop lines against results

## FAQ

### Which leagues are included?

NBA by default, plus WNBA, NCAAM and NCAAW.

### Since when are props tracked?

From May 2023 for the NBA and WNBA.

### Are there props for women's college?

No.

### Is it free?

500 credits a month are free; paid plans start at $19.

### Is DunkAPI free?

DunkAPI has a free plan, with paid plans for more usage or features. Paid plans start at $19 a month.

### How do I add DunkAPI to Claude Code?

Run this command in your terminal: claude mcp add --transport http dunkapi https://mcp.dunkapi.com/mcp

### What are the best alternatives to DunkAPI?

The closest alternatives to DunkAPI are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/dunkapi
