Документация1С-Битрикс: Модулиnative.mcpРазработчикамПримеры инструментов

Версия модуля

Встроенный инструмент module_info возвращает код, версию и дату версии API-платформы. Аргументов у инструмента нет. Общие правила публикации — в разделе «Инструменты».

Роут в карте

PHP
'mcp/module' => [
    RouteConfig::DESCRIPTION => '«MCP-шлюз»: версия и дата версии модуля «API-платформа»',
    RouteConfig::ROUTE_TYPE => RouteConfig::ROUTE_TYPE_MCP,
    ControllerConfig::CONTROLLER => [Info::class, 'module'],
    RouteConfig::FORMAT => TypeConfig::FORMAT_JSON,
    RouteConfig::SECURITY => [
        SecurityConfig::AUTH => SecurityConfig::TOKEN,
        SecurityConfig::GROUP => [SecurityConfig::WHITELIST => ['NATIVE_MCP_CLIENT']],
    ],
    RouteConfig::CACHE => [CacheConfig::TTL => 0],
    ToolConfig::ROUTE_PUBLICATION => [
        ToolConfig::CODE => 'module_info',
        ToolConfig::DESCRIPTION => 'Получить версию и дату модуля «API-платформа» (native.api)',
        ToolConfig::ANNOTATIONS => [ToolConfig::ANNOTATION_READ_ONLY => true],
    ],
],

Контроллер

PHP
public function module(): array
{
    $date = ModuleApi::getVersionDate();

    return [
        'id' => ModuleApi::getModuleId(),
        'version' => ModuleApi::getVersion(),
        'version_date' => $date?->toString(),
        'timestamp' => ['version_date' => $date?->getTimestamp()],
    ];
}

Дата версии возвращается строкой для модели и меткой времени во вложенном timestamp для вычислений. Если даты нет, оба значения равны null. Результат вызова:

JSON
{
  "id": "native.api",
  "version": "2.0.0",
  "version_date": "15.09.2026 20:30:00",
  "timestamp": {"version_date": 1789504200}
}

Задача агенту

Текст
Какая версия API-платформы установлена на сайте?

Агент вызовет module_info без аргументов и ответит версией и датой версии.