football-api-mcp

Servidor MCP (Model Context Protocol) para la 5DollarFootballAPI — proporciona a Claude, Cursor y cualquier asistente de IA compatible con MCP datos de fútbol en vivo: partidos, marcadores en directo, clasificaciones, estadísticas, cuotas de apuestas y el historial completo de movimientos de cuotas, incluyendo líneas de córners y tarjetas.

Pregunta a tu asistente cosas como:

• "¿Qué partidos de la Premier League hay hoy y cuáles son los marcadores actuales?"

• "Muestra la clasificación de córners de la liga 39 esta temporada."

• "¿Cómo se movieron las cuotas 1x2 del partido 1234567 antes del saque inicial?"

Configuración

Necesitas una clave de API de 5dollarfootballapi.com — el plan gratuito (sin tarjeta) cubre partidos, marcadores en directo y clasificaciones; las herramientas de cuotas requieren un plan de pago (desde $5/mes).

Claude Code

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

Claude Desktop

Añade a claude_desktop_config.json:

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

Cursor

Añade a .cursor/mcp.json (proyecto) o ~/.cursor/mcp.json (global):

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

Herramientas

Todas las herramientas son de solo lectura. Los errores se devuelven como errores de herramienta con el código de error de la API y el id de la petición, para que el asistente pueda explicar qué ha fallado.

Desarrollo

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

El cliente HTTP subyacente es el paquete oficial fivedollarfootball. Referencia de endpoints: 5dollarfootballapi.com/docs.

Licencia

MIT