BirdieAPI

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

Servidor MCP de BirdieAPI

La API de datos de golf. Tablas de clasificación del PGA Tour con posiciones finales, ganancias y puntos, puntuaciones por ronda y tarjetas hoyo a hoyo, campos con par y yardaje por hoyo, historial de jugadores y campos, nuestra propia calificación de golpes frente al campo, desgloses de puntuación en pares 3/4/5 y los precios de los ganadores de los cuatro grandes masculinos por casa de apuestas. El LPGA, LIV, el DP World Tour y el Korn Ferry Tour utilizan las mismas herramientas. API REST y servidor MCP. 500 créditos gratuitos, sin tarjeta.

Sitio web: https://birdieapi.com · Documentación: https://birdieapi.com/docs · Obtén una clave: https://birdieapi.com/signup

You:    "How did Scottie Scheffler score on each hole of the 2025 Masters?"
Claude: [calls get_scorecard]

You:    "Which players have the best record at Pebble Beach since 2010?"
Claude: [calls get_course_history]

You:    "What did sportsbooks price Scottie Scheffler to win the 2025 Masters?"
Claude: [calls get_winner_odds]

Inicio rápido

Este es un servidor MCP alojado (remoto) sobre Streamable HTTP. No hay nada que instalar.

Claude Code

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

Claude Desktop, Cursor y otros clientes

{
  "mcpServers": {
    "birdieapi": {
      "url": "https://mcp.birdieapi.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.birdieapi.com/v1/list_tournaments -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.py y examples/node/quickstart.mjs: calendario más una llamada destacada.
• examples/python/golf_major_leaderboard_and_odds.py: Un major, antes y después.

export BIRDIEAPI_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://birdieapi.com/signup.

Herramientas (14)

Herramienta	Qué devuelve
list_tournaments	Los torneos de una temporada con fechas, ganador, bolsa y campos
search_players	Encuentra jugadores por nombre
get_schedule	Torneos de esta semana y próximos, con el campo anfitrión
get_leaderboard	La tabla de clasificación completa de un torneo: posición, rondas, total, ganancias y puntos
get_scorecard	La tarjeta hoyo a hoyo de un jugador para un torneo, con par y yardaje
get_course	Un campo tal como está preparado para un torneo: par y yardas por hoyo y cómo se jugó cada hoyo
get_ratings	Nuestra calificación de golpes frente al campo: cada jugador activo, ajustada por la fuerza del campo
get_player	Perfil, calificación, líneas de temporada y resultados recientes
get_player_results	Los torneos y rondas de un jugador por temporada, con golpes frente al campo
get_player_stats	Las estadísticas de temporada de un jugador: puntuación, birdies, puntuación en pares 3/4/5, golpes de salida, greens, putting
get_course_history	El historial de un jugador en un torneo o campo, cada año
get_head_to_head	Los resultados y rondas de dos jugadores en cada torneo en el que ambos participaron
get_leaders	Líderes de temporada en cualquier estadística que calculamos o que ESPN mantiene
get_winner_odds	Los precios de los ganadores de los cuatro grandes por casa de apuestas antes de la primera ronda: apertura y última, con probabilidad implícita

Ligas: golf (predeterminado, PGA Tour), lpga, liv, dpwt, kornferry (pasa league a cualquier herramienta; omítelo para el PGA Tour).

Datos

• Tablas de clasificación del PGA Tour, rondas y puntuaciones hoyo a hoyo desde 2001
• LPGA, LIV, el DP World Tour y el Korn Ferry Tour (hoyo a hoyo desde 2007) en las mismas herramientas
• Campos con par y yardaje por hoyo y cómo se jugó cada hoyo; historial de campos del jugador; cara a cara
• Nuestra calificación de golpes frente al campo, ajustada por la fuerza del campo, y desgloses de puntuación en pares 3/4/5 (promedios, más golpes frente al campo por tipo de hoyo para el PGA Tour y el Korn Ferry Tour); basada en puntuación, no en golpes ganados a nivel de tiro
• Probabilidades de ganador de major (get_winner_odds): precios de ganador absoluto de los cuatro grandes masculinos por casa de apuestas, apertura y última antes de la primera ronda, cada major desde 2021 más el U.S. Open 2020 (archivo de The Odds API; el precio más reciente de un major pasado puede ser hasta una semana antes del primer tee), actualizado diariamente mientras el mercado de un próximo major esté abierto y cada seis horas en la semana del torneo
• Sin precios de ronda, enfrentamientos, top-10 ni otros torneos, y sin precios para los otros tours

Cobertura por temporada, leída en vivo desde la base de datos: https://birdieapi.com/docs

Precios

500 créditos gratuitos 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://birdieapi.com/pricing

Atribución

Datos de golf de datos públicos de ESPN; precios de ganadores de major de The Odds API. Las calificaciones son nuestras. No afiliado con el PGA Tour, LPGA, LIV Golf, DP World Tour o Korn Ferry Tour.

Licencia

MIT para el contenido de este repositorio. Términos de datos como se indican arriba.