add_class_students
Enroll one or more students in a class by section ID, skipping those already enrolled, without affecting their other classes.
Instructions
Enroll students in a class. Requires PS_ENABLE_WRITES.
SAFETY: Never call this tool or another class-staff/student-enrollment write in parallel. The server serializes section-membership writes within this process; still use one call at a time and verify with a fresh read.
Adds everyone listed in a single call without disturbing the students already in the class or their other classes. Students already enrolled are skipped, so re-running is safe.
To assign a whole grade at the start of the year, call this once per classroom with that classroom's students — list_students(grade=...) gives the ids.
Args: section_id: Class/section ID (from list_classes) student_ids: One or more student IDs (from list_students)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"section_id": "<section_id>",
"student_ids": "<student_ids>"
},
"name": "add_class_students"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| section_id | Yes | ||
| student_ids | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |