What-if grade
what_if_gradeRecompute a class percent after hypothetical assignment scores using real PowerSchool assignment data, optional category weights, and compare the result with the portal’s reported grade.
Instructions
Recompute a class percent after hypothetical scores, using points-based math on the real assignment data (sum of score x weight over points x weight; exempt, uncounted and unscored items excluded; missing items count as 0 only if scored 0 by the teacher). Each hypothetical either adds a new assignment or, with replaces, swaps an existing one. If you know the class's category weights, pass category_weights for a weighted result. The output states its assumptions and compares against the portal's reported percent.
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": {
"course": "<course>",
"hypotheticals": "<hypotheticals>"
},
"name": "what_if_grade"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| term | No | Grade column, e.g. P1, S1. Default: current term | |
| course | Yes | Class name (fuzzy) or period number | |
| student | No | Student to use: name, or index from list_students. Defaults to PS_DEFAULT_STUDENT, else the student PowerSchool shows. | |
| hypotheticals | Yes | ||
| category_weights | No | Optional {category: weight} if the class weights categories |