FastballAPI

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

Servidor MCP FastballAPI

A API de dados de beisebol. Dados lance a lance com tipo de arremesso, velocidade e localização, cada aparição na placa com estado de bases e rebatidas, box scores, classificações, nossas próprias avaliações e valores de corrida, linhas de casas de apostas por casa e linhas de props de jogadores da MLB. MLB desde 2015, além dos jogos da NCAA Division I que a ESPN transmite. API REST e servidor MCP. 500 créditos gratuitos, sem cartão.

Site: https://fastballapi.com · Documentação: https://fastballapi.com/docs · Obtenha uma chave: https://fastballapi.com/signup

You:    "What is Gerrit Cole's whiff rate by pitch type this season?"
Claude: [calls get_pitch_mix]

You:    "How often did Aaron Judge homer on a 3-2 count in 2025?"
Claude: [calls get_plate_appearances]

You:    "How often has Shohei Ohtani gone over his total bases line since 2023?"
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 fastballapi "https://mcp.fastballapi.com/mcp?key=YOUR_API_KEY"

Claude Desktop, Cursor e outros clientes

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

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

Exemplos

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

• examples/python/quickstart.py e examples/node/quickstart.mjs: programação de jogos mais uma chamada principal.
• examples/python/mlb_pitch_mix_and_props.py: O arsenal de um arremessador (uso, velocidade, taxa de whiff e taxa de bolas por tipo de arremesso) seguido de suas linhas de props de strikeouts contra o que ele realmente arremessou, jogo a jogo.

export FASTBALLAPI_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://fastballapi.com/signup.

Ferramentas (20)

Ferramenta	O que retorna
list_teams	IDs de times, abreviações e cores para uma temporada
search_players	Encontre jogadores por nome
get_games	Jogos com corridas, rebatidas e erros por temporada, data, intervalo ou time
get_schedule	Próximos jogos com a linha mediana entre as casas de apostas
get_standings	Classificações de cada jogo final, com diferencial de corridas e recorde pitagórico
get_injuries	O relatório de lesões mais recente
get_ratings	Nossas avaliações Elo de times, classificadas
get_game	Um jogo: cada linha de rebatida e arremesso, a linha de cada casa, probabilidade de vitória
get_player	Rebatidas da temporada (AVG, OBP, SLG, OPS, RE24) e arremessos (ERA, WHIP, K/9)
get_player_games	O registro completo de rebatidas e arremessos de um jogador
get_leaders	Líderes da temporada entre rebatedores e arremessadores qualificados
get_team_stats	Corridas a favor e contra, rebatidas do time e rebatidas dos adversários
get_pitch_mix	O arsenal de um arremessador: uso, velocidade, taxa de whiff por tipo de arremesso
get_odds	Moneyline, run line e total de cada casa de apostas para um jogo (5) ou um dia (10)
get_plate_appearances	Jogada a jogada de aparições na placa com estado de bases, rebatidas, probabilidade de vitória, RE24
get_pitches	Lance a lance: contagem, tipo, velocidade, localização, resultado
get_spray_chart	Onde um rebatedor ou time rebate a bola, por trajetória e campo
get_line_movement	Instantâneos da linha de cada casa de apostas antes do primeiro arremesso
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: mlb (padrão), ncaabase (jogos da NCAA Division I que a ESPN transmite; ferramentas de arremesso, spray charts e lesões não são oferecidas para o universitário).

Dados

• Jogos da MLB desde 2015 com dados lance a lance (cada lance desde 2018; 2015 a 2017 têm cerca de 98 a 99% dos lances de cada temporada)
• Cada aparição na placa com estado de bases, rebatidas, probabilidade de vitória e RE24
• Moneylines, run lines e totais por casa de apostas: 4 a 13 casas por jogo de 2015 a 2023 (cerca de 4 em 2015, 10 em 2016 e 2017, 7 a 8 em 2018 a 2020, 12 em 2021 a 2023), geralmente uma casa desde 2024 no feed próprio da ESPN, além de linhas de abertura e fechamento da The Odds API desde julho de 2020 (mediana de 7 casas em 2021 a 2023 e 8 desde 2024); 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 da MLB por casa de apostas (rebatidas, home runs, total de bases, RBI, strikeouts de arremessadores, outs de arremessadores) desde maio de 2023, com o resultado contra cada linha (get_player_props, get_prop_history); nenhuma para o universitário
• Beisebol universitário da NCAA Division I para os jogos que a ESPN transmite (não todos os jogos da Division I)

Cobertura por temporada, lida ao vivo do banco de dados: https://fastballapi.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://fastballapi.com/pricing

Atribuição

Dados de beisebol de dados públicos da ESPN; linhas de casas de apostas e props de jogadores da ESPN e da The Odds API. Avaliações e valores de corrida são nossos. Não afiliado à MLB, à NCAA ou a qualquer time.

Licença

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