Football Atlas — MCP server

Las Reglas de Juego y las principales competiciones del fútbol mundial, cada afirmación citada a fuentes primarias

Un servidor MCP remoto sobre un grafo de conocimiento curado. Cada afirmación que devuelve está vinculada a una fuente registrada: las herramientas entregan afirmaciones con sus citas y un valor de confianza, para que un agente pueda mostrar su trabajo en lugar de afirmar sin más.

Nada que instalar. Es un endpoint streamable-HTTP alojado:

https://futbolatlas.app/mcp

Añádelo a un cliente

Claude Code

claude mcp add --transport http futbol-atlas https://futbolatlas.app/mcp

Claude Desktop / cualquier cliente que lea mcpServers

{
  "mcpServers": {
    "futbol-atlas": {
      "type": "streamable-http",
      "url": "https://futbolatlas.app/mcp"
    }
  }
}

Sin API key, sin cuenta, sin autenticación. Solo lectura.

Comprueba que responde, sin ningún cliente:

curl -s https://futbolatlas.app/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'mcp-protocol-version: 2025-06-18' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Related MCP server: football-scraper-mcp

Herramientas

Ocho, cada una con un outputSchema, cada una devuelve structuredContent.

La ruta prevista es get_overview → search o answer → get_entity → get_related. get_overview existe porque un agente que acaba de llegar necesita saber si este corpus puede ayudar antes de gastar una llamada adivinando.

Qué contiene el corpus

Materia: las diecisiete Reglas de Juego tal como las redacta la IFAB, el protocolo del VAR y sus categorías de revisión, los formatos de competición y las vías de clasificación, el fuera de juego, la mano y la redacción que los decide.

Preguntas para las que está diseñado

• ¿Qué dice exactamente la Regla 11 sobre la posición de un jugador en el momento en que se juega el balón?

• ¿Cuándo puede intervenir el VAR y cuándo tiene prohibido hacerlo?

• ¿Cómo se clasifica un equipo para la fase de liga de la Champions League?

Cómo es una respuesta de verdad

Una llamada real contra el endpoint en vivo — answer con "when can VAR intervene" — devuelve este structuredContent, recortado:

{
  "answered": true,
  "entity": {
    "id": "var",
    "name": "VAR (Video Assistant Referee)",
    "evidence_tier": "primary",
    "confidence": 0.94,
    "last_verified": "2026-08-08",
    "canonical_url": "https://futbolatlas.app/k/var"
  },
  "claims": [
    {
      "text": "The VAR may assist the referee only for a clear and obvious error or a serious missed incident in these match-changing categories: goal/no goal, penalty/no penalty, direct red card, and mistaken identity when the referee cautions or sends off the wrong player of the offending team.",
      "sources": [{ "title": "Video Assistant Referee (VAR) protocol (Laws of the Game 2026/27)" }]
    }
  ]
}

Observa lo que viaja con la respuesta: el nivel de evidencia, una confianza, la fecha de última verificación y la fuente detrás de la afirmación — no como prosa que un agente tenga que analizar, sino como campos sobre los que puede actuar. Un agente puede rechazar una afirmación débil o citar directamente la fuente primaria.

Cuando el corpus no puede responder, answered es false. No improvisa, y el fallo queda registrado para que se pueda cubrir el vacío.

Superficies legibles por máquina

El endpoint MCP es uno de varios. El mismo corpus se sirve como archivos de texto plano que un agente puede leer directamente:

Cada objeto de conocimiento tiene una página para humanos y un gemelo de máquina con el mismo id, con una URL canónica que coincide en todos ellos.

Comportamiento que conviene conocer antes de integrar

• Solo POST. Cualquier otro método responde 405 con una cabecera Allow: POST, OPTIONS.

• Límite de tasa: 120 peticiones por minuto por cliente, contadas en un almacén compartido, publicadas en cada respuesta como RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset (las tres expuestas vía CORS). Falla en abierto: si el almacén no es accesible, la petición se sirve.

• Entrada malformada recibe un error JSON-RPC correcto según la especificación — -32700 para cuerpos no analizables, -32602 para una herramienta desconocida — nunca una página de error HTML.

• Los cuerpos de petición están limitados y se validan antes del transporte.

Privacidad

Sin cuentas, sin cookies, sin anuncios. El uso se mide de forma agregada con identificadores con hash que rotan a diario y una retención de 200 días; las IP sin procesar nunca se almacenan. Política completa: PRIVACY.md.

Procedencia y licencia

El contenido de conocimiento es CC-BY-4.0: úsalo, cítalo. El registro de fuentes es público precisamente para que una afirmación pueda comprobarse en lugar de confiarse en ella — get_sources devuelve en qué se apoya cualquier afirmación.

Las afirmaciones llevan un nivel de evidencia y una fecha last_verified. Cuando la evidencia es más débil, el objeto lo dice en lugar de redondear al alza.

Cómo está construido

Compilado y servido por Citarium, un framework de código abierto para convertir un grafo de conocimiento en un sitio web, una API, un servidor MCP y archivos legibles por agentes desde una única fuente — en evaluación externa, con los guardianes y el registro de falsación a la vista.

Este repositorio es la cara pública del servidor: su manifiesto y su documentación. El corpus en sí vive en futbolatlas.app.