footballstack-mcp

MCP-Server für die FootballStack Fußballdaten-API. Bietet einem LLM-Client echte Fußballdaten – Spielpläne, Tabellen, Aufstellungen, Live-Events, schussgenaues xG mit Spielfeldkoordinaten und modellbasierte faire Quoten – statt einer halluzinierten Spielstandzeile.

12 Tools, 1 Prompt. Node ≥ 20, kein Build-Schritt.

Installation

npx footballstack-mcp

Legen Sie Ihren API-Schlüssel in der Umgebung fest. Kostenlose Stufe: 1.000 Anfragen/Monat. Holen Sie sich einen Schlüssel unter footballstackapi.com/sign-in.

Claude Desktop / Claude Code

{
  "mcpServers": {
    "footballstack": {
      "command": "npx",
      "args": ["-y", "footballstack-mcp"],
      "env": { "FOOTBALLSTACK_API_KEY": "fs_live_..." }
    }
  }
}

Cursor / Windsurf / jeder stdio-MCP-Client

Derselbe Block in der MCP-Konfigurationsdatei dieses Clients.

Related MCP server: worldcup-ai-forecaster

Werkzeuge

Prompt: scout_team_form – ein Team auflösen, die letzten 5 Spiele abrufen, das xG hinter den Ergebnissen lesen.

Beginnen Sie mit footballstack_search, um IDs aufzulösen. Raten von IDs verschwendet Kontingent: 404er und leere Ergebnisse werden wie jede andere Anfrage abgerechnet.

Abdeckung, ehrlich dargestellt

Der Katalog listet 75 Wettbewerbe. Die Tiefe ist nicht einheitlich, und der Katalog ist breiter als die tiefe Abdeckung.

• Am tiefsten: Bundesliga, 2. Bundesliga, DFB Pokal, Superliga României

• Erweitertes Europa: Eredivisie, Primeira Liga, Süper Lig, Pro League, Scottish Premiership

• Nur historisch / Analytik: Premier League, La Liga, Serie A, Ligue 1 (xG stammt von Understat)

Rufen Sie footballstack_competitions auf und prüfen Sie Ihre Liga, bevor Sie darauf aufbauen.

Kontingentverhalten

• Kostenlos: 1.000 Anfragen/Monat, 10 Anfragen/Min. Entwickler 9 $/Monat: 10.000 Anfragen/Monat, 60 Anfragen/Min., inklusive xG, Schusskarten, Aufstellungen, Live-Events und faire Quoten. Pro 29 $/Monat: 50.000/Monat, 180 Anfragen/Min.

• Keine Übernutzungsabrechnung. Wenn das Kontingent aufgebraucht ist, gibt die API 429 zurück; dieser Server meldet das als quota_or_rate_limit-Fehler statt eines leeren Ergebnisses.

• Das Kontingent wird am 1. des Monats UTC zurückgesetzt.

• Jede Anfrage wird abgerechnet, einschließlich 404er und leerer Ergebnisse.

Wann dies das falsche Werkzeug ist

• Hochfrequentes Live-Polling über viele Wettbewerbe. Ein Monatskontingent ist dafür die falsche Form – ein Tages- oder Sekundenplan anderswo kostet Sie weniger.

• Ligen außerhalb der obigen Liste mit tiefer Abdeckung.

• Sie benötigen ein vertragliches SLA, Verfügbarkeitsgutschriften oder einen benannten Support-Kontakt. Zu diesen Preisen nicht angeboten.

Entwicklung

npm install
npm run smoke   # boots the server over stdio, lists tools, calls health

npm run smoke funktioniert ohne API-Schlüssel: footballstack_health liefert Live-Status, und ein schlüsselgeschütztes Tool gibt einen lesbaren missing_api_key-Fehler zurück, sodass Sie „nicht konfiguriert“ von „defekt“ unterscheiden können.

MIT.