Your first call

Sign up for a free key (500 credits, no card), swap it in for YOUR_API_KEY, and send this. get_standings costs 2 credits.

Request

curl -X POST https://mcp.dunkapi.com/v1/get_standings \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "season": 2024
}'

Response

json

{
  "season": 2024,
  "standings": [
    {
      "team_id": "2",
      "abbrev": "BOS",
      "display_name": "Boston Celtics",
      "conference": "Eastern",
      "wins": 64,
      "losses": 18,
      "conf_wins": 0,
      "conf_losses": 0,
      "home_wins": 37,
      "home_losses": 4,
  ...

First 14 lines. Full response and every field

REST / cURL

POST to /v1/{tool_name} with your params as JSON body. No MCP client needed:

bash

curl -X POST https://mcp.dunkapi.com/v1/list_teams \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY"

With parameters:

bash

curl -X POST https://mcp.dunkapi.com/v1/get_standings \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"season":2024}'

Claude Desktop

Add to your claude_desktop_config.json:

json

{
  "mcpServers": {
    "dunkapi": {
      "url": "https://mcp.dunkapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}

Claude Code

One command:

bash

claude mcp add dunkapi https://mcp.dunkapi.com/mcp?key=YOUR_API_KEY --transport streamable-http

Find the right call

All 16 questions

Endpoints

16 endpoints by category. Each page has parameters, requests in three formats, a full example response and every response field.

Static reference1 credit/call

Basic lookup2 credits/call

Stats + aggregation5 credits/call

Multi-table10 credits/call

Time-series10 credits/call

get_line_movement10 creditsDaily snapshots of each sportsbook's line before tip-off

Reference

Authentication

Every request requires an API key. Pass it via header or query parameter:

bash

x-api-key: YOUR_API_KEY
# or
Authorization: Bearer YOUR_API_KEY
# or (MCP only)
?key=YOUR_API_KEY

Verify your email, then create an API key from the dashboard. Free accounts get 500 credits.

Base URL

text

https://mcp.dunkapi.com

REST API: POST /v1/{tool} with JSON body. Works with cURL, Python, any HTTP client.

MCP: POST /mcp via Streamable HTTP. Works with Claude Desktop, Claude Code, Cursor, and any MCP client.

Rate limits

Credit balance	Rate limit
100 credits or more	60 req/min
Under 100 credits	10 req/min

The limit is the same on every plan. It is burst protection, not the spend boundary; credits are that, and they are enforced per request. Running low slows you down so you notice before the balance reaches zero.

Error handling

Code	Meaning	What to do
400	Invalid parameters	Check required fields and value types
401	Invalid or missing API key	Check your x-api-key header
402	Insufficient credits	Top up your wallet or upgrade your plan
429	Rate limit exceeded	Wait and retry (see limits above)
500	Server error	Retry with idempotency key. Credits auto-refund on server errors.

Pass x-idempotency-key or x-request-id headers to make retries duplicate-safe.

Data coverage

Women's National Basketball Association (WNBA)

DunkAPI also serves the WNBA. Pass "league": "wnba" to any tool that lists it, or connect to https://mcp.dunkapi.com/mcp/wnba. What the WNBA data covers.

NCAA Division I men's basketball (NCAAM)

DunkAPI also serves the NCAAM. Pass "league": "ncaam" to any tool that lists it, or connect to https://mcp.dunkapi.com/mcp/ncaam. What the NCAAM data covers.

NCAA Division I women's basketball (NCAAW)

DunkAPI also serves the NCAAW. Pass "league": "ncaaw" to any tool that lists it, or connect to https://mcp.dunkapi.com/mcp/ncaaw. What the NCAAW data covers.

Data	Status	Coverage	Volume
Games and box scores Scores, both teams' box scores and every player's line: minutes, points, shooting, rebounds, assists, steals, blocks, turnovers, fouls, plus-minus. list_games get_game get_player get_player_games About one game in eight from 2012-13 to 2017-18 has no box score in the source; those lines are counted from the play-by-play (97-100% exact where checked), without minutes or plus-minus. 26 games have a box score but no play-by-play.	Partial	2003-04 to current	Every game, every player
Play-by-play Every play with clock, score, players involved, shot type and points. get_plays	Available	2003-04 to current	About 450 plays per NBA game
Shot locations Each shot's x/y in feet, distance, zone and our expected points. get_shot_chart get_plays	Available	2003-04 to current	Every field goal attempt
Win probability The home team's win probability after each play, as ESPN computes it. get_plays get_game From 2017-18 only.	Partial	2018 to current	After every play
Odds Moneyline, spread and total by sportsbook; opening and closing from 2023-24, the final pregame line before that. get_odds get_line_movement get_schedule No lines before 2012-13; mostly one book per game since 2024-25; no player props.	Partial	2013-14 to current	4 to 12 books per regular-season game to 2023-24, usually one since
Ratings Our Elo, before and after every game. get_ratings	Available	2003-04 to current	Every team, every game
Injury report Each listed player's status, injury and expected return, captured daily (NBA and WNBA). get_injuries Daily captures from launch; no history before that.	Partial	From launch	Daily

Coverage describes the datasets DunkAPI supports. Freshness and operational health are tracked separately.

Odds snapshot definitions

opening: The first line a sportsbook posted for the game, as ESPN reports it (from 2023-24).

closing: The sportsbook's last line before tip-off.

Odds coverage currently documents the books ESPN reports: 4 to 12 per regular-season NBA game from 2013-14 to 2023-24, 10 to 12 from 2020-21 (DraftKings, Caesars, BetMGM, Unibet and Betfair among them in 2023-24), then usually ESPN BET or DraftKings alone. No lines before 2012-13, and most games since 2024-25 have one book. Before 2023-24, ESPN keeps each sportsbook's final pregame line, stored as the close, for 4 to 12 books per regular-season NBA game from 2013-14 (10 to 12 from 2020-21). From 2023-24 there are opening and closing lines, and from 2024-25 usually one book (ESPN BET, later DraftKings). Daily snapshots before each game from launch.

Response format

REST API

All successful REST responses wrap the result in a data key:

json

{ "data": { "teams": [...], "count": 32 } }

Error responses return:

json

{ "error": "Insufficient credits", "message": "This tool costs 5 credits, you have 2" }

MCP Protocol

MCP responses follow the standard MCP tool result format. The data is returned directly (no data wrapper). Both access methods return identical data, just different envelopes.

Conventions

Seasons: the year the season ends (2025 = 2024-25); WNBA: the calendar year. Example: 2025.

Game IDs: an ESPN game id, e.g. 401705127 (an ESPN game id; find them with list_games). Get them from get_games or get_schedule.

Team abbreviations: Standard codes (BOS, LAL, NY (or an ESPN team id); list_teams has them). Use list_teams if unsure.

Pagination: Endpoints use a limit parameter. No cursor or offset. Narrow your filters to get different slices of data.

Credits: Deducted before the request executes. Automatically refunded on server errors. Monthly credits are used first, then wallet balance.

Documentation

Your first call

Request

Response

REST / cURL

Claude Desktop

Claude Code

Find the right call

Endpoints

Static reference1 credit/call

Basic lookup2 credits/call

Stats + aggregation5 credits/call

Multi-table10 credits/call

Time-series10 credits/call

Reference

Authentication

Base URL

Rate limits

Error handling

Data coverage

Women's National Basketball Association (WNBA)

NCAA Division I men's basketball (NCAAM)

NCAA Division I women's basketball (NCAAW)

Odds snapshot definitions

Response format

REST API

MCP Protocol

Conventions

Ready to start?