DunkAPI
Datos de baloncesto de la NBA, WNBA y universitario: jugada por jugada, ubicaciones de tiros, estadísticas de juego y probabilidades. REST y MCP.
Servidor MCP alojado
npx add-mcp 'https://mcp.dunkapi.com/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Servidor MCP de DunkAPI
La API de datos de baloncesto. NBA jugada a jugada con la ubicación de cada tiro, box scores, probabilidad de victoria, clasificaciones, lesiones, nuestras propias calificaciones Elo de equipos, líneas de casas de apuestas y líneas de props de jugadores, además de la WNBA y el baloncesto universitario de la División I masculino y femenino. API REST y servidor MCP. 500 créditos gratis, sin tarjeta.
Sitio web: https://dunkapi.com · Documentación: https://dunkapi.com/docs · Obtén una clave: 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]
Inicio rápido
Este es un servidor MCP alojado (remoto) sobre HTTP Streamable. No hay nada que instalar.
Claude Code
claude mcp add --transport http dunkapi "https://mcp.dunkapi.com/mcp?key=YOUR_API_KEY"
Claude Desktop, Cursor y otros clientes
{
"mcpServers": {
"dunkapi": {
"url": "https://mcp.dunkapi.com/mcp?key=YOUR_API_KEY"
}
}
}
La clave también se puede enviar como un encabezado x-api-key o Authorization: Bearer. Conectarse y listar herramientas funciona sin clave; llamar a una herramienta requiere una.
REST
curl -X POST https://mcp.dunkapi.com/v1/list_teams -H "x-api-key: YOUR_API_KEY"
Cada herramienta es POST /v1/{tool} con un cuerpo JSON.
Ejemplos
Ejemplos ejecutables en Python (solo biblioteca estándar) y Node 18+ (sin dependencias) viven en examples/:
examples/python/quickstart.pyyexamples/node/quickstart.mjs: calendario más una llamada destacada.examples/python/nba_player_props.py: líneas de props de jugadores contra resultados.
export DUNKAPI_API_KEY=your_key
python3 examples/python/quickstart.py
node examples/node/quickstart.mjs
Consulta examples/README.md para más detalles. Obtén una clave gratuita (500 créditos al mes, sin tarjeta) en https://dunkapi.com/signup.
Herramientas (18)
| Herramienta | Qué devuelve |
|---|---|
list_teams | IDs de equipos, abreviaturas y colores para una temporada |
search_players | Encuentra jugadores por nombre |
list_games | Partidos con marcadores por temporada, fecha, rango o equipo |
get_schedule | Próximos partidos con la línea mediana entre casas de apuestas |
get_standings | Clasificaciones de cada partido final: general, conferencia, local, visitante, últimos 10 |
get_injuries | El último informe de lesiones: estado, lesión y fecha de regreso esperada (NBA, WNBA) |
get_ratings | Nuestras calificaciones Elo de equipos, clasificadas |
get_game | Un partido: ambos box scores, la línea de cada jugador, la línea de cada casa, probabilidad de victoria |
get_player | Perfil, promedios por temporada y splits de tiro, últimos 10 partidos |
get_player_games | El registro completo de partidos de un jugador |
get_leaders | Líderes de temporada por partido, por porcentaje o en total |
get_team_stats | Ritmo, rating ofensivo, defensivo y neto, y los cuatro factores |
get_odds | Moneyline, spread y total de cada casa de apuestas para un partido (5) o un día (10), con resultados contra la línea |
get_plays | Jugada a jugada con ubicaciones de tiro, zonas, puntos esperados y probabilidad de victoria |
get_shot_chart | Perfil de tiro por zona para un jugador, equipo o defensa, con la x/y de cada tiro |
get_line_movement | Instantáneas de la línea de cada casa de apuestas antes del salto inicial |
get_player_props | Líneas de props de jugadores por casa de apuestas, apertura y cierre |
get_prop_history | Las líneas de props de un jugador contra el resultado, partido a partido |
Ligas: nba (predeterminada), wnba, ncaam, ncaaw (pasa league a cualquier herramienta).
Datos
- Partidos de la NBA desde 2003-04 con jugada a jugada y ubicaciones de tiro (x/y, zona, puntos esperados, probabilidad de victoria)
- La WNBA y el baloncesto universitario de la División I masculino y femenino a través de las mismas herramientas
- Calificaciones Elo de equipos, clasificaciones de cada partido final, informe de lesiones (NBA, WNBA)
- Moneylines, spreads y totales por casa de apuestas: de 4 a 12 casas por partido de temporada regular de la NBA desde 2013-14 hasta 2023-24 (de 10 a 12 desde 2020-21), más líneas de apertura y cierre de The Odds API desde julio de 2020 (una mediana de 7 casas por partido de la NBA en 2020-21 a 2022-23, 8 desde entonces); instantáneas de líneas previas al partido desde el lanzamiento: las de ESPN una vez al día, las de The Odds API cada hora para partidos en los próximos dos días
- Líneas de props de jugadores por casa de apuestas (puntos, rebotes, asistencias, triples, puntos + rebotes + asistencias, bloqueos, robos) desde mayo de 2023 para la NBA y la WNBA y desde la temporada 2023-24 para el baloncesto universitario masculino, con el resultado contra cada línea (
get_player_props,get_prop_history) - Baloncesto universitario femenino: líneas de apertura y cierre desde noviembre de 2024 (una mediana de 4 casas); sin props de jugadores
Cobertura por temporada, leída en vivo desde la base de datos: https://dunkapi.com/docs
Precios
500 créditos gratis al registrarte, sin tarjeta. Planes: Starter $19/mes (10,000 créditos), Pro $49/mes (30,000), Scale $149/mes (125,000). Recargas de cartera desde $5, nunca caducan. https://dunkapi.com/pricing
Atribución
Datos de baloncesto de datos públicos de ESPN; líneas de casas de apuestas y props de jugadores de ESPN y The Odds API. Las calificaciones son nuestras. No afiliado con la NBA, WNBA, NCAA ni ningún equipo.
Licencia
MIT para el contenido de este repositorio. Términos de datos como se indican arriba.