onboarding_next

When to use

• The agent is ready to teach the next lesson.
• An employee wants to reopen a specific lesson (pass lesson_id).
• A lesson was flagged as updated and should be reviewed again.

Parameters

Name	Type	Default	Description
team_idrequired	string	—	(pattern ^[a-zA-Z0-9_-]{1,64}$)
lesson_id	string	—	Optional: reopen this lesson instead of the next unfinished one. (pattern ^[a-zA-Z0-9_-]{1,64}$)

Example

Arguments

{
  "team_id": "eng"
}

Result shape

{
  "lesson": {
    "lesson_id": "les_pipeline",
    "title": "Pipeline",
    "body": "How a change reaches production.",
    "version": 1,
    "module_id": "mod_deploy",
    "module_title": "Deploy",
    "module_summary": "Shipping changes safely.",
    "position": 1,
    "total_lessons": 4,
    "records": [
      {
        "id": 42,
        "requested_id": 42,
        "type": "convention",
        "content": "Production deploys run on Tuesdays and Thursdays after 14:00."
      }
    ],
    "missing_record_ids": []
  },
  "progress": {
    "lesson_id": "les_pipeline",
    "title": "Pipeline",
    "status": "opened"
  },
  "instructions": "Teach this lesson from the text and records, answer questions with memory_recall in this team scope, then call onboarding_complete with lesson_id."
}

When nothing is left to study, lesson is null and next says what to do instead (quiz, wait for review, done).

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:

Open your next unfinished lesson (or a given lesson_id) with its source memory records inline. Teach it, answer questions, then call onboarding_complete.

Related tools

• onboarding_complete
• onboarding_start
• memory_recall