kronos-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@kronos-mcp find available slots for Saturday at branch 2"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 # для локального запускаПеременная | Обязательна | Что это |
| да | Ключ от вендора, уходит в заголовке |
| нет | По умолчанию |
| нет | Филиал по умолчанию. В сети из нескольких площадок лучше не задавать — см. ниже |
Подключение к MCP-клиенту (Claude Code, Claude Desktop, Cursor):
{
"mcpServers": {
"kronos": {
"command": "/путь/до/kronos-mcp/.venv/bin/kronos-mcp",
"env": { "KRONOS_API_KEY": "ваш-ключ" }
}
}
}Инструменты
Все требуют filial_id — Кронос привязывает каждый запрос к конкретному филиалу.
Чтение
Инструмент | Что делает |
| Свободные слоты — то, что показывают клиенту |
| Все слоты, включая занятые |
| Слоты по типу ресурса, а не по конкретному |
| Ресурсы филиала (залы, аниматоры и т.п.) |
| Услуги и товары филиала |
| Одна запись по id |
| Список записей с фильтрами и пагинацией |
| Кастомные поля, заведённые в аккаунте |
Изменение
Инструмент | Что делает |
| Создать запись: обычную, групповое событие или дочернюю запись в группу |
| Перенести, отменить ( |
| Удалить безвозвратно — обычно лучше отмена через |
| Связать сделку amoCRM с бронью |
| Подписаться на |
Что стоит знать про API Кроноса
Это то, что выяснилось на практике и чего нет в спецификации — ради этих абзацев репозиторий и стоит читать:
filial_idобязателен везде. Поэтому он сделан обязательным параметром, а не берётся из настроек молча: перепутанный филиал — это чужие цены и чужой адрес в ответе клиенту.Платёжных методов в API нет вообще. Встроенный модуль «Платежи» живёт в интерфейсе Кроноса внутри amoCRM и здесь недоступен. Приём денег придётся делать отдельным слоем, а результат записывать в бронь через
kronos_update_event.Минимальный размер группы Кронос не знает. У группового события есть только
max_count— верхняя граница. Правило «не меньше N человек» проверяет ваш код, не API.Форматы ответов не описаны. В спецификации вендора у всех эндпоинтов пустые схемы ответов, поэтому инструменты возвращают JSON как есть.
Отмена лучше удаления.
kronos_update_eventсоstatus_id=0сохраняет историю, аkronos_delete_eventстирает запись совсем. Есть и причины отказа:loss_reason_id1 — нет оплаты, 2 — не пришёл.Групповые события трёхуровневые. Родительское событие (
is_group=true) — это сам сеанс, дочерние записи цепляются к нему черезparent_idи несут своих клиентов и свой заказ.
Статус
Написан по реальной OpenAPI-спецификации вендора (зеркало — reference/openapi.json),
покрывает все 13 операций Public API v1. Структурно проверен: сервер поднимается, инструменты
регистрируются, ошибки долетают читаемым текстом.
Против живого аккаунта не тестировался — на момент публикации у автора не было выданного ключа. Если протестируете, issue и PR приветствуются: особенно интересны реальные формы ответов и поведение групповых событий.
Лицензия
MIT
Available Tools
13 toolskronos_bind_leadAIdempotent
Привязать сделку 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.
Поддерживает три сценария (по официальным примерам вендора):
Обычная индивидуальная запись — заполните order/contact, оставьте is_group пустым.
Групповое событие (сам сеанс/слот) — is_group=True, max_count, group_service_id, без order/contact.
Дочерняя запись на групповое событие (например, доборные дети/доплата) — 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_eventADestructiveIdempotent
Безвозвратно удалить запись, 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_slotsARead-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_fieldsARead-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_eventARead-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_slotsARead-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_typeARead-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_eventsARead-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_resourcesARead-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_servicesARead-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_eventADestructiveIdempotent
Изменить запись — перенос времени, отмена или правка кастомных полей, 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
Scored across 13 tools
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.
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.
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.
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
Schedule, members, and bookings in your AI tools
Manage an EasyWeek business from AI: bookings, availability, customers, services, orders, messaging.
Read AgendaPro bookings, slots, clients, services and sales; create, update and cancel bookings.
Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI agents to manage spa/wellness operations via Zenoti API, including appointments, guests, services, and billing.2357 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables 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
- AlicenseAqualityCmaintenanceEnables 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.5MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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