Skip to main content
Glama

kronos-mcp

MCP-сервер для Кронос 2.0 — российской системы онлайн-записи и управления расписанием (вендор ООО «Генезис», crns.io), которая работает как приложение внутри amoCRM.

Даёт языковой модели прямой доступ к бронированиям: свободные слоты, ресурсы, услуги, создание и перенос записей, привязка сделки amoCRM к брони, подписка на вебхуки.

In short: an MCP server for Kronos 2.0, a Russian booking/scheduling SaaS used by quest rooms, kids' entertainment venues and similar businesses. 13 tools over its Public API v1.


Зачем

Кронос закрывает расписание и брони, но его API не самый очевидный: документации в публичном поиске нет, ключ выдают по запросу, а половина важных деталей не описана в спецификации вовсе. Этот сервер убирает эту возню — модель просто вызывает инструменты с понятными именами и получает данные, а все заголовки, обязательные параметры и обработка ошибок уже внутри.

Подойдёт, если вы делаете бота-администратора, ассистента для менеджеров или любую автоматизацию поверх записи клиентов.

Related MCP server: cronmanager-mcp

Установка

git clone https://github.com/RealSatanyan/kronos-mcp.git
cd kronos-mcp
python3 -m venv .venv && source .venv/bin/activate
pip install -e .

Нужен Python 3.10+.

Настройка

Ключ API запрашивается у вендора — он не выдаётся самообслуживанием: t.me/gnzs_bot, hello@gnzs.ru.

cp .env.example .env   # для локального запуска

Переменная

Обязательна

Что это

KRONOS_API_KEY

да

Ключ от вендора, уходит в заголовке X-API-KEY

KRONOS_BASE_URL

нет

По умолчанию https://genezis-platform-api.gnzs.ru

KRONOS_DEFAULT_FILIAL_ID

нет

Филиал по умолчанию. В сети из нескольких площадок лучше не задавать — см. ниже

Подключение к MCP-клиенту (Claude Code, Claude Desktop, Cursor):

{
  "mcpServers": {
    "kronos": {
      "command": "/путь/до/kronos-mcp/.venv/bin/kronos-mcp",
      "env": { "KRONOS_API_KEY": "ваш-ключ" }
    }
  }
}

Инструменты

Все требуют filial_id — Кронос привязывает каждый запрос к конкретному филиалу.

Чтение

Инструмент

Что делает

kronos_get_available_slots

Свободные слоты — то, что показывают клиенту

kronos_get_time_slots

Все слоты, включая занятые

kronos_get_time_slots_by_resource_type

Слоты по типу ресурса, а не по конкретному

kronos_list_resources

Ресурсы филиала (залы, аниматоры и т.п.)

kronos_list_services

Услуги и товары филиала

kronos_get_event

Одна запись по id

kronos_list_events

Список записей с фильтрами и пагинацией

kronos_get_custom_fields

Кастомные поля, заведённые в аккаунте

Изменение

Инструмент

Что делает

kronos_create_event

Создать запись: обычную, групповое событие или дочернюю запись в группу

kronos_update_event

Перенести, отменить (status_id=0) или поправить кастомные поля

kronos_delete_event

Удалить безвозвратно — обычно лучше отмена через update

kronos_bind_lead

Связать сделку amoCRM с бронью

kronos_subscribe_webhook

Подписаться на create_event / update_event / delete_event

Что стоит знать про API Кроноса

Это то, что выяснилось на практике и чего нет в спецификации — ради этих абзацев репозиторий и стоит читать:

  • filial_id обязателен везде. Поэтому он сделан обязательным параметром, а не берётся из настроек молча: перепутанный филиал — это чужие цены и чужой адрес в ответе клиенту.

  • Платёжных методов в API нет вообще. Встроенный модуль «Платежи» живёт в интерфейсе Кроноса внутри amoCRM и здесь недоступен. Приём денег придётся делать отдельным слоем, а результат записывать в бронь через kronos_update_event.

  • Минимальный размер группы Кронос не знает. У группового события есть только max_count — верхняя граница. Правило «не меньше N человек» проверяет ваш код, не API.

  • Форматы ответов не описаны. В спецификации вендора у всех эндпоинтов пустые схемы ответов, поэтому инструменты возвращают JSON как есть.

  • Отмена лучше удаления. kronos_update_event со status_id=0 сохраняет историю, а kronos_delete_event стирает запись совсем. Есть и причины отказа: loss_reason_id 1 — нет оплаты, 2 — не пришёл.

  • Групповые события трёхуровневые. Родительское событие (is_group=true) — это сам сеанс, дочерние записи цепляются к нему через parent_id и несут своих клиентов и свой заказ.

Статус

Написан по реальной OpenAPI-спецификации вендора (зеркало — reference/openapi.json), покрывает все 13 операций Public API v1. Структурно проверен: сервер поднимается, инструменты регистрируются, ошибки долетают читаемым текстом.

Против живого аккаунта не тестировался — на момент публикации у автора не было выданного ключа. Если протестируете, issue и PR приветствуются: особенно интересны реальные формы ответов и поведение групповых событий.

Лицензия

MIT

Available Tools

13 tools
kronos_bind_leadA
Idempotent

Привязать сделку amoCRM к записи Кронос, POST /api/v1/event/bind-lead.

Это единственный официальный мост между amoCRM и Кронос в Public API v1 — вызывайте его сразу после kronos_create_event, передав id только что созданной сделки в amoCRM и id только что созданной записи в Кронос.

Args: params (BindLeadInput): filial_id, lead_id (id сделки amoCRM), event_id (id записи Кронос) — все обязательны.

Returns: str: JSON-ответ Кронос как есть.

Inputs: params (required). Returns: result

kronos_create_eventA

Создать запись (бронь) в Кронос, POST /api/v1/event.

Поддерживает три сценария (по официальным примерам вендора):

  1. Обычная индивидуальная запись — заполните order/contact, оставьте is_group пустым.

  2. Групповое событие (сам сеанс/слот) — is_group=True, max_count, group_service_id, без order/contact.

  3. Дочерняя запись на групповое событие (например, доборные дети/доплата) — parent_id указывает на id уже созданного группового события, count — сколько мест занимает эта дочерняя запись, свои order/contact.

ВАЖНО: max_count — это верхний предел вместимости, Кронос НЕ проверяет никакой нижний порог (минимальный размер группы) — эту валидацию должен делать вызывающий код, полагаться на API тут нельзя.

Args: params (CreateEventInput): filial_id, date_from, date_to, time_from, time_to (обязательны); остальные поля см. описание модели — status_id, name, parent_id, count, is_group, max_count, group_service_id, resources, order, contact, custom_fields, analytics (все опциональны, зависят от сценария).

Returns: str: JSON-ответ Кронос (201) как есть — форма не задокументирована вендором, но по аналогии с {id} в bind-lead ожидается id созданной записи.

Error Handling: - "Error: Kronos rejected the request (HTTP 401/403)..." при неверном ключе/филиале - "Error: Kronos API request failed with HTTP 400..." при неверной комбинации полей (например is_group=True вместе с contact) — проверьте тело ошибки в сообщении

Inputs: params (required). Returns: result

kronos_delete_eventA
DestructiveIdempotent

Безвозвратно удалить запись, DELETE /api/v1/event/{id}.

Предпочитайте kronos_update_event со status_id=0 для обычной отмены брони — она сохраняет историю. Используйте это только когда запись должна исчезнуть полностью (например, была создана ошибочно).

Args: params (DeleteEventInput): filial_id, event_id (обязательны).

Returns: str: JSON-ответ Кронос как есть.

Inputs: params (required). Returns: result

kronos_get_available_slotsA
Read-onlyIdempotent

Получить только СВОБОДНЫЕ слоты времени, GET /api/v1/available-slots.

Это основной инструмент для показа клиенту доступных дат/времени при бронировании — в отличие от kronos_get_time_slots, здесь уже отфильтрованы занятые слоты.

