Skip to content
Docs menu

Tool reference · Team onboarding

New in 14.6.0

onboarding_complete

Marks a lesson as studied, records the time spent, and adds a short note to the employee's own personal memory.

team server /mcp
Caution. The lesson must have been opened with onboarding_next first. Agents should complete lessons only on the employee's explicit confirmation, never in bulk.

When to use

  • The employee confirms they have understood the lesson.
  • A lesson flagged as updated has been reviewed again.

Parameters

NameTypeDefaultDescription
lesson_idrequired string — (pattern ^[a-zA-Z0-9_-]{1,64}$)

Example

Arguments

{
  "lesson_id": "les_pipeline"
}

Result shape

{
  "lesson_id": "les_pipeline",
  "outcome": "completed",
  "completed_at": "2026-09-25T09:31:40.502Z",
  "time_spent_seconds": 1140,
  "summary": {
    "lessons_completed": 2,
    "lessons_total": 4,
    "modules_finished": 1,
    "modules_total": 2,
    "percent": 50,
    "updated_lessons": 0
  },
  "next": {
    "action": "quiz",
    "module_id": "mod_deploy",
    "title": "Deploy",
    "attempts_left": 3,
    "hint": "Call onboarding_quiz, then onboarding_submit."
  }
}

Calling it again returns outcome "unchanged"; completing a lesson whose sources changed returns "restudied".

Values are illustrative; the keys follow the server's handler. MCP clients receive the result as JSON text content.

Server description

The description the server sends to your agent in tools/list, captured from the v14.7.0 source:

Mark a lesson as studied after the employee went through it. Idempotent; records the time spent and a note in their personal memory.

Found a mistake? Open an issue on GitHub.

Search