API-Football su MCP: Pilota API-Football da qualsiasi agente AI

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → API-Football, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

API-Football

Fai seguire il calcio alla tua AI con API-Football: risultati in diretta ed eventi delle partite, calendari, classifiche, statistiche di squadre e giocatori, formazioni, infortuni, trasferimenti, precedenti, pronostici e quote dei bookmaker per campionati e coppe di tutto il mondo. Con una chiave API del tuo account API-Sports.

Setup

1. Crea un account gratuito su dashboard.api-football.com. Dopo l'accesso la dashboard ti mostra la tua chiave API. Per provare il connettore basta il piano gratuito.
2. Incolla la chiave in API_FOOTBALL_KEY e installa il connettore. Viene inviata ad API-Sports come header x-apisports-key. Usa la chiave della dashboard di API-Sports: una chiave acquistata tramite un marketplace di API usa un altro header e qui non funziona.
3. Chiama prima af_status. Mostra il tuo piano, il limite giornaliero di richieste e quante ne hai già usate, e non conta nella quota.
4. Per qualsiasi analisi comincia da af_analysis_playbook. Non fa nessuna chiamata API e restituisce la sequenza di tool per il tipo di richiesta: anteprima o pronostico, report post partita, forma della squadra, classifica, migliori giocatori, scouting, rosa, infortuni, trasferimenti, quote o partite in diretta.

Prima i nomi diventano id: quasi ogni tool vuole id numerici, e l'AI non deve mai indovinarli. Cerca una competizione con af_leagues e il filtro search (per esempio la Bundesliga, id 78, o i Mondiali, id 1), che elenca anche le stagioni disponibili, e una squadra con af_teams. af_fixtures con l'id della squadra e next impostato a 1 restituisce la prossima partita e il suo fixture id, che serve a af_predictions, af_fixture_lineups, af_fixture_events, af_fixture_statistics e af_fixture_players. I giocatori arrivano da af_players con squadra e stagione, oppure da af_player_profiles per cercarli per nome.

Stagioni e orari: season è l'anno a 4 cifre in cui inizia la stagione: 2025 vuol dire 2025/26, e i Mondiali 2026 sono 2026. Le date sono nel formato YYYY-MM-DD. Gli orari sono in UTC, a meno che l'AI non passi timezone con un valore preso da af_timezone.

Quota giornaliera: ogni chiamata a un tool di dati è una richiesta ad API-Sports e conta nella quota giornaliera del tuo piano. Le istruzioni del connettore presuppongono il piano gratuito, che consente 100 richieste al giorno; i piani a pagamento ne consentono di più. af_status e af_analysis_playbook non costano nulla. Un'anteprima completa (pronostico, quote, formazioni, statistiche e infortuni di entrambe le squadre, marcatori, statistiche dei giocatori, precedenti) richiede circa una dozzina di chiamate, e i risultati a pagine come quelli di af_players costano una richiesta per pagina: filtri precisi (campionato, stagione, squadra, data) fanno risparmiare parecchio.

Pronostici e quote sono dati, non consigli di scommessa: af_predictions restituisce per una partita le percentuali di vittoria, pareggio e sconfitta calcolate da API-Football, un consiglio e un confronto di forma. af_odds_prematch e af_odds_live restituiscono le quote dei bookmaker, che l'AI può convertire in probabilità implicite e confrontare con il pronostico. Nessuno dei due garantisce il risultato. Le quote possono mancare per partite minori o ancora lontane; af_odds_mapping elenca le partite con quote, mentre af_odds_bookmakers, af_odds_bets e af_odds_live_bets elencano bookmaker e mercati.

Cosa coprono i dati: le formazioni di solito sono ufficiali circa un'ora prima del calcio d'inizio. In af_injuries, Missing Fixture vuol dire che il giocatore è fuori e Questionable che è in dubbio. Non esiste un tool per gli arbitri: l'arbitro compare solo nella partita, spesso tardi. I precedenti sono completi per i club e scarsi per le nazionali.

Solo lettura: tutti i 40 tool leggono soltanto. Nel tuo account API-Sports non viene modificato nulla e nessun tool è disattivato all'installazione.

Errori comuni: API-Football può rispondere HTTP 200 e fallire comunque; il motivo è allora nel campo errors e response è vuoto. Una voce token vuol dire che la chiave è sbagliata o manca: controlla API_FOOTBALL_KEY. Una voce plan vuol dire che la stagione o la funzione non è inclusa nel tuo piano: passa a un piano superiore nella dashboard di API-Sports o chiedi una stagione coperta dal tuo piano. Quando la quota giornaliera è esaurita, le chiamate falliscono finché non si azzera; af_status mostra quante richieste restano. Un response vuoto senza errori vuol dire che nulla corrisponde ai filtri, per esempio quote non ancora pubblicate o una stagione non ancora iniziata.

Il connettore non piazza scommesse, non copre gli altri sport di API-Sports e non invia notifiche in diretta: i risultati live arrivano quando l'AI li chiede. Inoltre non è il connettore per football-data.org, che usa un proprio token di football-data.org.

Prerequisiti: API_FOOTBALL_KEY

Installazione locale del connettore

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Apri http://localhost:3000/connectors/store, scegli API-Football e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Fammi un'anteprima completa della prossima partita dell'Argentina: probabilità di vittoria, quote dei bookmaker, probabili formazioni, infortunati e forma recente di entrambe le squadre."
• "Mostrami la classifica attuale della Bundesliga e i 10 migliori marcatori di questa stagione."
• "Quali partite di Serie A sono in corso adesso, come stanno andando e chi ha segnato finora?"
• "Chi è infortunato o squalificato nel Real Madrid in questo momento, e quali giocatori ha acquistato il club nell'ultima sessione di mercato?"

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT