5DollarFootballAPI MCP Server

football-api-mcp

Servidor MCP (Model Context Protocol) para la 5DollarFootballAPI: proporciona a Claude, ChatGPT, Cursor y cualquier asistente de IA compatible con MCP datos en vivo de fútbol: 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.

Pregúntale 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 para la liga 39 esta temporada."
• "¿Cómo se movieron las cuotas 1x2 para el partido 1234567 antes del inicio?"

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" }
    }
  }
}

ChatGPT (modo Desarrollador)

ChatGPT solo se conecta a servidores MCP remotos (HTTP Streamable sobre HTTPS), no a comandos stdio locales, y requiere un plan Plus/Pro/Business con el modo Desarrollador habilitado. Ejecuta el servidor en modo HTTP y exponlo con un túnel:

FIVEDOLLARFOOTBALL_API_KEY=fb_live_your_key npx -y football-api-mcp --http --token pick-a-secret
# in another terminal — any tunnel works, e.g. cloudflared or ngrok
cloudflared tunnel --url http://localhost:3333

Luego en ChatGPT (verificado en agosto de 2026): Configuración → Seguridad e inicio de sesión → Modo Desarrollador (actívalo), abre Plugins en la barra lateral, haz clic en + (Crear aplicación) y en el formulario Nuevo Plugin establece Conexión en URL del servidor, pega https://<your-tunnel-host>/mcp/pick-a-secret, establece Autenticación en Sin autenticación, marca la confirmación y Crear, luego Conectar. --token importa aquí: ChatGPT no puede enviar encabezados personalizados, por lo que el secreto en la ruta es lo que evita que una URL de túnel filtrada gaste tu clave de API.

Opciones: --host (por defecto 127.0.0.1), --port (por defecto 3333), o las variables de entorno equivalentes MCP_HTTP_HOST / MCP_HTTP_PORT / MCP_HTTP_TOKEN. El mismo modo HTTP funciona para cualquier otro cliente MCP solo remoto.

Herramientas

Herramienta	Qué hace
get_fixtures	Partidos para un día calendario (por defecto hoy, UTC) con marcadores en directo, córners, tarjetas
get_fixture	Un partido, opcionalmente con la línea de tiempo de eventos y estadísticas del partido
get_fixture_odds	Cuotas actuales: 1x2, hándicap asiático, línea de goles, línea de córners, líneas de tarjetas, BTTS
get_odds_history	Cada tick de precio registrado para un partido y mercado: antes del partido y en juego
get_bookmakers	Identificadores de casas de apuestas utilizables en las herramientas de cuotas
get_standings	Tabla de clasificación: puntos, clasificación de córners o tarjetas
search_leagues / search_countries	Descubre identificadores de ligas y países por nombre
get_league_fixtures	Partidos y resultados de una temporada de liga
get_team_fixtures	Partidos de un equipo, los más recientes primero
get_account_status	Tu plan, uso y estado de límite de velocidad

Prompts

Plantillas de análisis de una sola ejecución que puedes invocar desde cualquier cliente compatible con prompts:

Prompt	Qué produce
todays-briefing	Un informe agrupado de los partidos del día, marcadores en directo y cifras destacadas
odds-movement-report	Análisis de apertura vs cierre del mercado de un partido con reacción en juego
corner-scout	Las tendencias de córners de una liga a partir de su clasificación de córners y resultados recientes

Recursos

Datos de contexto adjuntables: football://leagues/popular (identificadores de ligas populares) y football://bookmakers (identificadores de casas de apuestas para las herramientas de cuotas).

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 identificador de solicitud, para que el asistente pueda explicar qué salió mal.

Desarrollo

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

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

Licencia

MIT