MCP
Инструменты MCP
22 инструментов сервера https:. Каждый требует свой scope у API-ключа или OAuth-доступа; инструменты менторинга – ещё и тариф «С куратором / Лично с Даши». Аргументы и ответы совпадают с соответствующими REST-методами.
| Инструмент | Scope | Тариф | Действие | Назначение |
|---|---|---|---|---|
aos_ | course: | Группа, С куратором / Лично с Даши | чтение | Имя студента, тариф, с кем сопровождение (куратор или Даши), купленное предложение, статус анкеты и плана, а также права этого ключа и до какого числа он действует. |
aos_ | course: | Группа, С куратором / Лично с Даши | чтение | Уроки и эфиры курса с разделами, длительностью и отметкой, открыт ли урок. |
aos_ | course: | Группа, С куратором / Лично с Даши | чтение | Урок или эфир по коду (например «1.1»): видео, конспект, таймкоды, промпты, ссылки и домашнее задание. |
aos_ | course: | Группа, С куратором / Лично с Даши | чтение | Полный текст урока или эфира по коду, по фрагментам с началом в секундах от старта видео. |
aos_ | course: | Группа, С куратором / Лично с Даши | чтение | Ищет по транскриптам и таймкодам уроков/эфиров (без конспектов); каждый ответ указывает, где это было сказано, например «Урок 1.1 · 05:10». |
aos_ | course: | Группа, С куратором / Лично с Даши | чтение | Какой урок студенту смотреть следующим и почему: продолжить начатый, взять следующий, сначала заполнить анкету или курс уже пройден. |
aos_ | course: | Группа, С куратором / Лично с Даши | чтение | Расписание живых эфиров курса: дата и время начала (startsAt, UTC; эфиры идут в 19:00 по Москве), длительность, прошёл ли эфир и код записи, когда она появилась. |
aos_ | course: | Группа, С куратором / Лично с Даши | чтение | Текущий эфир (за сутки до начала, во время и три часа после) или ближайший следующий: фаза (upcoming, soon, live, ended), время начала, полный урок эфира с планом, теорией, ссылками и презентацией, а… |
aos_ | progress: | Группа, С куратором / Лично с Даши | запись | Отметить урок/эфир просмотренным. |
aos_ | progress: | Группа, С куратором / Лично с Даши | запись | Установить статус одного шага опубликованного персонального плана. |
aos_ | tutor: | Группа, С куратором / Лично с Даши | чтение | Только собственный единый диалог с тьютором. |
aos_ | course: | Группа, С куратором / Лично с Даши | чтение | Пройденные уроки, где студент остановился в каждом видео, домашние задания и отмеченные шаги плана. |
aos_ | profile: | Группа, С куратором / Лично с Даши | чтение | Персональный план студента: письмо, стек, репозитории, скиллы, проект и шаги, когда план готов. |
aos_ | profile: | Группа, С куратором / Лично с Даши | чтение | Ответы студента в анкете курса, выбранный сетап и статус анкеты. |
aos_ | mentoring: | С куратором / Лично с Даши | чтение | Опубликованный личный трек: разделы, этапы, метрики и изменения. |
aos_ | mentoring: | С куратором / Лично с Даши | чтение | История опубликованных версий трека. |
aos_ | mentoring: | С куратором / Лично с Даши | чтение | Встречи, их краткое содержание, доступность транскрипта, а также title, brief, hostName и recordingUrl, если есть. |
aos_ | mentoring: | С куратором / Лично с Даши | чтение | Краткое содержание или очищенный транскрипт встречи с title, brief, hostName и recordingUrl, если есть. |
aos_ | mentoring: | С куратором / Лично с Даши | чтение | Решения, их подтверждение, сроки и связь со встречами. |
aos_ | mentoring: | С куратором / Лично с Даши | чтение | Ежедневные сводки чата с ментором и пропуски в покрытии. |
aos_ | mentoring: | С куратором / Лично с Даши | чтение | Очищенные разрешённые сообщения – после чтения сводок. |
aos_ | mentoring: | С куратором / Лично с Даши | чтение | Задания менторинга, критерии выполнения, зависимости и сроки. |
Входные схемы ниже – JSON Schema из зарегистрированных capabilities. required задаёт обязательные поля; additionalProperties: запрещает неизвестные. Полные схемы выходов: schemas.md. Инструменты чтения помечены readOnlyHint=, destructiveHint=; aos_ и aos_ – readOnlyHint=, destructiveHint= (изменяют прогресс). Все инструменты имеют idempotentHint=, openWorldHint=. Отдельных MCP resources и prompts в этой реализации нет.
Курс и прогресс#
aos_whoami#
Имя студента, тариф, с кем сопровождение (куратор или Даши), купленное предложение, статус анкеты и плана, а также права этого ключа и до какого числа он действует.
Auth: API-ключ / OAuth token. Scope: course:.
Параметры · JSON Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Выход: result. – AgentWhoami, тот же JSON в текстовом content; mentoring и offer – только если HTTP-запрос MCP несёт X-. Краткая форма: {.
Не возвращает идентификаторы студента или Telegram; OAuth тоже представлен как authKind:.
Ошибки: общие auth/entitlement/лимиты выше, внутри tool – INSUFFICIENT_, VALIDATION_, INTERNAL.
Лимиты: общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
Пример: {. После initialize:
curl -sS https://aos.edgelab.space/mcp \
-H 'Authorization: Bearer aos_live_...' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-03-26' \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"aos_whoami","arguments":{}}}'aos_list_lessons#
Уроки и эфиры курса с разделами, длительностью и отметкой, открыт ли урок. Можно сузить по разделу (sectionId) или типу (kind).
Auth: API-ключ / OAuth token. Scope: course:.
Параметры · JSON Schema
{
"type": "object",
"properties": {
"sectionId": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"kind": {
"type": "string",
"enum": ["lesson", "tech", "stream"]
}
},
"additionalProperties": false
}Выход: result. – LessonList, тот же JSON в текстовом content. Краткая форма: {.
Ошибки: общие auth/entitlement/лимиты выше, внутри tool – INSUFFICIENT_, VALIDATION_, INTERNAL.
Лимиты: общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
Пример: {. После initialize:
curl -sS https://aos.edgelab.space/mcp \
-H 'Authorization: Bearer aos_live_...' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-03-26' \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"aos_list_lessons","arguments":{"kind":"lesson"}}}'aos_get_lesson#
Урок или эфир по коду (например «1.1»): видео, конспект, таймкоды, промпты, ссылки и домашнее задание. Закрытый урок откроется после анкеты в кабинете.
Auth: API-ключ / OAuth token. Scope: course:.
Параметры · JSON Schema
{
"type": "object",
"properties": {
"code": {
"type": "string"
}
},
"required": ["code"],
"additionalProperties": false
}Выход: result. – LessonDetail, тот же JSON в текстовом content. Краткая форма: {. У эфира (kind=) те же поля урока плюс plan, theory, deck; у урока без них – пустые списки и null.
code принимает строку; неверный/неизвестный код → NOT_, закрытый gated-урок → ONBOARDING_.
Ошибки: общие auth/entitlement/лимиты выше, внутри tool – INSUFFICIENT_, VALIDATION_, INTERNAL, NOT_, ONBOARDING_.
Лимиты: общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
Пример: {. После initialize:
curl -sS https://aos.edgelab.space/mcp \
-H 'Authorization: Bearer aos_live_...' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-03-26' \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"aos_get_lesson","arguments":{"code":"1.1"}}}'aos_get_transcript#
Полный текст урока или эфира по коду, по фрагментам с началом в секундах от старта видео.
Auth: API-ключ / OAuth token. Scope: course:.
Параметры · JSON Schema
{
"type": "object",
"properties": {
"code": {
"type": "string"
}
},
"required": ["code"],
"additionalProperties": false
}Выход: result. – Transcript, тот же JSON в текстовом content. Краткая форма: {.
code принимает строку; неверный/неизвестный код → NOT_, закрытый gated-урок → ONBOARDING_.
Ошибки: общие auth/entitlement/лимиты выше, внутри tool – INSUFFICIENT_, VALIDATION_, INTERNAL, NOT_, ONBOARDING_.
Лимиты: общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student; дополнительно 20/min/key.
Пример: {. После initialize:
curl -sS https://aos.edgelab.space/mcp \
-H 'Authorization: Bearer aos_live_...' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-03-26' \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"aos_get_transcript","arguments":{"code":"1.1"}}}'aos_search#
Ищет по транскриптам и таймкодам уроков/эфиров (без конспектов); каждый ответ указывает, где это было сказано, например «Урок 1.1 · 05:10».
Auth: API-ключ / OAuth token. Scope: course:.
Параметры · JSON Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 200
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": ["query"],
"additionalProperties": false
}Выход: result. – SearchResults, тот же JSON в текстовом content. Краткая форма: {.
query – MCP-поле; адаптер преобразует его в REST q. limit default 10, 1–20.
Ошибки: общие auth/entitlement/лимиты выше, внутри tool – INSUFFICIENT_, VALIDATION_, INTERNAL.
Лимиты: общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student; дополнительно 20/min/key.
Пример: {. После initialize:
curl -sS https://aos.edgelab.space/mcp \
-H 'Authorization: Bearer aos_live_...' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-03-26' \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"aos_search","arguments":{"query":"MCP","limit":5}}}'aos_next#
Какой урок студенту смотреть следующим и почему: продолжить начатый, взять следующий, сначала заполнить анкету или курс уже пройден.
Auth: API-ключ / OAuth token. Scope: course:.
Параметры · JSON Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Выход: result. – NextLesson, тот же JSON в текстовом content. Краткая форма: {.
Ошибки: общие auth/entitlement/лимиты выше, внутри tool – INSUFFICIENT_, VALIDATION_, INTERNAL.
Лимиты: общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
Пример: {. После initialize:
curl -sS https://aos.edgelab.space/mcp \
-H 'Authorization: Bearer aos_live_...' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-03-26' \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"aos_next","arguments":{}}}'aos_list_efirs#
Расписание живых эфиров курса: дата и время начала (startsAt, UTC; эфиры идут в 19:00 по Москве), длительность, прошёл ли эфир и код записи, когда она появилась.
Auth: API-ключ / OAuth token. Scope: course:.
Параметры · JSON Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Выход: result. – EfirList, тот же JSON в текстовом content. Краткая форма: {. startsAt в UTC: 2026- = 4 ноября, 19:00 МСК. upcoming= и lessonId – эфир прошёл, запись открывается как урок с этим кодом. Файлы календаря: https: (всё расписание) и https: (один эфир), без авторизации.
Ошибки: общие auth/entitlement/лимиты выше, внутри tool – INSUFFICIENT_, VALIDATION_, INTERNAL.
Лимиты: общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
Пример: {. После initialize:
curl -sS https://aos.edgelab.space/mcp \
-H 'Authorization: Bearer aos_live_...' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-03-26' \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"aos_list_efirs","arguments":{}}}'aos_get_live_session#
Текущий эфир (за сутки до начала, во время и три часа после) или ближайший следующий: фаза (upcoming, soon, live, ended), время начала, полный урок эфира с планом, теорией, ссылками и презентацией, адрес страницы эфира и презентации.
Auth: API-ключ / OAuth token. Scope: course:.
Параметры · JSON Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Выход: result. – LiveSession, тот же JSON в текстовом content. Краткая форма: {. Окно «Эфир сейчас»: soon – за 24 часа до startsAt, live – от начала до планового конца (minutes), ended – три часа после конца (запись ещё готовится); вне окна – ближайший следующий эфир с phase=, иначе session:. lesson – эфир в форме урока, как у aos_: plan (шаги), theory, links, deck; запись (video.) и транскрипт появляются после эфира. pageUrl и deckUrl – абсолютные адреса, например https: и https:.
Ошибки: общие auth/entitlement/лимиты выше, внутри tool – INSUFFICIENT_, VALIDATION_, INTERNAL.
Лимиты: общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
Пример: {. После initialize:
curl -sS https://aos.edgelab.space/mcp \
-H 'Authorization: Bearer aos_live_...' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-03-26' \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"aos_get_live_session","arguments":{}}}'aos_mark_lesson#
Отметить урок/эфир просмотренным. Scope: progress:.
Вход: {; оба поля обязательны, лишние запрещены. code – LessonCode, completed – только literal true; false отклоняется. Позиция видео и домашнее задание сохраняются. Повтор не меняет отметку или дату завершения.
Выход: Progress, общий с PUT . REST принимает completed: как сохранение существующей отметки; отсутствие поля также сохраняет её. Завершение монотонно.
Ошибки: INSUFFICIENT_ с именем progress:, VALIDATION_, NOT_, ONBOARDING_, общие auth/entitlement ошибки и INTERNAL.
Лимиты и аудит: общие с REST: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. В аудите есть код урока, но нет аргументов.
aos_update_plan_milestone#
Установить статус одного шага опубликованного персонального плана. Scope: progress:.
Вход: {; все три поля обязательны, лишние запрещены. milestone – целое 0–11, индекс шага от нуля; он должен существовать в текущем плане. completed – boolean: true отмечает, false снимает отметку. Остальные шаги сохраняются. expectedVersion – положительная версия из aos_. Проверяется под lock публикации до записи: новая версия между чтением и повтором → VERSION_, новый план и его отметки не меняются. Повтор идемпотентен; параллельные отметки не теряются.
Выход: Progress. Общий обработчик с PUT , который принимает { и заменяет весь набор отметок. Отметки принадлежат версии опубликованного плана; новая версия начинает с пустого набора.
Ошибки: INSUFFICIENT_ с именем progress:, VALIDATION_ для отсутствующего индекса, NOT_ без опубликованного плана, VERSION_ при смене версии, общие auth/entitlement ошибки и INTERNAL.
aos_get_tutor_history#
Только собственный единый диалог с тьютором. Scope: tutor:, отдельное opt-in разрешение на историю чата. Не входит в default scopes; существующие profile: ключи/grants не открывают историю, refresh не повышает права. OAuth consent и кабинет показывают отдельное разрешение; scopes_ и DCR принимают tutor:. Отправка сообщений, факты тьютора и скачивание файлов остаются доступны только кабинету/TMA.
Вход: {; оба поля необязательны, лишние запрещены. limit – целое 1–50, default 20. cursor – nextCursor предыдущего ответа; выбирает более старые сообщения. Неизвестный или чужой cursor возвращает пустую страницу без раскрытия владельца.
Выход: {. Сообщения отсортированы по ( по убыванию. Каждое содержит id, role (user/assistant), text, created_ (ISO-8601), sources, citations, error, feedback, attachments. Источники и цитаты используют TutorMessage; старые ответы без цитат возвращают пустой список. Вложения – только {, без URL, байтов и извлечённого текста. История доступна и при выключенной генерации тьютора, без вызова модели.
Ошибки: INSUFFICIENT_ с именем tutor:, VALIDATION_, общие auth/entitlement ошибки, INTERNAL.
Лимиты: общие с REST: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. Аудит не содержит текста, cursor или вложений.
aos_get_progress#
Пройденные уроки, где студент остановился в каждом видео, домашние задания и отмеченные шаги плана.
Auth: API-ключ / OAuth token. Scope: course:.
Параметры · JSON Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Выход: result. – Progress, тот же JSON в текстовом content. Краткая форма: {.
Ошибки: общие auth/entitlement/лимиты выше, внутри tool – INSUFFICIENT_, VALIDATION_, INTERNAL.
Лимиты: общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
Пример: {. После initialize:
curl -sS https://aos.edgelab.space/mcp \
-H 'Authorization: Bearer aos_live_...' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-03-26' \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"aos_get_progress","arguments":{}}}'aos_get_my_plan#
Персональный план студента: письмо, стек, репозитории, скиллы, проект и шаги, когда план готов.
Auth: API-ключ / OAuth token. Scope: profile:.
Параметры · JSON Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Выход: result. – PlanResponse, тот же JSON в текстовом content. Краткая форма: {.
Ошибки: общие auth/entitlement/лимиты выше, внутри tool – INSUFFICIENT_, VALIDATION_, INTERNAL.
Лимиты: общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
Пример: {. После initialize:
curl -sS https://aos.edgelab.space/mcp \
-H 'Authorization: Bearer aos_live_...' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-03-26' \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"aos_get_my_plan","arguments":{}}}'aos_get_onboarding#
Ответы студента в анкете курса, выбранный сетап и статус анкеты.
Auth: API-ключ / OAuth token. Scope: profile:.
Параметры · JSON Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Выход: result. – Onboarding, тот же JSON в текстовом content. Краткая форма: {.
Ошибки: общие auth/entitlement/лимиты выше, внутри tool – INSUFFICIENT_, VALIDATION_, INTERNAL.
Лимиты: общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
Пример: {. После initialize:
curl -sS https://aos.edgelab.space/mcp \
-H 'Authorization: Bearer aos_live_...' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-03-26' \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"aos_get_onboarding","arguments":{}}}'Личный менторинг#
aos_get_personal_track#
Опубликованный личный трек: разделы, этапы, метрики и изменения. Необязательный versionId; ответ как у GET .
Scope: mentoring:.
aos_list_personal_track_versions#
История опубликованных версий трека. Аргументы limit?, cursor?; ответ как у /.
Scope: mentoring:.
aos_list_mentoring_sessions#
Встречи, их краткое содержание, доступность транскрипта, а также title, brief, hostName и recordingUrl, если есть. Аргументы limit?, cursor?; ответ как у /.
Scope: mentoring:.
aos_get_session#
Краткое содержание или очищенный транскрипт встречи с title, brief, hostName и recordingUrl, если есть. Обязательный sessionId, необязательные view, limit, cursor; ответ как у /. По умолчанию – краткое содержание; страницы транскрипта содержат секунды и явные состояния доступности.
Scope: mentoring:.
aos_get_decisions#
Решения, их подтверждение, сроки и связь со встречами. Аргументы limit?, cursor?, sessionId?, status?; ответ как у /.
Scope: mentoring:.
aos_get_mentoring_chat_digest#
Ежедневные сводки чата с ментором и пропуски в покрытии. Аргументы limit?, cursor?, from?, to?; ответ как у /.
Scope: mentoring:.
aos_list_mentoring_messages#
Очищенные разрешённые сообщения – после чтения сводок. Аргументы limit?, cursor?, from?, to?; ответ как у /.
Scope: mentoring:.
aos_get_homework#
Задания менторинга, критерии выполнения, зависимости и сроки. Аргументы limit?, cursor?, sessionId?, status?; ответ как у /.
Scope: mentoring:.