MCP ServerPrompt Reference
Onboard a new-hire cohort
Create accounts for a cohort of new hires, put them in one group, and enroll each of them in an onboarding learning path.
Onboard a new-hire cohort
Create accounts for a cohort of new hires, put them in one group, and enroll each of them in an onboarding learning path.
The prompt onboard_new_hire_cohort appears in prompts/list only when the token can see every tool listed below.
Arguments
| Argument | Required | Description |
|---|---|---|
cohort_name | yes | Name for the new group, for example "March 2027 hires". |
learning_path_id | yes | UUID of the onboarding learning path. |
role_id | yes | Numeric role id for the new accounts. |
hires | yes | The hires to onboard, one per line as email, first name, last name. |
Steps
save_user: Create one user per hire with the given role_id and no id. Use a distinct idempotency_key per hire.save_group: Create the cohort group named cohort_name, with no id.set_group_members: Set op to "add" and add the created user ids to the group, at most 100 per call.get_group: Read the group back and confirm every created user is a member.save_path_enrollment: The API has no group-level enrollment. Call this once for each group member with learning_path_id and no id.
Tools Needed
| Tool | Scopes |
|---|---|
save_user | people:write |
save_group | people:write |
set_group_members | people:write |
get_group | people:read |
save_path_enrollment | enrollments:write |