Futbol Atlas

Atlas de Fútbol — servidor MCP

Las Reglas del 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.

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 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 a 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 en los que coincidió.
answer	question	Responde a una pregunta a partir del corpus. Devuelve las afirmaciones del objeto coincidente con 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 vías de clasificación, fuera de juego, mano y la redacción que las 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 realmente una respuesta

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 en que se verificó por última vez 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 usar 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 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 todos ellos.

Comportamiento que conviene saber antes de integrar

• Solo POST. Cualquier otro método responde 405 con una cabecera Allow: POST, OPTIONS.
• Límite de velocidad: 120 solicitudes 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 solicitud se atiende.
• 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 solicitud tienen un límite y se validan antes del transporte.

Privacidad

Sin cuentas, sin cookies, sin anuncios. El uso se mide de forma agregada con identificadores hash rotados diariamente 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 basa 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 marco de código fuente disponible para convertir un grafo de conocimiento en un sitio web, una API, un servidor MCP y archivos legibles por agentes desde una única fuente, bajo evaluación externa.

El código del marco 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 basa 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.