Args: params (GetAvailableSlotsInput): filial_id, resource_id (список id ресурсов, обязателен), date (YYYY-MM-DD, опционально), day_count (1-30, по умолчанию 1), interval (5-720 минут, по умолчанию 60).

Returns: str: JSON-ответ Кронос как есть (форма ответа не документирована вендором).

Examples: - Use when: "какие свободные слоты на ближайшую субботу для площадки Северок" - Don't use when: нужна полная занятость слота (используйте kronos_get_time_slots)

Inputs: params (required). Returns: result

kronos_get_custom_fieldsA
Read-onlyIdempotent

Получить список пользовательских полей записи, настроенных в аккаунте, GET /api/v1/custom-fields/{accountId}.

Нужно, чтобы узнать реальные id и типы кастомных полей перед тем как передавать custom_fields в kronos_create_event / kronos_update_event.

Args: params (GetCustomFieldsInput): filial_id, account_id (обязательны).

Returns: str: JSON-ответ Кронос как есть.

Inputs: params (required). Returns: result

kronos_get_eventA
Read-onlyIdempotent

Получить данные одной записи (брони) по id, GET /api/v1/event/{id}.

Args: params (GetEventInput): filial_id, event_id (обязательны).

Returns: str: JSON-ответ Кронос как есть.

Error Handling: - "Error: Not found (HTTP 404)..." если записи с таким id нет в этом филиале

Inputs: params (required). Returns: result

kronos_get_time_slotsA
Read-onlyIdempotent

Получить все слоты времени по ресурсам (включая занятые), GET /api/v1/time-slots.

Используйте kronos_get_available_slots, если нужны только свободные слоты для показа клиенту — этот инструмент возвращает полную картину (занято + свободно), полезно для административного/диагностического просмотра расписания.

Args: params (GetTimeSlotsInput): filial_id, resource_id (список id ресурсов, обязателен), date (YYYY-MM-DD, опционально), day_count (1-30, по умолчанию 1), interval (5-720 минут, по умолчанию 60).

Returns: str: JSON-ответ Кронос как есть (форма ответа не документирована вендором).

Error Handling: - "Error: filial_id is required..." если не передан и не задан KRONOS_DEFAULT_FILIAL_ID - "Error: Kronos rejected the request (HTTP 401/403)..." при неверном API-ключе или недоступном филиале

Inputs: params (required). Returns: result

kronos_get_time_slots_by_resource_typeA
Read-onlyIdempotent

Получить слоты времени по типу ресурса (а не по конкретному id), GET /api/v1/time-slots/resource-type.

Полезно, когда бронирование должно быть безразлично к конкретному зáлу/аниматору — например «любой доступный зал этого типа на 14:50».

Args: params (GetTimeSlotsByResourceTypeInput): filial_id, resource_type_id (обязателен), date, day_count, interval.

Returns: str: JSON-ответ Кронос как есть.

Inputs: params (required). Returns: result

kronos_list_eventsA
Read-onlyIdempotent

Получить список записей (броней) с фильтрами, GET /api/v1/events.

Поддерживает пагинацию (page/limit) и фильтры по датам, ресурсам, услугам, id и родительскому групповому событию (parent_id — чтобы получить всех «доборных детей» конкретного группового слота).

Args: params (ListEventsInput): filial_id (обязателен); page, limit, ids, parent_id, date_from, date_to, resources, products — все опциональны.

Returns: str: JSON-ответ Кронос как есть (форма пагинации не задокументирована вендором — проверить на реальном аккаунте).

Inputs: params (required). Returns: result

kronos_list_resourcesA
Read-onlyIdempotent

Получить список ресурсов филиала (залы, аниматоры и т.п.), GET /api/v1/resources.

Используйте это, чтобы узнать реальные id ресурсов перед вызовом kronos_get_time_slots / kronos_get_available_slots / kronos_create_event — эти id не задокументированы заранее, их нужно получать именно через этот инструмент.

