5DollarFootballAPI MCP Server

football-api-mcp

Servidor MCP (Model Context Protocol) para a 5DollarFootballAPI — fornece ao Claude, ChatGPT, Cursor e qualquer assistente de IA compatível com MCP dados ao vivo de futebol: partidas, placares ao vivo, classificações, estatísticas, odds de apostas e o histórico completo de movimentação de odds, incluindo linhas de escanteios e cartões.

Pergunte ao seu assistente coisas como:

• "Quais partidas da Premier League acontecem hoje e quais são os placares atuais?"
• "Mostre a classificação de escanteios da liga 39 nesta temporada."
• "Como as odds 1x2 se moveram para a partida 1234567 antes do início?"

Configuração

Você precisa de uma chave de API do 5dollarfootballapi.com — o plano gratuito (sem cartão) cobre partidas, placares ao vivo e classificações; as ferramentas de odds exigem um plano pago (a partir de US$ 5/mês).

Claude Code

claude mcp add football-api -e FIVEDOLLARFOOTBALL_API_KEY=fb_live_your_key -- npx -y football-api-mcp

Claude Desktop

Adicione ao claude_desktop_config.json:

{
  "mcpServers": {
    "football-api": {
      "command": "npx",
      "args": ["-y", "football-api-mcp"],
      "env": { "FIVEDOLLARFOOTBALL_API_KEY": "fb_live_your_key" }
    }
  }
}

Cursor

Adicione ao .cursor/mcp.json (projeto) ou ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "football-api": {
      "command": "npx",
      "args": ["-y", "football-api-mcp"],
      "env": { "FIVEDOLLARFOOTBALL_API_KEY": "fb_live_your_key" }
    }
  }
}

ChatGPT (modo Desenvolvedor)

O ChatGPT só se conecta a servidores MCP remotos (Streamable HTTP sobre HTTPS), não a comandos stdio locais, e requer um plano Plus/Pro/Business com o modo Desenvolvedor ativado. Execute o servidor em modo HTTP e exponha-o com um túnel:

FIVEDOLLARFOOTBALL_API_KEY=fb_live_your_key npx -y football-api-mcp --http --token pick-a-secret
# in another terminal — any tunnel works, e.g. cloudflared or ngrok
cloudflared tunnel --url http://localhost:3333

Depois, no ChatGPT (verificado em 2026-08): Configurações → Segurança e login → Modo Desenvolvedor (ative), abra Plugins na barra lateral, clique em + (Criar app) e, no formulário Novo Plugin, defina Conexão como URL do servidor, cole https://<your-tunnel-host>/mcp/pick-a-secret, defina Autenticação como Sem autenticação, marque a confirmação e Criar, depois Conectar. --token é importante aqui: o ChatGPT não pode enviar cabeçalhos personalizados, então o segredo no caminho é o que impede que uma URL de túnel vazada gaste sua chave de API.

Opções: --host (padrão 127.0.0.1), --port (padrão 3333) ou as variáveis de ambiente equivalentes MCP_HTTP_HOST / MCP_HTTP_PORT / MCP_HTTP_TOKEN. O mesmo modo HTTP funciona para qualquer outro cliente MCP somente remoto.

Ferramentas

Ferramenta	O que faz
get_fixtures	Partidas de um dia do calendário (padrão hoje, UTC) com placares ao vivo, escanteios, cartões
get_fixture	Uma partida, opcionalmente com a linha do tempo de eventos e estatísticas da partida
get_fixture_odds	Odds atuais: 1x2, handicap asiático, linha de gols, linha de escanteios, linhas de cartões, ambas marcam
get_odds_history	Cada variação de preço registrada para uma partida e mercado — pré-jogo e ao vivo
get_bookmakers	Slugs de casas de apostas utilizáveis nas ferramentas de odds
get_standings	Tabela da liga — pontos, classificação de escanteios ou cartões
search_leagues / search_countries	Descubra IDs de ligas e países pelo nome
get_league_fixtures	Partidas e resultados de uma temporada de liga
get_team_fixtures	Partidas de um time, mais recentes primeiro
get_account_status	Seu plano, uso e estado do limite de requisições

Prompts

Modelos de análise de uma etapa que você pode invocar em qualquer cliente com suporte a prompts:

Prompt	O que produz
todays-briefing	Um briefing agrupado das partidas do dia, placares ao vivo e números de destaque
odds-movement-report	Análise de abertura vs fechamento do mercado de uma partida com reação ao vivo
corner-scout	As tendências de escanteios de uma liga a partir de sua classificação de escanteios e resultados recentes

Recursos

Dados de contexto anexáveis: football://leagues/popular (IDs de ligas populares) e football://bookmakers (slugs de casas de apostas para as ferramentas de odds).

Todas as ferramentas são somente leitura. Erros retornam como erros de ferramenta com o código de erro da API e o ID da requisição, para que o assistente possa explicar o que deu errado.

Desenvolvimento

npm install
npm test          # in-memory MCP client/server tests, no network
FIVEDOLLARFOOTBALL_API_KEY=... npm start          # run over stdio
FIVEDOLLARFOOTBALL_API_KEY=... npm start -- --http # run over Streamable HTTP

O cliente HTTP subjacente é o pacote oficial fivedollarfootball. Referência de endpoints: 5dollarfootballapi.com/docs.

Licença

MIT