Football Atlas — MCP-сервер

Правила игры и главные соревнования мирового футбола, каждое утверждение со ссылкой на первоисточник

Удалённый MCP-сервер на основе курируемого графа знаний. Каждое утверждение, которое он возвращает, привязано к зарегистрированному источнику: инструменты возвращают утверждения вместе с их цитатами и значением уверенности, так что агент может показать свою работу, а не просто утверждать.

Ничего устанавливать не нужно. Это размещённая конечная точка streamable-HTTP:

https://futbolatlas.app/mcp

Добавьте его в клиент

Claude Code

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

Claude Desktop / любой клиент, читающий mcpServers

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

Никакого API-ключа, никакого аккаунта, никакой аутентификации. Только чтение.

Проверьте, что он отвечает, вообще без клиента:

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

Инструменты

Восемь, каждый с outputSchema, каждый возвращает structuredContent.

Предполагаемый путь: get_overview → search или answer → get_entity → get_related. get_overview существует потому, что агенту, который только что прибыл, нужно узнать, может ли этот корпус помочь, прежде чем тратить вызов на догадки.

Что в корпусе

Предметная область: семнадцать Правил игры в том виде, в котором их пишет IFAB, протокол VAR и его категории пересмотра, форматы соревнований и пути квалификации, офсайд, игра рукой и формулировки, которые решают исход.

Вопросы, на которые он создан отвечать

• Что именно говорит Правило 11 о позиции игрока в момент, когда мяч сыгран?

• Когда VAR может вмешиваться, а когда ему это запрещено?

• Как команда квалифицируется в лиговый этап Лиги чемпионов?

Как на самом деле выглядит ответ

Реальный вызов к живому эндпоинту — answer с вопросом "when can VAR intervene" — возвращает такой structuredContent, сокращённый:

{
  "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)" }]
    }
  ]
}

Обратите внимание, что путешествует вместе с ответом: уровень доказательности, уверенность, дата последней проверки и источник, стоящий за утверждением — не проза, которую агенту нужно разбирать, а поля, на основе которых он может действовать. Агент может отказаться от слабого утверждения или сослаться на первоисточник напрямую.

Когда корпус не может ответить, answered равен false. Он не импровизирует, и промах фиксируется, чтобы пробел можно было заполнить.

Машиночитаемые поверхности

MCP-эндпоинт — одна из нескольких. Тот же корпус подаётся как обычные файлы, которые агент может читать напрямую:

Каждый объект знаний имеет человеческую страницу и машинного двойника по тому же id, с каноническим URL, который совпадает во всех них.

Поведение, о котором стоит знать перед интеграцией

• Только POST. Любой другой метод отвечает 405 с заголовком Allow: POST, OPTIONS.

• Лимит запросов: 120 запросов в минуту на клиента, учитывается в общем хранилище, публикуется в каждом ответе как RateLimit-Limit, RateLimit-Remaining и RateLimit-Reset (все три доступны через CORS). Он отказывает открыто: если хранилище недоступно, запрос обслуживается.

• Некорректный ввод получает спецификационно-корректную ошибку JSON-RPC — -32700 для неразбираемых тел, -32602 для неизвестного инструмента — никогда не HTML-страницу ошибки.

• Тела запросов ограничены по размеру и проверяются до транспорта.

Конфиденциальность

Никаких аккаунтов, никаких куки, никакой рекламы. Использование измеряется в агрегированном виде с ежедневно ротируемыми хешированными идентификаторами и хранением в течение 200 дней; сырые IP-адреса никогда не сохраняются. Полная политика: PRIVACY.md.

Происхождение и лицензия

Контент знаний — CC-BY-4.0: используйте, цитируйте. Реестр источников публичен именно для того, чтобы утверждение можно было проверить, а не просто доверять ему — get_sources возвращает то, на чём держится любое данное утверждение.

Утверждения несут уровень доказательности и дату last_verified. Там, где доказательства слабее, объект говорит об этом, а не округляет в большую сторону.

Как это устроено

Скомпилировано и обслуживается Citarium — открытым фреймворком для превращения графа знаний в веб-сайт, API, MCP-сервер и читаемые агентом файлы из единого источника — в условиях внешней оценки, с хранителями и записью о фальсификациях в открытом доступе.

Этот репозиторий — публичное лицо сервера: его манифест и документация. Сам корпус живёт на futbolatlas.app.