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).

Hospedado (nada para instalar)

Use o servidor hospedado em https://mcp.5dollarfootballapi.com — sua chave de API é a única configuração necessária. Cada chamada é feita com sua própria chave e conta contra o seu próprio plano.

Claude (web, desktop, mobile) e ChatGPT — adicione um conector personalizado (servidor MCP remoto) e cole isto como a URL do servidor. Não há OAuth ou outro tipo de login envolvido; a chave na URL é a credencial:

https://mcp.5dollarfootballapi.com/mcp/fb_live_your_key

Claude Code, Cursor e outros clientes que podem enviar cabeçalhos — mantenha a chave fora da URL:

claude mcp add --transport http football-api https://mcp.5dollarfootballapi.com/mcp --header "Authorization: Bearer fb_live_your_key"

A URL com sua chave é um segredo: qualquer pessoa que a tiver pode gastar sua cota. Crie uma chave separada para isso no seu painel e exclua essa chave se a URL vazar.

Prefere executar você mesmo? As configurações locais abaixo funcionam da mesma forma.

Claude Code

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

Claude Desktop

Adicione a claude_desktop_config.json:

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

Cursor

Adicione a .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 (HTTP Streamable sobre HTTPS), não a comandos stdio locais, e exige um plano Plus/Pro/Business com o modo Desenvolvedor ativado. O caminho mais rápido é o servidor hospedado: use https://mcp.5dollarfootballapi.com/mcp/fb_live_your_key como a URL do servidor nas etapas abaixo e pule o túnel. Para executar o seu próprio, inicie 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 o interruptor), abra Plugins na barra lateral, clique no + (Criar aplicativo) 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 importa 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.

Para atender muitos usuários a partir de uma única instância (o que o servidor hospedado executa), use --hosted em vez de --http: sem chave de API no servidor, cada chamador fornece a sua própria como /mcp/<api-key> ou Authorization: Bearer <api-key>. Coloque-o atrás de um proxy reverso que encerre TLS e mantenha o caminho fora do log de acesso.

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 taxa

Prompts

Modelos de análise de uma única execução 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 solicitaçã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
npm start -- --hosted                              # multi-user HTTP, callers bring their own key

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

Licença

MIT