SportMonks Football über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → SportMonks Football klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

SportMonks Football + Gemini

SportMonks Football API v3: Ligen, Saisons, Spiele und Ergebnisse, Livescores, Tabellen, Torschützen, Teams, Kader, Spieler, Stadien, Quoten vor dem Spiel und Prognosen, mit der Include- und Filter-Syntax von SportMonks. Was abgedeckt ist, hängt von deinem SportMonks-Tarif ab.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

SPORTMONKS_API_TOKEN

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein SportMonks-Konto mit einem API-Token. Es gibt einen kostenlosen Tarif mit wenigen Ligen; bezahlte Tarife bringen weitere Ligen und Add-ons wie Quoten und Prognosen.

1. Melde dich auf my.sportmonks.com an und öffne API, dann Tokens.
2. Erstelle einen Token und kopiere ihn.
3. Füge nur den Token in SPORTMONKS_API_TOKEN ein, ohne Leerzeichen und ohne api_token= davor. Der Connector schickt ihn im Header Authorization.
4. Installiere den Connector und führe sportmonks_list_my_leagues aus: Es zeigt die Ligen deines Tarifs mit ihren IDs.

Dein Tarif bestimmt die Daten: Was du lesen kannst, hängt von deinem SportMonks-Tarif ab, vor allem von den enthaltenen Ligen. Daten außerhalb des Tarifs lösen keinen Fehler aus: Die Antwort ist einfach leer, mit dem Hinweis, dass dein aktuelles Abo keinen Zugriff darauf hat. Deshalb beginnt die KI mit deinen Ligen und arbeitet mit diesen. Quoten und Prognosen brauchen zusätzlich das passende Add-on.

Was er liest: Ligen und Saisons; Spiele und Ergebnisse für einen Tag oder einen Zeitraum; Livescores und die Spiele, die gerade laufen; Tabellen, auch live; Torschützen, Vorlagen und Karten; Teams, Kader und Spieler mit ihren Statistiken; direkte Duelle; Stadien; Quoten vor dem Spiel von den Buchmachern deines Tarifs; und die Wahrscheinlichkeiten und Value Bets des SportMonks-Modells.

Zuerst die IDs: SportMonks arbeitet mit IDs. Einige Liga-IDs: 8 Premier League, 9 Championship, 82 Bundesliga, 384 Serie A, 564 LaLiga, 301 Ligue 1, 2 Champions League. Tabellen, Torschützen und Kader brauchen eine Saison-ID, die die KI aus der aktuellen Saison der Liga holt. Teams, Spieler und Stadien findet sie per Namen mit den Suchtools.

Includes und Filter: Eine einfache Antwort enthält nur IDs. Die KI holt verknüpfte Daten mit Includes dazu, etwa participants;scores;state;events.type für ein Spiel mit Teams, Spielstand, Status und Toren, und grenzt Listen mit Filtern wie fixtureLeagues:9 ein. Sie hält die Includes bei dem, was du gefragt hast, weil sie Antworten deutlich größer machen. Listen kommen in Seiten mit bis zu 50 Einträgen.

Nur lesend: Jedes Tool liest nur. In deinem SportMonks-Konto ändert sich nichts, deshalb gibt es nichts zu bestätigen, und kein Tool ist bei der Installation ausgeschaltet.

Quoten und Prognosen sind Informationen: Quoten sind Dezimalquoten. Value Bets sind das, was das SportMonks-Modell findet; sie sind Information, keine Wettempfehlung.

Zeiten und Zeiträume: Zeiten kommen in UTC, solange die KI keine Zeitzone angibt, und sie nennt dir Anstoßzeiten in deiner. Ein Zeitraum umfasst höchstens 100 Tage.

Limits: SportMonks erlaubt 3.000 Aufrufe pro Stunde und Entität (Spiele, Teams, Spieler und so weiter). Jede Antwort zeigt, wie viele Aufrufe übrig sind und wann der Zähler zurückgesetzt wird; nach einem 429 wartet die KI bis dahin. Sie nimmt lieber eine gefilterte Liste als viele Einzelaufrufe.

Häufige Fehler: 401 heißt, SportMonks hat den Token abgelehnt: Erstelle unter API einen neuen und füge ihn erneut ein. 403 heißt, der Token funktioniert, aber diese Ressource ist nicht in deinem Tarif. Eine leere Antwort mit "No result(s) found" bedeutet meist, dass die Liga oder das Add-on nicht in deinem Tarif ist.

Der Connector deckt nur Fußball ab; er platziert keine Wetten und ändert weder deinen SportMonks-Tarif noch deine Tokens.

Schritt 2 — Adapter 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

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die SportMonks Football-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Zeig mir die aktuelle Bundesliga-Tabelle mit der Form jedes Teams aus den letzten fünf Spielen.“
• „Wann sind die nächsten fünf Spiele des SC Freiburg, und wie sind die letzten fünf ausgegangen?“
• „Welche Spiele laufen gerade in meinen Ligen, und wie steht es?“
• „Wer sind diese Saison die besten Torschützen und Vorlagengeber der Bundesliga?“
• „Was sagt das SportMonks-Modell zum Bayern-Spiel am Samstag, und welche Quoten hat bet365 vor dem Spiel?“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden