Справочник инструментов

Все 29 инструментов MCP по группам разрешений — что каждый делает и что ему требуется.

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

Прочитайте группы разрешений, прежде чем что-либо выдавать: уровень записи любой группы всегда включает удаление, а удаление каскадно.

Каждый инструмент, который что-то перечисляет, возвращает по одной странице за раз — по умолчанию 20 элементов, максимум 100, — поэтому обход большой notebase занимает несколько вызовов.

Данные аккаунта

Только чтение. У этой группы нет уровня записи.

Инструмент	Что делает	Требуется
`whoami`	Сообщает, для какого аккаунта Read Frog авторизовано подключение. Адрес электронной почты включается только если у подключения есть и разрешение на почту.	чтение `account`

Базы заметок и поля

Инструмент	Что делает	Требуется
`list_notebases`	Перечисляет принадлежащие вам notebase.	чтение `notebases`
`get_notebase_schema`	Читает название одной notebase и определения её полей, включая идентификаторы полей, используемые как ключи при записи заметок. Содержимого заметок не возвращает.	чтение `notebases`
`create_notebase`	Создаёт пустую notebase, при желании вместе с начальными полями. Заметки добавляются отдельно.	запись `notebases`
`rename_notebase`	Переименовывает notebase, не трогая её настройки занятий.	запись `notebases`
`delete_notebase`	Безвозвратно удаляет notebase вместе с её полями, заметками, шаблонами, карточками и записями повторений.	запись `notebases`
`create_notebase_field`	Добавляет поле в notebase и возвращает его идентификатор.	запись `notebases`
`update_notebase_field`	Переименовывает поле или меняет его настройки; тип изменить нельзя. Удаление варианта выбора очищает это значение во всех заметках.	запись `notebases`
`delete_notebase_field`	Удаляет поле и убирает его значения из каждой заметки. Основные поля и поля, на которые ссылается шаблон, удалить нельзя.	запись `notebases`

Содержимое заметок

Инструмент	Что делает	Требуется
`list_notes`	Просматривает заметки или ищет внутри одной notebase. Поиск — буквальная подстрока без учёта регистра из двух и более символов, совпадает только с текстовыми полями.	чтение `notes`
`get_note`	Читает значения полей одной заметки плюс метку времени, защищающую последующие правки.	чтение `notes`
`create_notes`	Создаёт от 1 до 50 заметок сразу в одной notebase, атомарно. Существующие шаблоны тут же превращают их в карточки.	запись `notes`
`update_note`	Сливает новые значения в заметку, сохраняя неупомянутые поля; `null` очищает поле. Падает, а не переписывает, если заметка изменилась с момента чтения.	запись `notes`
`delete_note`	Безвозвратно удаляет заметку вместе с порождёнными из неё карточками и их записями повторений.	запись `notes`

Шаблоны карточек

Инструмент	Что делает	Требуется
`list_card_templates`	Перечисляет ваши шаблоны карточек, при желании внутри одной notebase.	чтение `card_templates`
`get_card_template`	Читает полное определение одного шаблона и метку времени, защищающую последующие правки.	чтение `card_templates`
`create_card_template`	Создаёт шаблон из существующих идентификаторов полей. Это порождает карточки для каждой уже имеющейся в notebase заметки.	запись `card_templates`
`update_card_template`	Меняет название или определение шаблона. Отрисованные карточки следуют за сохранённым шаблоном.	запись `card_templates`
`delete_card_template`	Безвозвратно удаляет шаблон вместе с порождёнными им карточками и их записями повторений. Исходные заметки остаются.	запись `card_templates`

Отрисованные карточки

Карточка — это содержимое заметки вместе с состоянием расписания, поэтому обоим этим инструментам нужны два разрешения на чтение одновременно.

Инструмент	Что делает	Требуется
`list_cards`	Просматривает карточки с их отрисованными лицевыми и оборотными сторонами, идентификаторами источников и состоянием изучения. Умеет фильтровать по notebase, шаблону или состоянию расписания.	чтение `notes` + чтение `study`
`get_card`	Читает одну карточку тем же способом.	чтение `notes` + чтение `study`

Повторения и история обучения

Инструмент	Что делает	Требуется
`get_study_stats`	Читает счётчики очереди занятий по каждой notebase для заданного часового пояса. Ни содержимого заметок, ни сторон карточек не возвращает.	чтение `study`
`get_study_settings`	Читает дневной лимит новых карточек, дневной лимит повторений и желаемое удержание одной notebase. Ни её названия, ни её содержимого не возвращает.	чтение `study`
`list_review_history`	Читает ваши записи повторений, при желании с фильтром по notebase или карточке. Содержимое заметок и стороны карточек исключены.	чтение `study`
`update_study_settings`	Меняет только эти три настройки — дневной лимит новых карточек, дневной лимит повторений, желаемое удержание.	запись `study`
`record_review`	Отправляет одну оценку по карточке. FSRS считает её настоящим повторением и обновляет стабильность, сложность и срок карточки. Требует часовой пояс, поскольку он решает, какому учебному дню принадлежит повторение.	запись `study`
`undo_review`	Отменяет последнее подходящее повторение одной карточки, возвращая расписание, которое было до него. Требует идентификатор того повторения, поэтому повторная попытка не сможет отменить более раннее.	запись `study`
`set_card_suspended`	Приостанавливает карточку, убирая её из занятий до возобновления, либо возобновляет её.	запись `study`
`set_card_buried`	Откладывает карточку, скрывая её до конца учебного дня, либо возвращает её.	запись `study`

Куда двигаться дальше

Рецепты — во что эти инструменты стоит складывать.
Подключение ассистента — выдача, понижение и отзыв разрешений.