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

22 инструментов сервера `https://aos.edgelab.space/mcp`. Каждый требует свой scope у API-ключа или OAuth-доступа; инструменты менторинга – ещё и тариф «С куратором / Лично с Даши». Аргументы и ответы совпадают с соответствующими REST-методами.

| Инструмент | Scope | Тариф | Действие | Назначение |
| --- | --- | --- | --- | --- |
| [`aos_whoami`](/docs/mcp/tools#aos_whoami) | `course:read` | Группа, С куратором / Лично с Даши | чтение | Имя студента, тариф, с кем сопровождение (куратор или Даши), купленное предложение, статус анкеты и плана, а также права этого ключа и до какого числа он действует. |
| [`aos_list_lessons`](/docs/mcp/tools#aos_list_lessons) | `course:read` | Группа, С куратором / Лично с Даши | чтение | Уроки и эфиры курса с разделами, длительностью и отметкой, открыт ли урок. |
| [`aos_get_lesson`](/docs/mcp/tools#aos_get_lesson) | `course:read` | Группа, С куратором / Лично с Даши | чтение | Урок или эфир по коду (например «1.1»): видео, конспект, таймкоды, промпты, ссылки и домашнее задание. |
| [`aos_get_transcript`](/docs/mcp/tools#aos_get_transcript) | `course:read` | Группа, С куратором / Лично с Даши | чтение | Полный текст урока или эфира по коду, по фрагментам с началом в секундах от старта видео. |
| [`aos_search`](/docs/mcp/tools#aos_search) | `course:read` | Группа, С куратором / Лично с Даши | чтение | Ищет по транскриптам и таймкодам уроков/эфиров (без конспектов); каждый ответ указывает, где это было сказано, например «Урок 1.1 · 05:10». |
| [`aos_next`](/docs/mcp/tools#aos_next) | `course:read` | Группа, С куратором / Лично с Даши | чтение | Какой урок студенту смотреть следующим и почему: продолжить начатый, взять следующий, сначала заполнить анкету или курс уже пройден. |
| [`aos_list_efirs`](/docs/mcp/tools#aos_list_efirs) | `course:read` | Группа, С куратором / Лично с Даши | чтение | Расписание живых эфиров курса: дата и время начала (startsAt, UTC; эфиры идут в 19:00 по Москве), длительность, прошёл ли эфир и код записи, когда она появилась. |
| [`aos_get_live_session`](/docs/mcp/tools#aos_get_live_session) | `course:read` | Группа, С куратором / Лично с Даши | чтение | Текущий эфир (за сутки до начала, во время и три часа после) или ближайший следующий: фаза (upcoming, soon, live, ended), время начала, полный урок эфира с планом, теорией, ссылками и презентацией, а… |
| [`aos_mark_lesson`](/docs/mcp/tools#aos_mark_lesson) | `progress:write` | Группа, С куратором / Лично с Даши | запись | Отметить урок/эфир просмотренным. |
| [`aos_update_plan_milestone`](/docs/mcp/tools#aos_update_plan_milestone) | `progress:write` | Группа, С куратором / Лично с Даши | запись | Установить статус одного шага опубликованного персонального плана. |
| [`aos_get_tutor_history`](/docs/mcp/tools#aos_get_tutor_history) | `tutor:read` | Группа, С куратором / Лично с Даши | чтение | Только собственный единый диалог с тьютором. |
| [`aos_get_progress`](/docs/mcp/tools#aos_get_progress) | `course:read` | Группа, С куратором / Лично с Даши | чтение | Пройденные уроки, где студент остановился в каждом видео, домашние задания и отмеченные шаги плана. |
| [`aos_get_my_plan`](/docs/mcp/tools#aos_get_my_plan) | `profile:read` | Группа, С куратором / Лично с Даши | чтение | Персональный план студента: письмо, стек, репозитории, скиллы, проект и шаги, когда план готов. |
| [`aos_get_onboarding`](/docs/mcp/tools#aos_get_onboarding) | `profile:read` | Группа, С куратором / Лично с Даши | чтение | Ответы студента в анкете курса, выбранный сетап и статус анкеты. |
| [`aos_get_personal_track`](/docs/mcp/tools#aos_get_personal_track) | `mentoring:read` | С куратором / Лично с Даши | чтение | Опубликованный личный трек: разделы, этапы, метрики и изменения. |
| [`aos_list_personal_track_versions`](/docs/mcp/tools#aos_list_personal_track_versions) | `mentoring:read` | С куратором / Лично с Даши | чтение | История опубликованных версий трека. |
| [`aos_list_mentoring_sessions`](/docs/mcp/tools#aos_list_mentoring_sessions) | `mentoring:read` | С куратором / Лично с Даши | чтение | Встречи, их краткое содержание, доступность транскрипта, а также title, brief, hostName и recordingUrl, если есть. |
| [`aos_get_session`](/docs/mcp/tools#aos_get_session) | `mentoring:read` | С куратором / Лично с Даши | чтение | Краткое содержание или очищенный транскрипт встречи с title, brief, hostName и recordingUrl, если есть. |
| [`aos_get_decisions`](/docs/mcp/tools#aos_get_decisions) | `mentoring:read` | С куратором / Лично с Даши | чтение | Решения, их подтверждение, сроки и связь со встречами. |
| [`aos_get_mentoring_chat_digest`](/docs/mcp/tools#aos_get_mentoring_chat_digest) | `mentoring:read` | С куратором / Лично с Даши | чтение | Ежедневные сводки чата с ментором и пропуски в покрытии. |
| [`aos_list_mentoring_messages`](/docs/mcp/tools#aos_list_mentoring_messages) | `mentoring:read` | С куратором / Лично с Даши | чтение | Очищенные разрешённые сообщения – после чтения сводок. |
| [`aos_get_homework`](/docs/mcp/tools#aos_get_homework) | `mentoring:read` | С куратором / Лично с Даши | чтение | Задания менторинга, критерии выполнения, зависимости и сроки. |

Входные схемы ниже – JSON Schema из зарегистрированных capabilities. `required` задаёт обязательные поля; `additionalProperties: false` запрещает неизвестные. Полные схемы выходов: [schemas.md](/docs/schemas). Инструменты чтения помечены `readOnlyHint=true`, `destructiveHint=false`; `aos_mark_lesson` и `aos_update_plan_milestone` – `readOnlyHint=false`, `destructiveHint=true` (изменяют прогресс). Все инструменты имеют `idempotentHint=true`, `openWorldHint=false`. Отдельных MCP resources и prompts в этой реализации нет.

## Курс и прогресс

### aos_whoami

Имя студента, тариф, с кем сопровождение (куратор или Даши), купленное предложение, статус анкеты и плана, а также права этого ключа и до какого числа он действует.

**Auth:** API-ключ / OAuth token. **Scope:** `course:read`.

**Параметры · JSON Schema**

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

**Выход:** `result.structuredContent` – [AgentWhoami](/docs/schemas), тот же JSON в текстовом `content`; `mentoring` и `offer` – только если HTTP-запрос MCP несёт `X-Aos-Accept: enrollment-labels`. Краткая форма: `{ name: string, flow: "agentos3", tier: "group" | "personal", mentoring?: "curator" | "dashi" | null, offer?: "tutoring" | null, onboarding: { status: "draft" | "in_review" | "plan_ready", done: boolean }, planReady: boolean, authKind: "agentKey", keyScopes: ("course:read" | "profile:read" | "progress:write")[], keyExpiresAt: string }`.

Не возвращает идентификаторы студента или Telegram; OAuth тоже представлен как `authKind: agentKey`.

**Ошибки:** общие auth/entitlement/лимиты выше, внутри tool – `INSUFFICIENT_SCOPE`, `VALIDATION_FAILED`, `INTERNAL`.

**Лимиты:** общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.

**Пример:** `{}`. После initialize:

```bash
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:read`.

**Параметры · JSON Schema**

```json
{
  "type": "object",
  "properties": {
    "sectionId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "kind": {
      "type": "string",
      "enum": ["lesson", "tech", "stream"]
    }
  },
  "additionalProperties": false
}
```

**Выход:** `result.structuredContent` – [LessonList](/docs/schemas#lessonlist), тот же JSON в текстовом `content`. Краткая форма: `{ lessons: (LessonCard)[] }`.

**Ошибки:** общие auth/entitlement/лимиты выше, внутри tool – `INSUFFICIENT_SCOPE`, `VALIDATION_FAILED`, `INTERNAL`.

**Лимиты:** общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.

**Пример:** `{"kind":"lesson"}`. После initialize:

```bash
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:read`.

**Параметры · JSON Schema**

```json
{
  "type": "object",
  "properties": {
    "code": {
      "type": "string"
    }
  },
  "required": ["code"],
  "additionalProperties": false
}
```

**Выход:** `result.structuredContent` – [LessonDetail](/docs/schemas#lessondetail), тот же JSON в текстовом `content`. Краткая форма: `{ id: LessonCode, week: integer, title: string, minutes: integer, tools: (string)[], summary: string, task: string, kind: LessonKind, sectionId: string, gated: boolean, locked: boolean, video: LessonVideo, konspekt: string, timecodes: (Timecode)[], prompts: (LessonPrompt)[], links: (LessonLink)[], plan: (LessonPlanStep)[], theory: (string)[], deck: LessonDeck | null }`. У эфира (`kind=stream`) те же поля урока плюс `plan`, `theory`, `deck`; у урока без них – пустые списки и `null`.

`code` принимает строку; неверный/неизвестный код → `NOT_FOUND`, закрытый gated-урок → `ONBOARDING_REQUIRED`.

**Ошибки:** общие auth/entitlement/лимиты выше, внутри tool – `INSUFFICIENT_SCOPE`, `VALIDATION_FAILED`, `INTERNAL`, `NOT_FOUND`, `ONBOARDING_REQUIRED`.

**Лимиты:** общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.

**Пример:** `{"code":"1.1"}`. После initialize:

```bash
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:read`.

**Параметры · JSON Schema**

```json
{
  "type": "object",
  "properties": {
    "code": {
      "type": "string"
    }
  },
  "required": ["code"],
  "additionalProperties": false
}
```

**Выход:** `result.structuredContent` – [Transcript](/docs/schemas#transcript), тот же JSON в текстовом `content`. Краткая форма: `{ lessonId: LessonCode, segments: (object)[] }`.

`code` принимает строку; неверный/неизвестный код → `NOT_FOUND`, закрытый gated-урок → `ONBOARDING_REQUIRED`.

**Ошибки:** общие auth/entitlement/лимиты выше, внутри tool – `INSUFFICIENT_SCOPE`, `VALIDATION_FAILED`, `INTERNAL`, `NOT_FOUND`, `ONBOARDING_REQUIRED`.

**Лимиты:** общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student; дополнительно 20/min/key.

**Пример:** `{"code":"1.1"}`. После initialize:

```bash
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:read`.

**Параметры · JSON Schema**

```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": ["query"],
  "additionalProperties": false
}
```

**Выход:** `result.structuredContent` – [SearchResults](/docs/schemas#searchresults), тот же JSON в текстовом `content`. Краткая форма: `{ query: string, results: (object)[] }`.

`query` – MCP-поле; адаптер преобразует его в REST `q`. `limit` default 10, 1–20.

**Ошибки:** общие auth/entitlement/лимиты выше, внутри tool – `INSUFFICIENT_SCOPE`, `VALIDATION_FAILED`, `INTERNAL`.

**Лимиты:** общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student; дополнительно 20/min/key.

**Пример:** `{"query":"MCP","limit":5}`. После initialize:

```bash
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:read`.

**Параметры · JSON Schema**

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

**Выход:** `result.structuredContent` – [NextLesson](/docs/schemas#nextlesson), тот же JSON в текстовом `content`. Краткая форма: `{ lesson: LessonCard | null, reason: "continue" | "next" | "onboarding" | "done" }`.

**Ошибки:** общие auth/entitlement/лимиты выше, внутри tool – `INSUFFICIENT_SCOPE`, `VALIDATION_FAILED`, `INTERNAL`.

**Лимиты:** общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.

**Пример:** `{}`. После initialize:

```bash
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:read`.

**Параметры · JSON Schema**

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

**Выход:** `result.structuredContent` – [EfirList](/docs/schemas#efirlist), тот же JSON в текстовом `content`. Краткая форма: `{ efirs: (Efir)[] }`. `startsAt` в UTC: `2026-11-04T16:00:00Z` = 4 ноября, 19:00 МСК. `upcoming=false` и `lessonId` – эфир прошёл, запись открывается как урок с этим кодом. Файлы календаря: `https://aos.edgelab.space/calendar/agentos3-efirs.ics` (всё расписание) и `https://aos.edgelab.space/calendar/agentos3-<код>.ics` (один эфир), без авторизации.

**Ошибки:** общие auth/entitlement/лимиты выше, внутри tool – `INSUFFICIENT_SCOPE`, `VALIDATION_FAILED`, `INTERNAL`.

**Лимиты:** общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.

**Пример:** `{}`. После initialize:

```bash
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:read`.

**Параметры · JSON Schema**

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

**Выход:** `result.structuredContent` – [LiveSession](/docs/schemas), тот же JSON в текстовом `content`. Краткая форма: `{ session: { phase, efir: Efir, lesson: LessonDetail, pageUrl, deckUrl } | null }`. Окно «Эфир сейчас»: `soon` – за 24 часа до `startsAt`, `live` – от начала до планового конца (`minutes`), `ended` – три часа после конца (запись ещё готовится); вне окна – ближайший следующий эфир с `phase=upcoming`, иначе `session: null`. `lesson` – эфир в форме урока, как у [`aos_get_lesson`](/docs/mcp/tools#aos_get_lesson): `plan` (шаги), `theory`, `links`, `deck`; запись (`video.url`) и транскрипт появляются после эфира. `pageUrl` и `deckUrl` – абсолютные адреса, например `https://aos.edgelab.space/#/lesson/stream.1` и `https://aos.edgelab.space/decks/agentos-demo-day-20261102.html`.

**Ошибки:** общие auth/entitlement/лимиты выше, внутри tool – `INSUFFICIENT_SCOPE`, `VALIDATION_FAILED`, `INTERNAL`.

**Лимиты:** общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.

**Пример:** `{}`. После initialize:

```bash
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:write`.

**Вход:** `{"code":"1.1","completed":true}`; оба поля обязательны, лишние запрещены. `code` – [LessonCode](/docs/schemas#lessoncode), `completed` – только literal `true`; `false` отклоняется. Позиция видео и домашнее задание сохраняются. Повтор не меняет отметку или дату завершения.

**Выход:** [Progress](/docs/schemas#progress), общий с `PUT /api/v1/progress`. REST принимает `completed: false` как сохранение существующей отметки; отсутствие поля также сохраняет её. Завершение монотонно.

**Ошибки:** `INSUFFICIENT_SCOPE` с именем `progress:write`, `VALIDATION_FAILED`, `NOT_FOUND`, `ONBOARDING_REQUIRED`, общие auth/entitlement ошибки и `INTERNAL`.

**Лимиты и аудит:** общие с REST: 60/min/key, 2000/UTC day/key, 3000/UTC day/student. В аудите есть код урока, но нет аргументов.

### aos_update_plan_milestone

Установить статус одного шага опубликованного персонального плана. **Scope:** `progress:write`.

**Вход:** `{"milestone":0,"completed":true,"expectedVersion":1}`; все три поля обязательны, лишние запрещены. `milestone` – целое 0–11, индекс шага от нуля; он должен существовать в текущем плане. `completed` – boolean: true отмечает, false снимает отметку. Остальные шаги сохраняются. `expectedVersion` – положительная версия из `aos_get_my_plan`. Проверяется под lock публикации до записи: новая версия между чтением и повтором → `VERSION_CONFLICT`, новый план и его отметки не меняются. Повтор идемпотентен; параллельные отметки не теряются.

**Выход:** [Progress](/docs/schemas#progress). Общий обработчик с `PUT /api/v1/plan/milestones`, который принимает `{milestonesDone, expectedVersion}` и заменяет весь набор отметок. Отметки принадлежат версии опубликованного плана; новая версия начинает с пустого набора.

**Ошибки:** `INSUFFICIENT_SCOPE` с именем `progress:write`, `VALIDATION_FAILED` для отсутствующего индекса, `NOT_FOUND` без опубликованного плана, `VERSION_CONFLICT` при смене версии, общие auth/entitlement ошибки и `INTERNAL`.

### aos_get_tutor_history

Только собственный единый диалог с тьютором. **Scope:** `tutor:read`, отдельное opt-in разрешение на историю чата. Не входит в default scopes; существующие `profile:read` ключи/grants не открывают историю, refresh не повышает права. OAuth consent и кабинет показывают отдельное разрешение; `scopes_supported` и DCR принимают `tutor:read`. Отправка сообщений, факты тьютора и скачивание файлов остаются доступны только кабинету/TMA.

**Вход:** `{"limit":20,"cursor":"<UUID>"}`; оба поля необязательны, лишние запрещены. `limit` – целое 1–50, default 20. `cursor` – `nextCursor` предыдущего ответа; выбирает более старые сообщения. Неизвестный или чужой cursor возвращает пустую страницу без раскрытия владельца.

**Выход:** `{messages: [...], nextCursor: UUID | null}`. Сообщения отсортированы по `(created_at, id)` по убыванию. Каждое содержит `id`, `role` (user/assistant), `text`, `created_at` (ISO-8601), `sources`, `citations`, `error`, `feedback`, `attachments`. Источники и цитаты используют [TutorMessage](/docs/schemas#tutormessage); старые ответы без цитат возвращают пустой список. Вложения – только `{id,name,mime,size}`, без URL, байтов и извлечённого текста. История доступна и при выключенной генерации тьютора, без вызова модели.

**Ошибки:** `INSUFFICIENT_SCOPE` с именем `tutor:read`, `VALIDATION_FAILED`, общие 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:read`.

**Параметры · JSON Schema**

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

**Выход:** `result.structuredContent` – [Progress](/docs/schemas#progress), тот же JSON в текстовом `content`. Краткая форма: `{ completed: (LessonCode)[], positions: Record<string, number>, homework: Record<string, object>, milestonesDone: (integer)[] }`.

**Ошибки:** общие auth/entitlement/лимиты выше, внутри tool – `INSUFFICIENT_SCOPE`, `VALIDATION_FAILED`, `INTERNAL`.

**Лимиты:** общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.

**Пример:** `{}`. После initialize:

```bash
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:read`.

**Параметры · JSON Schema**

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

**Выход:** `result.structuredContent` – [PlanResponse](/docs/schemas#planresponse), тот же JSON в текстовом `content`. Краткая форма: `{ status: OnboardingStatus, plan: PlanContent | null, version: integer | null, publishedAt: string | null }`.

**Ошибки:** общие auth/entitlement/лимиты выше, внутри tool – `INSUFFICIENT_SCOPE`, `VALIDATION_FAILED`, `INTERNAL`.

**Лимиты:** общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.

**Пример:** `{}`. После initialize:

```bash
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:read`.

**Параметры · JSON Schema**

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

**Выход:** `result.structuredContent` – [Onboarding](/docs/schemas#onboarding), тот же JSON в текстовом `content`. Краткая форма: `{ schemaVersion: 2, status: OnboardingStatus, step: integer, answers: OnboardingDraft, completedAt: string | null }`.

**Ошибки:** общие auth/entitlement/лимиты выше, внутри tool – `INSUFFICIENT_SCOPE`, `VALIDATION_FAILED`, `INTERNAL`.

**Лимиты:** общие 60/min/key, 2000/UTC day/key, 3000/UTC day/student.

**Пример:** `{}`. После initialize:

```bash
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 /api/v1/mentoring/track`.

**Scope:** `mentoring:read`.

### aos_list_personal_track_versions

История опубликованных версий трека. Аргументы `limit?`, `cursor?`; ответ как у `/track/versions`.

**Scope:** `mentoring:read`.

### aos_list_mentoring_sessions

Встречи, их краткое содержание, доступность транскрипта, а также `title`, `brief`, `hostName` и `recordingUrl`, если есть. Аргументы `limit?`, `cursor?`; ответ как у `/sessions`.

**Scope:** `mentoring:read`.

### aos_get_session

Краткое содержание или очищенный транскрипт встречи с `title`, `brief`, `hostName` и `recordingUrl`, если есть. Обязательный `sessionId`, необязательные `view`, `limit`, `cursor`; ответ как у `/sessions/{sessionId}`. По умолчанию – краткое содержание; страницы транскрипта содержат секунды и явные состояния доступности.

**Scope:** `mentoring:read`.

### aos_get_decisions

Решения, их подтверждение, сроки и связь со встречами. Аргументы `limit?`, `cursor?`, `sessionId?`, `status?`; ответ как у `/decisions`.

**Scope:** `mentoring:read`.

### aos_get_mentoring_chat_digest

Ежедневные сводки чата с ментором и пропуски в покрытии. Аргументы `limit?`, `cursor?`, `from?`, `to?`; ответ как у `/chat/digests`.

**Scope:** `mentoring:read`.

### aos_list_mentoring_messages

Очищенные разрешённые сообщения – после чтения сводок. Аргументы `limit?`, `cursor?`, `from?`, `to?`; ответ как у `/chat/messages`.

**Scope:** `mentoring:read`.

### aos_get_homework

Задания менторинга, критерии выполнения, зависимости и сроки. Аргументы `limit?`, `cursor?`, `sessionId?`, `status?`; ответ как у `/homework`.

**Scope:** `mentoring:read`.
