Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge API-Football mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
Zusammenfassung
Lass deine KI mit API-Football Fußball verfolgen: Live-Ergebnisse und Spielereignisse, Spielpläne, Tabellen, Team- und Spielerstatistiken, Aufstellungen, Verletzungen, Transfers, direkte Duelle, Spielprognosen und Buchmacherquoten für Ligen und Pokale weltweit. Mit einem API-Key aus deinem API-Sports-Konto.
Frag einfach
Beispiel-Prompts für API-Football
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → API-Football klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
API-Football
Lass deine KI mit API-Football Fußball verfolgen: Live-Ergebnisse und Spielereignisse, Spielpläne, Tabellen, Team- und Spielerstatistiken, Aufstellungen, Verletzungen, Transfers, direkte Duelle, Spielprognosen und Buchmacherquoten für Ligen und Pokale weltweit. Mit einem API-Key aus deinem API-Sports-Konto.
Einrichtung
- Lege unter dashboard.api-football.com ein kostenloses Konto an. Nach der Anmeldung zeigt dir das Dashboard deinen API-Key. Zum Ausprobieren reicht der kostenlose Plan.
- Trage den Key in
API_FOOTBALL_KEYein und installiere den Connector. Er geht als Headerx-apisports-keyan API-Sports. Nimm den Key aus dem API-Sports-Dashboard: Ein Key, den du über einen API-Marktplatz gekauft hast, nutzt einen anderen Header und funktioniert hier nicht. - Ruf zuerst
af_statusauf. Das Tool zeigt deinen Plan, das tägliche Anfragelimit und deinen bisherigen Verbrauch und zählt selbst nicht zum Kontingent. - Starte jede Analyse mit
af_analysis_playbook. Es macht keinen API-Aufruf und liefert die Reihenfolge der Tools für die jeweilige Anfrage: Vorschau oder Prognose, Spielbericht, Teamform, Tabelle, Topspieler, Spielerscouting, Kader, Verletzungen, Transfers, Quoten oder Live-Verfolgung.
Erst Namen in IDs auflösen: Fast jedes Tool braucht numerische IDs, und die KI soll sie nie raten. Einen Wettbewerb sucht sie mit af_leagues und dem Filter search (zum Beispiel die Bundesliga mit der ID 78 oder die Weltmeisterschaft mit der ID 1); dabei kommen auch die verfügbaren Saisons mit. Ein Team findet sie mit af_teams. af_fixtures mit der Team-ID und next auf 1 liefert das nächste Spiel und seine Fixture-ID, die af_predictions, af_fixture_lineups, af_fixture_events, af_fixture_statistics und af_fixture_players brauchen. Spieler kommen aus af_players mit Team und Saison oder aus af_player_profiles für die Suche nach Namen.
Saisons und Uhrzeiten: season ist die vierstellige Jahreszahl, in der die Saison beginnt: 2025 steht für 2025/26, die WM 2026 für 2026. Daten haben das Format YYYY-MM-DD. Uhrzeiten sind UTC, außer die KI übergibt timezone mit einem Wert aus af_timezone.
Tageskontingent: Jeder Aufruf eines Daten-Tools ist eine Anfrage an API-Sports und zählt zum Tageskontingent deines Plans. Die Anweisungen des Connectors gehen vom kostenlosen Plan mit 100 Anfragen pro Tag aus; bezahlte Pläne erlauben mehr. af_status und af_analysis_playbook kosten nichts. Eine vollständige Spielvorschau (Prognose, Quoten, Aufstellungen, Teamstatistiken und Verletzungen beider Teams, Torschützen, Spielerstatistiken, direkte Duelle) braucht rund ein Dutzend Aufrufe, und seitenweise Ergebnisse wie bei af_players kosten eine Anfrage pro Seite. Genaue Filter (Liga, Saison, Team, Datum) sparen also viel.
Prognosen und Quoten sind Daten, keine Wettempfehlung: af_predictions liefert für ein Spiel die eigenen Wahrscheinlichkeiten von API-Football für Sieg, Unentschieden und Niederlage, einen Tipp und einen Formvergleich. af_odds_prematch und af_odds_live liefern Buchmacherquoten, die die KI in implizite Wahrscheinlichkeiten umrechnen und mit der Prognose vergleichen kann. Beides garantiert kein Ergebnis. Bei kleineren oder noch weit entfernten Spielen können Quoten fehlen; af_odds_mapping listet die Spiele mit Quoten, af_odds_bookmakers, af_odds_bets und af_odds_live_bets die Buchmacher und Wettmärkte.
Was die Daten abdecken: Aufstellungen stehen meist etwa eine Stunde vor Anpfiff fest. In af_injuries heißt Missing Fixture, dass der Spieler ausfällt, und Questionable, dass sein Einsatz fraglich ist. Ein Tool für Schiedsrichter gibt es nicht: Der Schiedsrichter steht nur beim Spiel und oft erst spät. Direkte Duelle sind für Vereine gut erfasst, für Nationalmannschaften kaum.
Nur lesen: Alle 40 Tools lesen nur Daten. In deinem API-Sports-Konto wird nichts geändert, und bei der Installation ist kein Tool ausgeschaltet.
Häufige Fehler: API-Football kann mit HTTP 200 antworten und trotzdem scheitern; der Grund steht dann im Feld errors, und response ist leer. Ein Eintrag token heißt, dass der Key falsch ist oder fehlt: Prüf API_FOOTBALL_KEY. Ein Eintrag plan heißt, dass die Saison oder Funktion nicht in deinem Plan enthalten ist: Stuf den Plan im API-Sports-Dashboard hoch oder frag nach einer Saison, die dein Plan abdeckt. Ist das Tageskontingent aufgebraucht, scheitern Aufrufe, bis es zurückgesetzt wird; af_status zeigt, was noch übrig ist. Ein leeres response ohne Fehler heißt, dass nichts zu den Filtern passt, etwa weil Quoten noch nicht veröffentlicht sind oder eine Saison noch nicht begonnen hat.
Der Connector platziert keine Wetten, deckt die anderen Sportarten von API-Sports nicht ab und verschickt keine Live-Benachrichtigungen: Live-Ergebnisse kommen, wenn die KI danach fragt. Er ist außerdem nicht der Connector für football-data.org, der einen eigenen Token von football-data.org nutzt.
Voraussetzungen: API_FOOTBALL_KEY
Connector lokal installieren
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
Öffne http://localhost:3000/connectors/store, wähle API-Football und trage die unter Voraussetzungen aufgelisteten Variablen ein.
Verfügbare Tools
| Tool | What it does |
|---|---|
af_analysis_playbook | START HERE for football analysis (optional but recommended): returns, with NO API call, the exact ordered list of af_* tools to run for a… |
af_status | Account status: subscription plan, daily request limit and current usage |
af_timezone | List of all valid timezone strings accepted by the timezone parameter of other endpoints |
af_countries | List available countries (name, code, flag) |
af_leagues | Find LEAGUES & cups + their available seasons and numeric id (needed by standings/fixtures/topscorers/etc) |
af_leagues_seasons | List of all season years available across the API (e.g. 2010..2024) |
af_teams | Find TEAMS + their numeric id (needed by almost every other tool) |
af_team_statistics | A team's season STATISTICS in a competition: form, played, W-D-L, goals for/against (+ averages, home/away split), clean sheets, streaks… |
af_team_seasons | List of season years for which a given team has data |
af_team_countries | List of countries available for the teams endpoint |
af_venues | Search stadiums/venues (name, address, city, capacity, surface) |
af_standings | League TABLE / STANDINGS for a season: rank, points, W-D-L, goal difference, form. league=<id>, season=<year> |
af_fixtures | Football MATCHES & scores |
af_fixtures_rounds | List of round names for a league+season (e.g. 'Regular Season - 1') |
af_head_to_head | HEAD-TO-HEAD history between two teams (h2h='idA-idB'): past meetings with scores, competitions and venues |
af_fixture_statistics | Team match STATISTICS for a fixture: shots, shots on target, possession %, corners, fouls, offsides, passes & accuracy |
af_fixture_events | Match TIMELINE for a fixture: goals (with assist), cards, substitutions and VAR, each with minute & player |
af_fixture_lineups | Starting XI, bench, FORMATION and coach for a fixture |
af_fixture_players | Per-player match stats & RATINGS for a fixture (goals, shots, passes, duels, rating) |
af_injuries | INJURIES & suspensions, who is OUT or doubtful |
af_predictions | THE match-prediction endpoint for one fixture id (win/draw/loss %, advice, predicted winner, and a form/attack/defence comparison of the… |
af_coachs | Search coaches and their career |
af_players | PLAYER statistics for a season: goals, assists, rating, minutes, shots, passes, dribbles, duels, cards |
af_player_seasons | Season years available for a player (or all seasons if no player given) |
af_player_squads | Current squad of a team, or the teams a player belongs to |
af_player_teams | List of teams a player has played for |
af_player_profiles | Player personal data (name, age, nationality, height...) |
af_topscorers | TOP SCORERS / golden boot of a competition: goals, penalties, appearances, minutes-per-goal |
af_topassists | Top 20 assist providers of a league+season |
af_topyellowcards | Top 20 players by yellow cards in a league+season |
af_topredcards | Top 20 players by red cards in a league+season |
af_transfers | Transfer history |
af_trophies | Trophies won |
af_sidelined | Past absences (injuries/suspensions) for players/coaches |
af_odds_prematch | Pre-match betting ODDS for a fixture across bookmakers & markets (fixture=<id>; optional bookmaker=/bet=) |
af_odds_live | In-play (live) odds updated in real time |
af_odds_live_bets | Catalogue of available in-play bet (market) types for live odds |
af_odds_mapping | Mapping of fixtures that have pre-match odds available |
af_odds_bookmakers | List of available bookmakers (id + name) for the odds endpoints |
af_odds_bets | List of available pre-match bet (market) types (id + name) |
Beispiel-Prompts
- „Mach mir eine vollständige Vorschau auf das nächste Spiel von Argentinien: Siegwahrscheinlichkeiten, Buchmacherquoten, voraussichtliche Aufstellungen, Verletzte und die aktuelle Form beider Teams.“
- „Zeig mir die aktuelle Bundesliga-Tabelle und die 10 besten Torschützen dieser Saison.“
- „Welche Serie-A-Spiele laufen gerade, wie steht es und wer hat bisher getroffen?“
- „Wer fällt bei Real Madrid gerade verletzt oder gesperrt aus, und welche Spieler hat der Verein im letzten Transferfenster geholt?“
Nächste Schritte
War dieser Guide hilfreich?
