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 de fútbol en vivo: partidos, marcadores en directo, clasificaciones, estadísticas, cuotas de apuestas y el historial completo de movimiento 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 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 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).

Alojado (nada que instalar)

Usa el servidor alojado en https://mcp.5dollarfootballapi.com — tu clave API es la única configuración necesaria. Cada llamada se realiza con tu propia clave y cuenta contra tu propio plan.

Claude (web, escritorio, móvil) y ChatGPT — añade un conector personalizado (servidor MCP remoto) y pega esto como la URL del servidor. No se requiere OAuth ni otro inicio de sesión; la clave en la URL es la credencial:

https://mcp.5dollarfootballapi.com/mcp/fb_live_your_key

Claude Code, Cursor y otros clientes que pueden enviar cabeceras — mantén la clave fuera de la URL:

claude mcp add --transport http football-api https://mcp.5dollarfootballapi.com/mcp --header "Authorization: Bearer fb_live_your_key"

La URL con tu clave es un secreto: cualquiera que la tenga puede gastar tu cuota. Crea una clave separada para ello en tu panel de control y elimina esa clave si la URL se filtra alguna vez.

¿Prefieres ejecutarlo tú mismo? Las configuraciones locales siguientes funcionan de la misma manera.

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 necesita un plan Plus/Pro/Business con el modo Desarrollador habilitado. La ruta más rápida es el servidor alojado: usa https://mcp.5dollarfootballapi.com/mcp/fb_live_your_key como URL del servidor en los pasos siguientes y omite el túnel. Para ejecutar el tuyo propio, inicia 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 2026-08): 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 el acuse de recibo y Crear, luego Conectar. --token importa aquí: ChatGPT no puede enviar cabeceras personalizadas, por lo que el secreto en la ruta es lo que evita que una URL de túnel filtrada gaste tu clave 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.

Para servir a muchos usuarios desde una sola instancia (lo que ejecuta el servidor alojado), usa --hosted en lugar de --http: sin clave API del lado del servidor, cada llamada proporciona la suya propia como /mcp/<api-key> o Authorization: Bearer <api-key>. Colócalo detrás de un proxy inverso que termine TLS y mantenga la ruta fuera del registro de acceso.

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, 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 un solo uso 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 números destacados
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 sus clasificaciones 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
npm start -- --hosted                              # multi-user HTTP, callers bring their own key

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

Licencia

MIT