football-api-mcp

MCP (Model Context Protocol)-Server für die 5DollarFootballAPI — liefert Claude, Cursor und jedem MCP-fähigen KI-Assistenten Live-Fußballdaten: Spieltage, Live-Ergebnisse, Tabellen, Statistiken, Wettquoten und die vollständige Historie der Quotenbewegungen, einschließlich Eckball- und Kartenlinien.

Fragen Sie Ihren Assistenten zum Beispiel:

• "Welche Premier-League-Spiele finden heute statt und wie stehen die aktuellen Ergebnisse?"

• "Zeig mir die Eckballtabelle für Liga 39 in dieser Saison."

• "Wie haben sich die 1x2-Quoten für Spiel 1234567 vor dem Anpfiff bewegt?"

Einrichtung

Sie benötigen einen API-Schlüssel von 5dollarfootballapi.com — der kostenlose Tarif (ohne Kreditkarte) umfasst Spieltage, Live-Ergebnisse und Tabellen; Quoten-Tools erfordern einen kostenpflichtigen Plan (ab $5/Monat).

Claude Code

claude mcp add football-api -e FIVEDOLLARFOOTBALL_API_KEY=fb_live_your_key -- npx -y football-api-mcp

Claude Desktop

Fügen Sie Folgendes zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "football-api": {
      "command": "npx",
      "args": ["-y", "football-api-mcp"],
      "env": { "FIVEDOLLARFOOTBALL_API_KEY": "fb_live_your_key" }
    }
  }
}

Cursor

Fügen Sie Folgendes zu .cursor/mcp.json (Projekt) oder ~/.cursor/mcp.json (global) hinzu:

{
  "mcpServers": {
    "football-api": {
      "command": "npx",
      "args": ["-y", "football-api-mcp"],
      "env": { "FIVEDOLLARFOOTBALL_API_KEY": "fb_live_your_key" }
    }
  }
}

Tools

Alle Tools sind schreibgeschützt. Fehler werden als Tool-Fehler mit dem API-Fehlercode und der Request-ID zurückgegeben, sodass der Assistent erklären kann, was schiefgelaufen ist.

Entwicklung

npm install
npm test          # in-memory MCP client/server tests, no network
FIVEDOLLARFOOTBALL_API_KEY=... npm start   # run over stdio

Der zugrunde liegende HTTP-Client ist das offizielle fivedollarfootball-Paket. Endpunkt-Referenz: 5dollarfootballapi.com/docs.

Lizenz

MIT