Skip to main content
Glama

Что изменилось с прошлого раза

hse_changes
Read-onlyIdempotent

Track changes to HSE deadlines, schedule, inbox and claims: returns only new, updated, removed, moved or overdue items since the last confirmed snapshot.

Instructions

Снимает текущее состояние дедлайнов, расписания, входящего и заявок (по явной просьбе — оценок) и возвращает ТОЛЬКО изменения с прошлого снимка: новое, изменено, пропало, перенесено, просрочено. Для «что есть сейчас» используйте my_today/my_week/my_deadlines. Первый вызов по источнику создаёт базу без событий (status: baseline). События не теряются, если ответ не дошёл: курсор двигается только явным подтверждением — передайте ackSeq из ответа в параметр ack следующего вызова; без ack те же события вернутся снова. Если persisted: false (запись на диск не удалась), у ответа нет ackSeq (null), у событий нет seq, и события повторятся в следующем вызове — подтверждать нечего. В ответе не более 200 событий: если omitted > 0, ответ усечён — передайте ackSeq ответа в ack и вызовите тул снова, чтобы получить остальное; усечённый ответ не считайте полным. Тул только ЧИТАЕТ системы ВШЭ и пишет лишь локальную базу снимков. «Пропало из календаря» не означает «сдано». Область grades дорогая (страница на курс, десятки секунд) и берёт оценки только из журнала LMS. Возвращает JSON: changes, scopes (статус по областям), sources (статус каждого источника; отказ одного не роняет вызов), ackSeq, omitted, gap, persisted, warnings.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "hse_changes"
  }
}

Input Schema

NameRequiredDescriptionDefault
ackNoПередавайте ТОЛЬКО ackSeq из последнего ответа hse_changes (число; null не нужен — просто опустите параметр, если ackSeq был null). seq отдельного события подтверждением НЕ является. События до ackSeq считаются полученными и больше не возвращаются.
freshNotrue — игнорировать кэш (иначе принимаются данные не старше 60 с).
sinceNoЖурнал за период ("7d", "12h" или дата ISO) вместо неподтверждённого; since сам курсор не двигает (ack в том же вызове двигает).
scopesNoОбласти; по умолчанию deadlines, schedule, inbox, claims (без grades).
coursesNoФильтр курсов для grades: число — id курса, строка — часть названия.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv0.1.2
    • removedInput schema / additionalProperties
      Removed value: -false
  2. First observedv0.1.1

TDQS

A4.9/5.0
Behavior5/5

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

Annotations already mark it readOnly, openWorld, idempotent and non-destructive, while the description adds substantial context: baseline creation, cursor/ack semantics, persisted:false behavior, 200-event truncation with omitted, source failure isolation, and grades expense. The local snapshot write is disclosed and framed as internal, not as a contradiction of reading external HSE systems.

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?

Purpose and alternatives are front-loaded, and every sentence carries operational detail. The dense single paragraph could be more scannable for the ack/truncation rules, so it is strong but not perfect.

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

Completeness5/5

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

There is no output schema, but the description lists the return fields (changes, scopes, sources, ackSeq, omitted, gap, persisted, warnings) and explains baseline, truncation, persistence failure and source-failure cases. An agent has enough information to call it correctly.

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

Parameters5/5

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

Although schema coverage is already 100%, the description adds cross-parameter meaning: ack must be ackSeq from the last response, an event seq is not an ack, since does not move the cursor by itself, default scopes exclude grades, and omitted>0 means the response is truncated and must be continued with ack. This goes beyond the schema field descriptions.

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?

Opens with a specific verb and resource: it snapshots deadlines, schedule, inbox, claims and optionally grades, then returns only changes since the previous snapshot. It explicitly distinguishes itself from my_today/my_week/my_deadlines for current-state queries, so sibling selection is clear.

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

Usage Guidelines5/5

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

States when to use it (changes since last snapshot) and when not to use it (use my_today/my_week/my_deadlines for current state). It also explains the first-call baseline behavior and the ack workflow, giving clear operational conditions.

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