add_student
Add a student to a school roster using school ID, name, and grade, then confirm the student exists after creation.
Instructions
Create a new student on a school's roster. Requires PS_ENABLE_WRITES.
Use list_grades(school_id) to find the grade_id. The new student's id is not returned by ParentSquare — call list_students afterward to retrieve it.
The roster is read back after the write, so the result says whether the student actually exists. If ParentSquare ever returns a 5xx here, do not retry on the status code alone: its error page is rendered after the record is saved, so the student may well have been created, and there is no API route to delete a duplicate.
Args: school_id: School ID first_name: Student first name last_name: Student last name grade_id: Grade ID (from list_grades) student_sis_id: Optional SIS/external student ID
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>",
"first_name": "<first_name>",
"last_name": "<last_name>",
"grade_id": "<grade_id>"
},
"name": "add_student"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| grade_id | Yes | ||
| last_name | Yes | ||
| school_id | Yes | ||
| first_name | Yes | ||
| student_sis_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |