BirdieAPI

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

Servidor MCP BirdieAPI

A API de dados de golfe. Leaderboards do PGA Tour com posições finais, ganhos e pontos, scores por rodada e placares buraco a buraco, campos com par e jardas por buraco, histórico de jogadores e campos, nossa própria classificação de strokes versus campo, divisões de scoring em par-3/4/5 e os preços dos vencedores dos quatro majors masculinos pelas casas de apostas. O LPGA, LIV, o DP World Tour e o Korn Ferry Tour usam as mesmas ferramentas. API REST e servidor MCP. 500 créditos gratuitos, sem cartão.

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

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 birdieapi "https://mcp.birdieapi.com/mcp?key=YOUR_API_KEY"

Claude Desktop, Cursor e outros clientes

{
  "mcpServers": {
    "birdieapi": {
      "url": "https://mcp.birdieapi.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.birdieapi.com/v1/list_tournaments -H "x-api-key: YOUR_API_KEY"

Toda 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: cronograma mais uma chamada principal.
• examples/python/golf_major_leaderboard_and_odds.py: Um major, antes e depois.

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

Ferramentas (14)

Ferramenta	O que retorna
list_tournaments	Os torneios de uma temporada com datas, vencedor, premiação e campos
search_players	Encontre jogadores por nome
get_schedule	Torneios desta semana e os próximos, com o campo anfitrião
get_leaderboard	O leaderboard completo de um torneio: posição, rodadas, total, ganhos e pontos
get_scorecard	O placar buraco a buraco de um jogador em um torneio, com par e jardas
get_course	Um campo configurado para um torneio: par e jardas por buraco e como cada buraco foi jogado
get_ratings	Nossa classificação de strokes versus campo: cada jogador ativo, ajustado pela força do campo
get_player	Perfil, classificação, linhas da temporada e resultados recentes
get_player_results	Os torneios e rodadas de um jogador por temporada, com strokes versus o campo
get_player_stats	As estatísticas de temporada de um jogador: scoring, birdies, scoring em par-3/4/5, driving, greens, putting
get_course_history	O histórico de um jogador em um torneio ou campo, todos os anos
get_head_to_head	Os resultados e rodadas de dois jogadores em todos os torneios em que ambos jogaram
get_leaders	Líderes da temporada em qualquer estatística que calculamos ou que a ESPN mantém
get_winner_odds	Os preços dos vencedores dos quatro majors pelas casas de apostas antes da primeira rodada: abertura e mais recentes, com probabilidade implícita

Ligas: golf (padrão, PGA Tour), lpga, liv, dpwt, kornferry (passe league para qualquer ferramenta; omita para o PGA Tour).

Dados

• Leaderboards do PGA Tour, rodadas e scores buraco a buraco desde 2001
• LPGA, LIV, o DP World Tour e o Korn Ferry Tour (buraco a buraco desde 2007) nas mesmas ferramentas
• Campos com par e jardas por buraco e como cada buraco foi jogado; histórico de campos dos jogadores; confronto direto
• Nossa classificação de strokes versus campo, ajustada pela força do campo, e divisões de scoring em par-3/4/5 (médias, além de strokes versus o campo por tipo de buraco para o PGA Tour e o Korn Ferry Tour); baseada em score, não em strokes gained no nível de tacada
• Odds dos vencedores dos majors (get_winner_odds): preços de vencedor absoluto dos quatro majors masculinos pelas casas de apostas, abertura e mais recentes antes da primeira rodada, todos os majors de 2021 além do U.S. Open de 2020 (arquivo do The Odds API; o preço mais recente de um major passado pode ser de até uma semana antes do primeiro tee time), atualizado diariamente enquanto o mercado de um próximo major estiver aberto e a cada seis horas na semana do torneio
• Sem preços de rodada, confronto, top-10 ou outros torneios, e sem preços para as outras ligas

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

Preços

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

Atribuição

Dados de golfe de dados públicos da ESPN; preços dos vencedores dos majors do The Odds API. As classificações são nossas. Não somos afiliados ao PGA Tour, LPGA, LIV Golf, DP World Tour ou Korn Ferry Tour.

Licença

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