Prototype · Preview: every server in the official registry, synced every 30 minutes. Reviews and accounts come in a later step.
PopNx MCPMCP servers for people who use AI · explained in plain words

DunkAPI

by noahowshversion 1.1.6i★ –iRuns in the cloud
Registry nameio.github.noahowsh/dunkapi

Install

Overview

Description from the maker (original English)

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

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

  • Connection: Runs in the cloud
  • Transport: Streamable HTTP
  • Category: Travel, maps & weather
  • You need to fill in: x-api-key

Install

Pick the AI app you use, then copy the settings.

Before you install

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

Which app do you use?

Pick your app above. We remember it, so next time the button says “Install in …”.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Run this in your terminal

claude mcp add --transport http dunkapi https://mcp.dunkapi.com/mcp --header 'x-api-key: your-value'

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "dunkapi": {
      "url": "https://mcp.dunkapi.com/mcp",
      "headers": {
        "x-api-key": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "dunkapi": {
      "type": "http",
      "url": "https://mcp.dunkapi.com/mcp",
      "headers": {
        "x-api-key": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

  • x-api-key secret required HTTP header
    Your DunkAPI API key. Get a free key (500 credits every month) at dunkapi.com/signup

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Tool names and descriptions exactly as the server reported them on Nov 7, 2026. The maker wrote them, not us; we show them as plain text.

  • 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), college (ncaam, ncaaw) or Australia's NBL (nbl); default NBA. Costs 1 credit.

  • 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.

  • 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

  • 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, r

  • 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.

  • 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.

  • search_players

    Use to find a player's id by name (partial names work), most recent players first. Pass league for the WNBA (wnba), college (ncaam, ncaaw) or Australia's NBL (nbl); default NBA. Costs 1 credit.

  • 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.

  • 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.

  • 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.

  • 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.

  • 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. P

  • 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 locat

  • 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 ov

  • 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 pro

  • 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.

  • get_player_props

    Use for player prop lines by sportsbook: over/under on points, rebounds, assists, threes, blocks, steals, the combos (points + rebounds + assists, points + rebounds, points + assists, rebounds + assists) and double- and triple-doubles (the NBA has them all; the WNBA has no blocks

  • get_prop_history

    Use to see how a player did against his prop line over time: for one market (points, rebounds, assists, threes, blocks, steals, one of the combos (points + rebounds + assists, points + rebounds, points + assists, rebounds + assists), double-double or triple-double), one row per g

  • get_prop_movement

    Use to see how one player's prop line moved before a game: every capture we hold, book by book and oldest first, with the line, both prices and the minutes before the start. line_change is the last capture's line minus the first's. The number of captures varies by game and book.

  • get_market_odds

    Use for the extra betting markets of a game as history: the 1st half and 1st quarter winner, point spread and total, and the 2nd, 3rd and 4th quarter totals (NBA only). Pass game_id (from list_games or get_schedule) and market. For each sportsbook it returns the opening line (the

  • get_game_probabilities

    Use for what the market thinks of one game, not any one book's price: the average implied probability (margin in) and the fair probability (margin out) for the moneyline, each spread and each total, with how many books each rests on. Only identical lines are combined. Each book's

  • get_prop_probabilities

    Use for what the market thinks of the player props in one game, not any one book's price: for each player and each line, the average implied probability (margin in) and the fair probability (margin out), with how many books each rests on. Only identical lines are combined, and a

  • get_prop_backtest

    Use to test an idea about player props without pulling every row: how often a kind of prop went over or under against what the market implied, across every finished game we hold prices for that fits your filters. Returns the hit rate, its 95% interval, the average implied and fai

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account noahowsh, which owns the repo

  • … Not checked yet

    Still maintained

    We have not read this repo from GitHub yet

  • … Not checked yet

    Has a licence

    We have not read this repo from GitHub yet

  • ✓ Pass

    Endpoint responds

    Responded in 398 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 23 tool descriptions and found no hidden instructions to the AI

Compared with others in Travel, maps & weatheri

  • More stars than 0% of the other 1711 servers in this category
  • Published to the registry more recently than 58% of the other 1711 servers in this category
  • Basic checks equal to or better than 100% of the other 1711 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is DunkAPI safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: x-api-key

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.1.6) reached the registry 22 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Reel-E, Agro API MCP by usefulapi, FieldClimate MCP by usefulapi

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Reel-E

by reel-e.ai

Make and edit real estate listing videos, photos and websites from your AI assistant.

Runs in the cloudUpdated today
Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

DunkAPI MCP server

The basketball data API. NBA play-by-play with the location of every shot, box scores, win probability, standings, injuries, our own team Elo ratings, sportsbook lines and player prop lines, plus the WNBA and men's and women's Division I college basketball. REST API and MCP server. 500 free credits every month, no card.

Website: https://dunkapi.com · Docs: https://dunkapi.com/docs · Get a key: https://dunkapi.com/signup

You:    "What was each sportsbook's closing spread for every Celtics home game in 2023-24?"

Claude: [calls get_odds]

You: "Which players took the most shots at the rim in the 2025 playoffs?" Claude: [calls get_shot_chart]

You: "How often has Jalen Brunson gone over his points line this season?" Claude: [calls get_prop_history]

Run it locally (stdio)

Most clients connect to https://mcp.dunkapi.com/mcp directly. For a client that launches a local process instead:

git clone https://github.com/noahowsh/dunkapi-mcp.git && cd dunkapi-mcp && npm install

DUNKAPI_API_KEY=your_key node index.js

{ "mcpServers": { "dunkapi": { "command": "node", "args": ["/path/to/dunkapi-mcp/index.js"], "env": { "DUNKAPI_API_KEY": "your_key" } } } }

It forwards to the hosted server with your key, so every tool and credit cost is the same.

Skills

skills/ holds 16 free Claude skills that turn Claude into a basketball analyst for the NBA, WNBA and men's and women's college basketball. A skill is a markdown file: when to use it, which DunkAPI tools it calls and what they cost, the method (shot zones and expected points, pace and efficiency, rolling game logs, prop modeling, devigging, backtesting), and examples taken from real API responses.

git clone https://github.com/noahowsh/dunkapi-mcp.git

Or install them as a Claude Code plugin:

/plugin marketplace add noahowsh/dunkapi-mcp

/plugin install dunkapi-skills@dunkapi

Or with the skills CLI: npx skills add noahowsh/dunkapi-mcp.

Point Claude at the skills/ folder, connect the MCP server below, and ask a question. Start with the dispatch skill if you are not sure which one applies. Skills also work on your own CSV or JSON files, with no key. Full list: skills/README.md.

Python

The official Python client is on PyPI: dunkapi.

pip install dunkapi

export DUNKAPI_API_KEY=sk_live_...

from dunkapi import Client, to_dataframe

client = Client()

props = client.get_player_props( game_id="401810726", market="player_points", bookmaker="draftkings", ) df = to_dataframe(props, key="props") print(df[["player_name", "line", "over_odds", "under_odds"]].head(10))

Typed errors for a bad key, no credits left, not found and rate limits, automatic retries, and to_dataframe for pandas.

Quick start

This is a hosted (remote) MCP server over Streamable HTTP. There is nothing to install.

Claude Code

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

Claude Desktop, Cursor and other clients

{

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

The key can also be sent as an x-api-key header or Authorization: Bearer. Connecting and listing tools works without a key; calling a tool needs one.

REST

curl -X POST https://mcp.dunkapi.com/v1/list_teams -H "x-api-key: YOUR_API_KEY"

Every tool is POST /v1/{tool} with a JSON body.

Examples

Runnable Python (standard library only) and Node 18+ (no dependencies) examples live in examples/:

  • examples/python/quickstart.py and examples/node/quickstart.mjs: schedule plus a headline call.
  • examples/python/nba_player_props.py: Player prop lines against results.
export DUNKAPI_API_KEY=your_key

python3 examples/python/quickstart.py node examples/node/quickstart.mjs

See examples/README.md for details. Get a free key (500 credits a month, no card) at https://dunkapi.com/signup.

Tools (18)

ToolWhat it returns
list_teamsTeam ids, abbreviations and colours for a season
search_playersFind players by name
list_gamesGames with scores by season, date, range or team
get_scheduleUpcoming games with the median line across sportsbooks
get_standingsStandings from every final game: overall, conference, home, away, last 10
get_injuriesThe latest injury report: status, injury and expected return (NBA, WNBA)
get_ratingsOur team Elo ratings, ranked
get_gameOne game: both box scores, every player's line, each book's line, win probability
get_playerProfile, per-season averages and shooting splits, last 10 games
get_player_gamesA player's full game log
get_leadersSeason leaders per game, by percentage or in total
get_team_statsPace, offensive, defensive and net rating, and the four factors
get_oddsEvery sportsbook's moneyline, spread and total for a game (5) or a day (10), with results against the line
get_playsPlay-by-play with shot locations, zones, expected points and win probability
get_shot_chartShot profile by zone for a player, team or defence, with every shot's x/y
get_line_movementSnapshots of each sportsbook's line before tip-off
get_player_propsPlayer prop lines by sportsbook, opening and closing
get_prop_historyA player's prop lines against the result, game by game

Leagues: nba (default), wnba, ncaam, ncaaw (pass league to any tool).

Data

  • NBA games since 2003-04 with play-by-play and shot locations (x/y, zone, expected points, win probability)
  • The WNBA and men's and women's Division I college basketball through the same tools
  • Team Elo ratings, standings from every final game, injury report (NBA, WNBA)
  • Per-sportsbook moneylines, spreads and totals: 4 to 12 books per regular-season NBA game from 2013-14 to 2023-24 (10 to 12 from 2020-21), plus opening and closing lines since July 2020 (a median of 7 books per NBA game in 2020-21 to 2022-23, 8 since); pre-game line snapshots from launch: once a day, and every hour for games in the next two days
  • Player prop lines by sportsbook (points, rebounds, assists, threes, points + rebounds + assists, blocks, steals) from May 2023 for the NBA and WNBA and from the 2023-24 season for men's college basketball, with the result against each line (get_player_props, get_prop_history)
  • Women's college basketball: opening and closing lines from November 2024 (a median of 4 books); no player props

Coverage by season, read live from the database: https://dunkapi.com/docs

Useful pages

Pricing

500 free credits every month, no card. Plans: Starter $19/mo (10,000 credits), Pro $49/mo (30,000), Scale $149/mo (125,000). Wallet top-ups from $5, never expire. https://dunkapi.com/pricing

Attribution

Ratings are ours. Not affiliated with the NBA, WNBA, NCAA or any team.

License

MIT for the contents of this repository. Data terms as above.

Use with Codex

Add this repo as a Codex plugin marketplace, then install the plugin:

codex plugin marketplace add noahowsh/dunkapi-mcp

Then open the plugin directory in Codex and install dunkapi-skills from the dunkapi marketplace. The plugin bundles the skills in skills/ and the DunkAPI MCP server (https://mcp.dunkapi.com/mcp). Set your key first (free at https://dunkapi.com/signup):

export DUNKAPI_API_KEY=your_key

Codex sends it as a bearer token.

Use with Gemini CLI

export DUNKAPI_API_KEY=your_key

gemini extensions install https://github.com/noahowsh/dunkapi-mcp

The extension adds the DunkAPI MCP server (https://mcp.dunkapi.com/mcp) and sends the key in the x-api-key header. Get a free key (500 credits a month) at https://dunkapi.com/signup.

Ask PopNx