Football Charts
Estatísticas de futebol para 93 ligas como ferramentas MCP: classificações, resultados, jogos, tempo dos gols, probabilidades de modelo e projeções de temporada. Chave gratuita.
Documentação
API gratuita de dados de futebol e servidor MCP — 93 ligas
Resultados, jogos futuros, tabelas de classificação, tempo dos gols, um modelo de base público e projeções de temporada por Monte Carlo para 93 ligas em 42 países — incluindo as divisões inferiores que a maioria das fontes ignora. JSON simples via REST, ou dez ferramentas para Claude e outros assistentes via MCP. Sem chave necessária para começar.
1 · Adicione ao Claude — nada para instalar, sem chave
O endpoint hospedado funciona nos aplicativos web e móveis do claude.ai, o que nenhum servidor local consegue. Nível sem chave: 300 requisições/dia por IP. A URL não carrega segredo, então é segura em configurações e logs. A API roda em uma instância paga sempre ativa: sem cold starts, respostas rápidas em cerca de 0,1 s.
claude.ai (web ou móvel) — Configurações → Conectores → Adicionar conector personalizado
https://mcp.football-charts.com/mcp
Download the latest footballcharts-mcp-x.y.z.mcpb and open it:
https://github.com/ddevetak/footballcharts-mcp/releases/latest
claude mcp add football-charts -- npx -y footballcharts-mcp
Qualquer cliente MCP — estilo claude_desktop_config.json
{ "mcpServers": { "football-charts": {
"command": "npx", "args": ["-y", "footballcharts-mcp"] } } }
Depois pergunte: “Quem lidera a liga estoniana?”, “Quando o Liverpool marca mais?”, “O Hull consegue se manter?”. Cada ferramenta é somente leitura. O modelo é uma base pública que não supera o mercado das casas de apostas; a ferramenta get_track_record é a prova.
2 · Precisa de mais? Uma chave gratuita dá 5.000 requisições/dia
Mesmos dados, limites maiores (5.000/dia, 60/min). Todas as ligas, temporada atual + anterior. Sem odds — apenas probabilidades e resultados. Com uma chave, a URL do conector se torna https://mcp.football-charts.com/fc_your_key/mcp e instalações via stdio definem FC_API_KEY.
3 · MCP com chave
claude.ai na web ou móvel — adicione um conector personalizado
Settings → Connectors → Add custom connector
https://mcp.football-charts.com/fc_your_key/mcp
A chave vai na URL porque um campo de conector aceita apenas uma URL. Prefere um cabeçalho?POST /mcp com Authorization: Bearer também funciona. As chaves são somente leitura e você pode emitir uma nova a qualquer momento.
claude mcp add football-charts \
-e FC_API_KEY=fc_your_key \
-- npx -y footballcharts-mcp
{
"mcpServers": {
"football-charts": {
"command": "npx",
"args": ["-y", "footballcharts-mcp"],
"env": { "FC_API_KEY": "fc_your_key" }
}
}
}
4 · REST simples — sem chave necessária
curl https://footballcharts-backend.onrender.com/api/v1/leagues/premier/table/
# with a key: -H "Authorization: Bearer fc_your_key"
import requests
r = requests.get("https://footballcharts-backend.onrender.com/api/v1/leagues/premier/projection/")
# with a key: headers={"Authorization": "Bearer fc_your_key"}
print(r.json())
O servidor MCP é open source: github.com/ddevetak/footballcharts-mcp · pacote npm footballcharts-mcp
Ferramentas MCP
| about_football_charts | O que a fonte cobre e como usá-la — chame primeiro se estiver em dúvida |
|---|---|
| list_leagues | Todas as 93 ligas + temporadas disponíveis |
| get_league_table | Classificação: pontos, V/E/D, gols, forma; view=luck ou goals |
| get_results | Partidas encerradas: placares FT/HT, minuto do primeiro gol |
| get_fixtures | Próximas partidas com probabilidades do modelo |
| get_match | Uma partida: bloco completo de probabilidades entre mercados |
| get_season_projection | % de título / top-4 / rebaixamento, faixas de pontos (10 mil simulações, diário) |
| get_team | Um time: histórico de partidas, tempo dos gols, estatísticas |
| get_goal_timing | Gols por intervalo de 15 minutos, por time (filtro de time) |
| get_track_record | Nosso registro público de previsões liquidadas |
Endpoints REST
URL base: https://footballcharts-backend.onrender.com/api/v1 — a API também se descreve em GET /api/v1/.
| GET /leagues/ | todas as ligas + as temporadas que você pode consultar |
|---|---|
| GET /leagues/{league}/table/?season=&view= | classificação (classic | luck | goals) |
| GET /leagues/{league}/results/?season=&team= | partidas encerradas |
| GET /leagues/{league}/fixtures/ | próximas com probabilidades do modelo |
| GET /leagues/{league}/projection/ | projeção de temporada por Monte Carlo |
| GET /leagues/{league}/goal-timing/?season= | mapa de calor do tempo dos gols |
| GET /leagues/{league}/teams/?season= | times em ordem da tabela |
| GET /leagues/{league}/teams/{team}/?season= | página do time |
| GET /matches/{slug}/ | detalhe da partida |
| GET /track-record/ | registro de previsões liquidadas |
Grátis vs pago
Grátis
- · Todas as 90+ ligas
- · Temporada atual + anterior
- · Probabilidades, projeções, resultados, tabelas
- · Sem chave 300/dia por IP · chave gratuita 5.000/dia · atribuição necessária
Pago — o arquivo de odds
- · Odds de abertura e fechamento por casa de apostas, 2020-21 a 2025-26
- · 1X2 (FT/HT), escadas over/under, handicap asiático, ambas marcam, placar exato, HT/FT
- · Resultados e minutos dos gols unidos · CSV + Parquet · download único
- · Licença comercial e acesso à API do arquivo mediante cotação
Temporadas mais antigas pela API: contact@football-charts.com
Termos: grátis para uso pessoal e de pesquisa com atribuição ("Dados por football-charts.com"); sem revenda. Os números são probabilidades de dados de partidas — estatísticas, não conselhos de apostas · 18+. Veja também nosso registro de previsões e metodologia.