plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "dunkapi",
  "version": "1.0.0",
  "description": "DunkAPI brings NBA basketball data into ChatGPT and Codex with read-only tools and workflow skills: standings, schedules and scores, box scores, player averages and game logs, leaders, team ratings, play-by-play, shot charts, sportsbook odds, line movement and player prop lines. Sign in with your DunkAPI account.",
  "author": {
    "name": "DunkAPI",
    "email": "support@dunkapi.com",
    "url": "https://dunkapi.com"
  },
  "homepage": "https://dunkapi.com",
  "repository": "https://github.com/noahowsh/dunkapi-mcp",
  "license": "MIT",
  "keywords": [
    "nba",
    "sports-data",
    "sports-analytics",
    "stats",
    "dunkapi"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "DunkAPI",
        "shortDescription": "NBA basketball data and stats",
        "longDescription": "DunkAPI connects ChatGPT and Codex to NBA basketball data from DunkAPI. It covers the NBA since 2004 with every shot located, the WNBA since 2006, and Division I men's and women's college basketball.\n\nAsk for standings, schedules and scores, box scores, player averages and game logs, leaders, team ratings, play-by-play, shot charts, sportsbook odds, line movement and player prop lines. The plugin looks the answer up with read-only tools and reports what the data says, including the season, date and source of each number.\n\nThe first time you use it, you sign in with your DunkAPI account.\n\nLimits: DunkAPI is read-only. It cannot place wagers, accept or track bets, or edit your account. Odds and prop lines are shown as information about the market, not as advice. Data comes from public sources and the DunkAPI pipeline and is not guaranteed to be error-free or current to the minute, so do not rely on it as the sole basis for financial decisions. Ratings shown are DunkAPI's own Elo-style ratings, not official rankings. Not affiliated with the NBA or any team.\n\nBundled skills teach the model how to choose the right tool for a question and how to explain results.",
        "developerName": "DunkAPI",
        "category": "Data & Analytics",
        "capabilities": [
          "Look up NBA, WNBA and college teams and players",
          "Read standings, schedules and scores",
          "Read box scores, leaders and team stats",
          "Read play-by-play and shot charts",
          "Read sportsbook odds and prop lines (information only)"
        ],
        "websiteURL": "https://dunkapi.com",
        "supportURL": "https://dunkapi.com/support",
        "privacyPolicyURL": "https://dunkapi.com/privacy",
        "termsOfServiceURL": "https://dunkapi.com/terms",
        "defaultPrompt": [
          "Show the 2024-25 NBA standings.",
          "Find Jalen Brunson and show his 2025-26 season averages.",
          "Who were the top three NBA scorers per game in 2024-25?"
        ],
        "brandColor": "#C8981B",
        "brandColorDark": "#FBBF24",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "League standings",
              "prompt": "Show the 2024-25 NBA standings.",
              "tools_triggered": "get_standings",
              "expected_behavior": "Returns all 30 teams with wins and losses. The top three are Oklahoma City 68-14, Cleveland 64-18 and Boston 61-21."
            },
            {
              "description": "Player lookup and averages",
              "prompt": "Find Jalen Brunson and show his 2025-26 season averages.",
              "tools_triggered": "search_players, get_player",
              "expected_behavior": "Finds Jalen Brunson (player id 3934672, New York Knicks, G, #11), then returns season rows. The 2025-26 regular season row shows 75 games, 35.2 minutes, 26.0 points, 3.3 rebounds and 6.8 assists per game."
            },
            {
              "description": "Scores for a date",
              "prompt": "What were the NBA scores on April 12, 2026?",
              "tools_triggered": "list_games",
              "expected_behavior": "Returns final games for 2026-04-12 including Dallas 149, Chicago 128; Houston 132, Memphis 101; and Minnesota 132, New Orleans 126."
            },
            {
              "description": "Scoring leaders",
              "prompt": "Who were the NBA's top three scorers per game in 2024-25?",
              "tools_triggered": "get_leaders",
              "expected_behavior": "Returns points-per-game leaders with at least 20 games: Shai Gilgeous-Alexander (OKC) 32.7, Giannis Antetokounmpo (MIL) 30.4, Nikola Jokic (DEN) 29.6."
            },
            {
              "description": "Team ratings",
              "prompt": "Which NBA teams have the highest Elo ratings right now?",
              "tools_triggered": "get_ratings",
              "expected_behavior": "Returns ranked Elo team ratings. On 2026-10-14 the latest ratings were New York 1808.1, San Antonio 1767.9, Oklahoma City 1748.3, Detroit 1652.4, Boston 1640.7 (as of June 2026), and the reply states these are DunkAPI's own ratings."
            }
          ],
          "negative": [
            {
              "description": "Place a wager: wagering is not supported",
              "prompt": "Place a $50 bet on the Knicks to win tonight."
            },
            {
              "description": "Out of coverage: another sport",
              "prompt": "Show me the current NFL standings."
            },
            {
              "description": "Account and billing change: not supported",
              "prompt": "Buy 10,000 more credits and upgrade my plan to the highest tier."
            }
          ]
        },
        "demo_recording_url": "https://dwwkiy1hwsshare7.public.blob.vercel-storage.com/review/dunkapi-chatgpt-walkthrough-xe3953ccVY3Z9tFO2s74SNwjvsAVWT.mp4",
        "commerce": false,
        "commerce_description": "DunkAPI does not sell anything through ChatGPT. The plugin is read-only: it has no checkout, purchase, subscription or credit top-up flow."
      },
      "publication": {
        "release_notes": "Initial release. Read-only NBA basketball data tools with OAuth sign-in and 14 workflow skills."
      },
      "apps": "./.app.json"
    }
  }
}