Hoops MCP

Never let your AI guess a stat again.

Hoops MCP gives Claude and any MCP client checked NBA numbers, so you can ask about a playoff run, an MVP case or the latest injury report and get the real answer.

Get an API keyConnect your agent
A guard rises for a free throw while players line the lane

Top teams

Best record, 2025-26

  1. 1ThunderOklahoma City64-18
  2. 2SpursSan Antonio62-20
  3. 3PistonsDetroit60-22
  4. 4CelticsBoston56-26
  5. 5NuggetsDenver54-28

Power ranking

Point differential per game

  1. 1ThunderOklahoma City+11.1
  2. 2SpursSan Antonio+8.3
  3. 3PistonsDetroit+8.2
  4. 4CelticsBoston+7.7
  5. 5KnicksNew York+6.4

MVP race

Production times team win %

  1. 1Nikola JokicDEN35.2
  2. 2Shai Gilgeous-AlexanderOKC34.5
  3. 3Luka DoncicLAL33.4
  4. 4Victor WembanyamaSA33.0
  5. 5Cade CunninghamDET30.4

Fantasy leaders

Fantasy points per game

  1. 1Nikola JokicDEN65.8
  2. 2Luka DoncicLAL61.5
  3. 3Victor WembanyamaSA55.8
  4. 4Shai Gilgeous-AlexanderOKC52.8
  5. 5Cade CunninghamDET51.9

Live from the store, 2025-26. Power ranking is points for minus points against. MVP race and fantasy are our own formulas, not awards or league rankings. MVP race: (pts + reb + ast + stl + blk) × team win %. Fantasy: pts + 1.2 reb + 1.5 ast + 3 stl + 3 blk, turnovers are not on file.

Bring your own agent.

Any MCP client that can reach a remote server and send a header can use it. These are popular ones; check your client's docs for adding a remote MCP server.

  • Claude
  • ChatGPT
  • Gemini
  • Copilot
  • VS Code
  • Windsurf
  • Perplexity

Ask it like this.

You write plain English. Your agent picks the tool and answers from the rows. These replies are built from what is on file right now.

Which teams have the best point differential this season?

get_team_stats

Oklahoma City Thunder lead at +11.1 a game, then Spurs (+8.3) and Pistons (+8.2).

Your agent subtracts points against from points for.

Who has the best MVP case right now?

get_top_players + get_team_stats

Nikola Jokic (DEN): 27.7 points, 12.9 rebounds and 10.7 assists a game.

Your agent combines each player’s production with his team’s record.

Who won the most recent title?

get_playoff_teams

New York Knicks won the 2025-26 championship.

Every playoff team comes back with its seed and the round it reached.

How banged up is the league right now?

get_injuries

81 players are on the injury report, 58 ruled out, across 28 teams.

Filter by team or status to get the names.

Looking up through a red rim and worn net at a bright sky
  • Dashboards and botsPull checked rows instead of scraping sources that break.
  • Fantasy researchAsk who deserves a roster spot and get the numbers behind the answer.
  • Prediction gamesCheck who is hurt and who is hot before you lock your picks.
  • Playoff talkSeeds, rounds reached and champions for the last three seasons.

Four lookups. Zero guessing.

Each tool publishes its output schema, so your agent knows exactly what comes back before it asks.

ToolYou askFilter byYou get
get_team_stats“How good were the Celtics in 2023-24?”league, season, teamRecord, points for and against, rebounds, assists and shooting splits
get_playoff_teams“Who made the playoffs and how far did they get?”league, seasonEvery playoff team with its seed, the round it reached and the champion
get_top_players“Who are the top-tier centers this season?”league, season, position, tier, limitRank, 10% tier, points, rebounds, assists, steals and blocks
get_injuries“Who's out for the Knicks right now?”league, team, statusPlayer, status, the injury and the expected return when known

Real rows, on file right now.

This page reads the same store your agent does, so every figure here, and the four lists up top, come straight from the rows on file.

  • NBA champions on file
  • 2025-26New York Knicks
  • 2024-25Oklahoma City Thunder
  • 2023-24Boston Celtics
  • Injury report
  • Listed81
  • Ruled out58
  • Teams affected28
  • Coverage, latest season 2025-26
  • Teams30
  • Seasons3
  • Ranked players120

Wrong stats never reach your agent.

Your agent only reads our store. A schedule fills it, and nothing unchecked gets in.

  1. ESPNPublic league data
  2. Daily ingestOnce a day, never per request
  3. Schema checkRows that fail are rejected
  4. StoreCloudflare D1
  5. MCP toolsRead the store only
  6. Your agentGets a typed answer

ESPN can go down

Requests never touch ESPN. If it has a bad afternoon, your agent still gets the last good data.

Bad rows stay out

Every row is checked against a schema before it is stored. If ESPN changes its format, the ingest fails loudly instead of feeding your agent junk.

Know what you get

Each tool publishes its output schema, so your agent can rely on the shape of every answer.

Connect in one command so you can start asking.

Add the server to your MCP client with your key, then ask your agent a basketball question in plain English.

Claude Code
claude mcp add --transport http hoops https://mcp.ballknowledge.win/mcp \
  --header "Authorization: Bearer YOUR_KEY"
Any MCP client (JSON)
{
  "mcpServers": {
    "hoops": {
      "url": "https://mcp.ballknowledge.win/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Send the key as a Bearer token or an x-api-key header. 60 requests a minute per key.

Orange and teal court paint with white lane and arc lines

Get your key. Give your agent the numbers.

Keys are issued by hand for now. Email what you are building and which MCP client you use.

Request an API key

hello@ballknowledge.win