Skip to main content
Glama

Расписание записи на встречи

save_scheduler
Destructive

Создаёт расписание записи, а с указанным scheduler_id — правит существующее; не переданные поля не трогаются. Время задаётся двумя способами: weekly — повторяющиеся часы по дням недели, самый частый случай; slots — список конкретных дат и интервалов для разовых встреч. Все даты и часы указываются в часовом поясе расписания, а не респондента: респонденту слоты пересчитываются при показе.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "workspace_id": "<workspace_id>"
    },
    "name": "save_scheduler"
  }
}

Input Schema

NameRequiredDescriptionDefault
nameNoНазвание расписания, до 250 символов.
colorNoЦвет расписания в интерфейсе.
weeklyNoРабочие часы по дням недели: [{"day": 1, "intervals": [{"start": "10:00", "end": "18:00"}]}]. День 1 — понедельник.
timezoneNoЧасовой пояс расписания, например Europe/Moscow.
is_activeNoПринимает ли расписание записи.
overridesNoИсключения на диапазон дат: [{"dateFrom": "2026-09-10", "dateTo": "2026-09-12", "intervals": [{"start": "12:00", "end": "15:00"}], "comment": "короткие дни"}].
daily_limitNoМаксимум записей в день. null — без ограничения.
descriptionNoОписание, которое видит респондент.
max_advanceNoНасколько вперёд открыта запись: {"type": "rolling", "days": 30}, {"type": "range", "from": "2026-09-01", "to": "2026-12-31"} или {"type": "infinite"}.
admin_emailsNoАдреса администраторов через запятую.
buffer_afterNoСвободные минуты после встречи.
manual_slotsNoКонкретные слоты для режима slots: [{"date": "2026-09-10", "start": "10:00", "end": "10:30", "seats": 1}].
notify_adminNoСлать администратору письма о новых записях.
scheduler_idNoID расписания для правки. Не передавайте, чтобы создать новое.
workspace_idYesID воркспейса (из workspace://list).
buffer_beforeNoСвободные минуты перед встречей.
location_typeNoГде проходит встреча: online, phone, address или custom.
schedule_modeNoweekly — повторяющиеся часы по дням недели, slots — список конкретных дат.
slot_durationNoДлительность встречи в минутах, от 5 до 1440.
location_valueNoСама ссылка, телефон или адрес.
seats_per_slotNoСколько человек помещается в один слот.
slot_incrementNoШаг сетки слотов в минутах. null — сетка идёт по длительности встречи.
confirmation_modeNoauto — запись подтверждается сразу, manual — подтверждаете вручную.
notify_respondentNoСлать респонденту письма о записи.
min_notice_minutesNoЗа сколько минут до начала ещё можно записаться.
allow_respondent_cancelNoРазрешить респонденту отменить запись по ссылке из письма.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description adds real behavior beyond the annotations: partial-update semantics ('не переданные поля не трогаются') and the rule that dates are interpreted in the schedule's timezone, not the respondent's. However, the annotations flag destructiveHint=true and the description never explains what is destructive — whether editing replaces overrides or what happens to already-booked meetings — so the highest-risk trait stays undisclosed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, all front-loaded and purposeful: create/edit branch first, mode choice second, timezone caveat third. Minor overlap with the schema's own explanation of weekly and slots keeps it just short of ideal.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 26-parameter, destructive, non-idempotent writer with no output schema, the description covers the create/update branch and the two scheduling modes but says nothing about required workspace_id, what the call returns, or the consequences of editing an active schedule with existing bookings. Adequate to invoke safely in the common case, incomplete for the risky ones.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3; the description earns more by explaining the interaction between schedule_mode and its two payload families (weekly vs manual_slots) and by stating the timezone interpretation rule for all date/time inputs, which the per-field schema text does not connect. With 26 parameters it still leaves optional behaviors like confirmation_mode, buffers and notifications untouched, having already been documented in-schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource ('Создаёт расписание записи') and immediately clarifies the upsert branch ('с указанным scheduler_id — правит существующее'), which is exactly what distinguishes it from delete_scheduler and duplicate_scheduler. An agent knows what the tool does and how it differs from siblings without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives explicit selection guidance: omit scheduler_id to create, pass it to edit, and use weekly as 'самый частый случай' versus slots for one-off dates. What is missing is any statement about when NOT to use it (e.g., use delete_scheduler to remove, duplicate_scheduler to copy), so the routing guidance is strong but not exhaustive.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources