Для тех, кто пишет клиент

Всё, что описано выше, ассистент делает через инструменты MCP. Если вы пишете собственный клиент или интеграцию, вот из чего он выбирает.

Инструменты MCP

инструмент	что делает
mnemos_observe	записать событие
mnemos_fact_add	записать факты пачкой
mnemos_recall	поиск по смыслу: факты, события, инструкции, заметки
mnemos_facts	всё об одной сущности, история, обходы для аудита
mnemos_episodes	поиск и просмотр событий, тело по идентификатору
mnemos_routes	связи между сущностями в обе стороны
mnemos_entity_search	поиск и обход сущностей
mnemos_entity_save	завести сущности
mnemos_entity_edit	правка, слияние, удаление, центр графа, недостижимость
mnemos_fact_edit	закрыть, переписать, передатировать, перецелить, слить, отметить полезным
mnemos_episode_edit	перенести, объявить без фактов, приложить файлы, удалить
mnemos_skill, mnemos_skill_save, mnemos_skill_edit	инструкции
mnemos_todo_list, mnemos_todo_edit	задачи
mnemos_pin_list, mnemos_pin_edit	заметки на виду
mnemos_context, mnemos_context_save, mnemos_context_edit	передача разговора
mnemos_state_get, mnemos_state_set	закладки регулярных задач
mnemos_scopes, mnemos_scope_describe, mnemos_scope_share	разделы и доступ

Схема каждого приходит по tools/list вместе с описанием: там же список предикатов, форматы дат и то, какие поля обязательны.

Схема — это и есть контракт: сервер проверяет аргументы по ней, а незнакомый параметр отклоняет по имени и перечисляет, что принимает.

HTTP/JSON

Тот же набор операций доступен по HTTP под тем же токеном:

curl -H "Authorization: Bearer $TOKEN" \
     https://mnemos.example.com/api/scopes

Документ OpenAPI лежит на /openapi.yaml — по нему генерируется типизированный клиент. Полный перечень операций с телами запросов — в справочнике.

Ответ 401 означает, что маршрут на месте и токен не подошёл, 402 — что у аккаунта нет прав на mnemos, 404 — что запрос не дошёл до сервера.

Что стоит знать заранее

Запись — два вызова. Сначала mnemos_observe, он возвращает идентификатор события; затем mnemos_fact_add со ссылкой на него. Все факты одним вызовом: общая работа выполняется на пачку один раз.

Концы факта задаются идентификаторами, а не именами. Идентификатор — восемь шестнадцатеричных знаков, a1b2c3d4; берут его у mnemos_entity_search, а если сущности нет — заводят mnemos_entity_save.

Запрос к поиску — массив понятий, а не вопрос предложением. По каждому идёт свой поиск, результаты сливаются по кругу.

Даты читаются одним разбором: 2026-08-20, 2026-08-20 14:30, форма с T и RFC3339. Без указания зоны — UTC. Фраза вроде «вчера» будет отклонена.