Args: params (ListResourcesInput): filial_id (обязателен), resource_type_id (опциональный список для фильтрации по типу).

Returns: str: JSON-ответ Кронос как есть.

Inputs: params (required). Returns: result

kronos_list_servicesA
Read-onlyIdempotent

Получить список услуг/товаров филиала, GET /api/v1/services.

Нужно, чтобы узнать реальные id услуг (в т.ч. group_service_id для группового события) перед вызовом kronos_create_event.

Args: params (ListServicesInput): filial_id (обязателен).

Returns: str: JSON-ответ Кронос как есть.

Inputs: params (required). Returns: result

kronos_subscribe_webhookA

Подписаться на пуш-вебхуки по событиям записи, POST /api/v1/webhooks/subscribe.

Кронос будет отправлять POST-запросы на указанный url при create_event/update_event/ delete_event — это единственный push-механизм (в остальном API — pull/polling). Идемпотентность повторных вызовов с теми же параметрами не задокументирована вендором (может создавать дублирующиеся подписки) — проверить на реальном аккаунте.

Args: params (SubscribeWebhookInput): filial_id, url, actions (список из create_event/ update_event/delete_event, обязательны); filial_ids — опциональный список для ограничения вебхуков конкретными филиалами (по умолчанию — все филиалы аккаунта).

Returns: str: JSON-ответ Кронос как есть.

Inputs: params (required). Returns: result

kronos_update_eventA
DestructiveIdempotent

Изменить запись — перенос времени, отмена или правка кастомных полей, PATCH /api/v1/event.

Три типовых сценария:

  • Перенос: передайте date_from/date_to/time_from/time_to.

  • Отмена: передайте status_id=0 (это штатный способ отмены с сохранением истории — предпочтительнее, чем kronos_delete_event, которое удаляет запись безвозвратно). Можно дополнительно передать loss_reason_id (1 = Нет оплаты, 2 = Не пришёл).

  • Правка кастомных полей: передайте custom_fields — непереданные поля сохраняют текущее значение, пустая строка очищает значение поля.

Args: params (UpdateEventInput): filial_id, id (обязательны); date_from, date_to, time_from, time_to, status_id, loss_reason_id, custom_fields (опциональны, передайте только то, что действительно меняете).

Returns: str: JSON-ответ Кронос как есть.

Inputs: params (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 13 tools

    Disambiguation4/5

    The three slot-related tools have overlapping surface, but each is explicitly documented for a distinct scenario: full schedule, client-facing free slots, and resource-type-agnostic slots. All other tools target clearly separate resources/actions, so an agent can reliably differentiate with the descriptions.

    Naming Consistency4/5

    All tools share the kronos_ prefix and use snake_case, but retrieval verbs are inconsistent: list_resources/list_services/list_events vs get_event/get_time_slots/get_available_slots/get_custom_fields. This is a minor deviation; the pattern is still mostly predictable.

    Tool Count5/5

    13 tools is well-scoped for a booking/event management API: lookup, availability, CRUD, webhooks, custom fields, and CRM integration are each represented. No tool feels redundant, and the count is reasonable for the domain.

    Completeness4/5

    Event lifecycle is well covered with create, get, list, update, and delete, plus availability, services, resources, webhooks, and lead binding. A minor gap is the lack of an explicit resource-type listing tool and limited webhook management, but these are workable with existing tools.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables managing cron jobs, maintenance windows, and settings through natural language by exposing the Cronmanager REST API as MCP tools for LLM clients like Claude.
      GPL 3.0
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to look up businesses, find free appointment slots, book, list and cancel appointments at salons, barbershops, nail and brow studios and clinics. Works read-only without a customer login by returning a pre-filled booking link, and can also run against a built-in demo with sample businesses.
      5
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to read agents, teams, appointment types, bookable resources, and scheduling requests from the TimeZest API, and to create a scheduling request when explicitly requested, optionally linked to a PSA ticket. This supports appointment-booking workflows where MSP customers book time with technicians from PSA tickets.
      Apache 2.0