Futbol Atlas

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

Documentación

Futbol Atlas — Servidor MCP

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

Un servidor MCP remoto basado en 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 alojado de HTTP transmisible:

https://futbolatlas.app/mcp

También listado en Smithery.

Añadirlo 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 clave de API, 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"}'

Herramientas

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

herramienta	argumentos	qué hace
`get_overview`	—	Visión general del corpus: qué sabe esta instancia, recuentos por tipo, etiquetas publicadas, frescura. Empieza aquí cuando llegues y aún no sepas si este corpus puede responder tu pregunta.
`search`	`query`, `limit?`	Búsqueda de texto completo sobre el grafo de conocimiento. Insensible a acentos y apóstrofos, así que consulta con las propias palabras del usuario; cada resultado lleva su puntuación de relevancia y los campos que coincidieron.
`answer`	`question`	Responde una pregunta a partir del corpus. Devuelve las afirmaciones del objeto coincidente con sus fuentes y confianza — nunca una respuesta sin fuente.
`get_entity`	`id`	Obtiene un objeto de conocimiento por id, con sus afirmaciones y las fuentes que cita cada afirmación.
`get_topic`	`tag`	Lista los objetos de conocimiento que llevan una etiqueta (los temas son etiquetas respaldadas por contenido).
`get_related`	`id`	Vecinos del grafo de un objeto: relaciones salientes y entrantes, cada una con su tipo de relación.
`get_sources`	`object_id?`	El registro completo de fuentes, o solo las fuentes citadas por un objeto. Úsalo para juzgar el corpus antes de confiar en él.
`get_latest`	`limit?`	Objetos de conocimiento verificados más recientemente — una señal de frescura.

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é hay en el corpus


objetos de conocimiento	141
fuentes registradas	132
temas publicados	96

tipo	objetos
entidad	114
glosario	12
faq	7
guía	5
comparación	3

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

Preguntas para las que está construido

¿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 le está prohibido?
¿Cómo se clasifica un equipo para la fase de liga de la Champions League?

Cómo se ve una respuesta real

Una llamada real al endpoint en vivo — answer con "cuándo puede intervenir el VAR" — 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 parsear, 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 la brecha pueda llenarse.

Superficies legibles por máquina

El endpoint MCP es una de varias. El mismo corpus se sirve como archivos planos que un agente puede leer directamente:

superficie	qué es
`/llms.txt`	el índice, como `text/plain`
`/llms-full.txt`	todo el corpus en un solo archivo
`/ai-index.json`	cada superficie que publica esta instancia, con su tipo de contenido
`/api/index.json`	un documento JSON por objeto de conocimiento
`/api/sources.json`	el registro de fuentes, completo
`/.well-known/mcp/server.json`	el manifiesto de este servidor

Cada objeto de conocimiento tiene una página humana y un gemelo de máquina con el mismo id, con una URL canónica que coincide en todas ellas.

El `version` en el `server.json` de este repositorio

Es la versión del corpus, no la del framework (ADR-017): un corpus que creció en cuarenta objetos debe poder republicarse sin esperar a que alguien haga un lanzamiento de software, y un parche del framework no debe anunciar "nueva versión" para corpus que no cambiaron. El valor autoritativo es el que genera y sirve el sitio — el campo version de /.well-known/mcp/server.json, junto a _citarium.corpus_version.

La copia en este repositorio se mantiene a mano y se desvió: estaba en 0.6.5 mientras el sitio servía 2026.809.141. Antes de publicar en el Registro MCP, copia el valor servido. Por lo demás, los dos archivos NO son idénticos a propósito — este lleva ?via=registry en su remoto y el servido lleva ?via=manifest, para que el tráfico de cada canal pueda distinguirse.

Comportamiento que conviene saber antes de integrar

Solo POST. Cualquier otro método responde 405 con una cabecera Allow: POST, OPTIONS.
Límite de tasa: 120 solicitudes por minuto por cliente, contadas en un almacén compartido, publicado en cada respuesta como RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset (los tres expuestos vía CORS). Falla en abierto: si el almacén no está disponible, la solicitud se atiende.
Entrada malformada recibe un error JSON-RPC correcto según la especificación — -32700 para cuerpos no parseables, -32602 para una herramienta desconocida — nunca una página de error HTML.
Los cuerpos de solicitud 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 hash rotados a diario y una retención de 200 días; las IP brutas 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 — get_sources devuelve en qué se apoya cualquier afirmación dada.

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

Cómo está construido

Compilado y servido por Citarium, un framework de código disponible para convertir un grafo de conocimiento en un sitio web, una API, un servidor MCP y archivos legibles por agentes desde una sola fuente, bajo evaluación externa.

El código del framework está licenciado bajo la Business Source License 1.1 y su repositorio no es público. Lo que es público — y lo que realmente importa para confiar en una respuesta — es este servidor, el corpus que sirve y la fuente registrada detrás de cada afirmación: get_sources devuelve en qué se apoya cualquier afirmación dada, para que pueda comprobarse en lugar de confiarse.

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