list_students
Retrieve a school's student roster with names, grades, SIS IDs, and guardian info. Filter by grade or name to find specific students and obtain their IDs for further actions.
Instructions
List students on a school's admin roster (id, name, grade, SIS id, guardians).
Returns the full roster in one call. Use the id from results as student_id
in get_student, edit_student, add_parent, and link_guardian_to_student.
Args: school_id: School ID (from list_schools) grade: Optional case-insensitive filter on grade name (e.g. "2nd Grade") name_contains: Optional case-insensitive substring filter on student name
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": {
"school_id": "<school_id>"
},
"name": "list_students"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| grade | No | ||
| school_id | Yes | ||
| name_contains | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |