DunkAPI

npx add-mcp 'https://mcp.dunkapi.com/mcp'

Servidor MCP DunkAPI

A API de dados de basquete. Play-by-play da NBA com a localização de cada arremesso, box scores, probabilidade de vitória, classificações, lesões, nossas próprias classificações Elo de times, linhas de casas de apostas e linhas de props de jogadores, além da WNBA e do basquete universitário masculino e feminino da Divisão I. API REST e servidor MCP. 500 créditos grátis, sem cartão.

Site: https://dunkapi.com · Documentação: https://dunkapi.com/docs · Obtenha uma chave: 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]

Início rápido

Este é um servidor MCP hospedado (remoto) via Streamable HTTP. Não há nada para instalar.

Claude Code

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

Claude Desktop, Cursor e outros clientes

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

A chave também pode ser enviada como um cabeçalho x-api-key ou Authorization: Bearer. Conectar e listar ferramentas funciona sem chave; chamar uma ferramenta exige uma.

REST

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

Cada ferramenta é POST /v1/{tool} com um corpo JSON.

Exemplos

Exemplos executáveis em Python (apenas biblioteca padrão) e Node 18+ (sem dependências) estão em examples/:

• examples/python/quickstart.py e examples/node/quickstart.mjs: agenda e uma chamada principal.
• examples/python/nba_player_props.py: linhas de props de jogadores contra resultados.

export DUNKAPI_API_KEY=your_key
python3 examples/python/quickstart.py
node examples/node/quickstart.mjs

Veja examples/README.md para detalhes. Obtenha uma chave gratuita (500 créditos por mês, sem cartão) em https://dunkapi.com/signup.

Ferramentas (18)

Ferramenta	O que retorna
list_teams	IDs de times, abreviações e cores para uma temporada
search_players	Encontre jogadores por nome
list_games	Jogos com placares por temporada, data, intervalo ou time
get_schedule	Próximos jogos com a linha mediana entre casas de apostas
get_standings	Classificações de cada jogo final: geral, conferência, casa, fora, últimos 10
get_injuries	O relatório de lesões mais recente: status, lesão e retorno esperado (NBA, WNBA)
get_ratings	Nossas classificações Elo de times, ranqueadas
get_game	Um jogo: ambos os box scores, a linha de cada jogador, a linha de cada casa, probabilidade de vitória
get_player	Perfil, médias por temporada e divisões de arremessos, últimos 10 jogos
get_player_games	O registro completo de jogos de um jogador
get_leaders	Líderes da temporada por jogo, por porcentagem ou no total
get_team_stats	Ritmo, rating ofensivo, defensivo e líquido, e os quatro fatores
get_odds	Moneyline, spread e total de cada casa de apostas para um jogo (5) ou um dia (10), com resultados contra a linha
get_plays	Play-by-play com localizações de arremessos, zonas, pontos esperados e probabilidade de vitória
get_shot_chart	Perfil de arremessos por zona para um jogador, time ou defesa, com o x/y de cada arremesso
get_line_movement	Instantâneos da linha de cada casa de apostas antes do início
get_player_props	Linhas de props de jogadores por casa de apostas, abertura e fechamento
get_prop_history	As linhas de props de um jogador contra o resultado, jogo a jogo

Ligas: nba (padrão), wnba, ncaam, ncaaw (passe league para qualquer ferramenta).

Dados

• Jogos da NBA desde 2003-04 com play-by-play e localizações de arremessos (x/y, zona, pontos esperados, probabilidade de vitória)
• A WNBA e o basquete universitário masculino e feminino da Divisão I pelas mesmas ferramentas
• Classificações Elo de times, classificações de cada jogo final, relatório de lesões (NBA, WNBA)
• Moneylines, spreads e totais por casa de apostas: 4 a 12 casas por jogo regular da NBA de 2013-14 a 2023-24 (10 a 12 desde 2020-21), além de linhas de abertura e fechamento da The Odds API desde julho de 2020 (uma mediana de 7 casas por jogo da NBA em 2020-21 a 2022-23, 8 desde então); instantâneos de linhas pré-jogo desde o lançamento: da ESPN uma vez por dia, da The Odds API a cada hora para jogos nos próximos dois dias
• Linhas de props de jogadores por casa de apostas (pontos, rebotes, assistências, cestas de três, pontos + rebotes + assistências, bloqueios, roubos) desde maio de 2023 para a NBA e a WNBA e desde a temporada 2023-24 para o basquete universitário masculino, com o resultado contra cada linha (get_player_props, get_prop_history)
• Basquete universitário feminino: linhas de abertura e fechamento desde novembro de 2024 (uma mediana de 4 casas); sem props de jogadores

Cobertura por temporada, lida ao vivo do banco de dados: https://dunkapi.com/docs

Preços

500 créditos grátis no cadastro, sem cartão. Planos: Starter $19/mês (10.000 créditos), Pro $49/mês (30.000), Scale $149/mês (125.000). Recargas de carteira a partir de $5, nunca expiram. https://dunkapi.com/pricing

Atribuição

Dados de basquete de dados públicos da ESPN; linhas de casas de apostas e props de jogadores da ESPN e da The Odds API. As classificações são nossas. Não afiliado à NBA, WNBA, NCAA ou a qualquer time.

Licença

MIT para o conteúdo deste repositório. Termos de dados conforme acima.