Zovo Gradebook

Is a weighted grade calculator for teachers and tutors who compute class grades each week.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
79%
Qualität der Benennung
100%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~5,482Tokens (Tool-Definitionen)
~18.8 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (4.28% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "gradebook": {
      "url": "https://gradebook.zovo.one/mcp"
    }
  }
}

Remote-Endpunkte

https://gradebook.zovo.one/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (3)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢calculate_class_grades(roster, students, file, ignore_columns, id_column, ...)

Use this when a teacher or tutor wants a weighted grade calculator for a whole class; list ID and info columns (student number, StudentID, email, SIS, section) in ignore_columns so they stay out of the grades. Examples: final grades from a gradebook, 'calculate my students' grades with Homework 20%, Quizzes 30%, Tests 50%', a gradebook template filled in, class average, or who is missing work. Takes a roster of scores (pasted table, list, or a Google Classroom / Canvas CSV or XLSX export as file) plus optional category weights, points possible, drop lowest per category, blank handling, extra credit and letter scale. Returns each student's final percent and letter (fraction math, rounded only for display), category scores, weights renormalized when a category has no graded work, class mean/median/distribution, missing-work list, and Excel + CSV downloads. Does not store data, connect to a school system, or make progress report PDFs (use generate_progress_reports).

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "roster": {
      "description": "The scores, one row per student: a pasted table (CSV, tab-separated or a markdown table) with a header row of assignment names, e.g. \"Student, HW1, HW2, Quiz 1, Test 1\\nAna Diaz, 18, 20, 9, 45\\nBen Ito, 15, EX, 7, M\". Also accepts a list of rows or [{\"name\":\"Ana Diaz\",\"scores\":{\"HW1\":18,\"Quiz 1\":9}}]. Send this or file.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 300000
        },
        {
          "maxItems": 3000,
          "type": "array",
          "items": {}
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "students": {
      "description": "Same as roster (either name works), e.g. [{\"name\":\"Ana Diaz\",\"scores\":{\"HW1\":18}}].",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 300000
        },
        {
          "maxItems": 3000,
          "type": "array",
          "items": {}
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "file": {
      "type": "object",
      "properties": {
        "download_url": {
          "type": "string",
          "description": "Temporary download link for the file, supplied by ChatGPT."
        },
        "file_id": {
          "type": "string",
          "description": "ChatGPT file id, e.g. file_abc123."
        },
        "mime_type": {
          "description": "Media type if known, e.g. application/pdf.",
          "type": "string"
        },
        "file_name": {
          "description": "Original file name if known, e.g. statement.pdf.",
          "type": "string"
        }
      },
      "required": [
        "download_url",
        "file_id"
      ],
      "description": "A gradebook export as CSV or XLSX, e.g. the Google Classroom grades CSV or the Canvas gradebook export. One row per student, one column per assignment."
    },
    "ignore_columns": {
      "description": "Columns that are not scores and must not be graded or copied, by header name: student IDs, student numbers, SIS/login/email, section, notes. Example: [\"Student Number\", \"Email\"] or \"StudentID, Nr albumu\". Always name ID and info columns here.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2000
        },
        {
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 120
          }
        }
      ]
    },
    "id_column": {
      "description": "The header of the student ID / student number column, if any, e.g. \"StudentID\". It is ignored (same as ignore_columns).",
      "type": "string",
      "maxLength": 120
    },
    "categories": {
      "description": "Category weights, e.g. \"Homework 20%, Quizzes 30%, Tests 50%\" or [{\"name\":\"Quizzes\",\"weight\":30,\"drop_lowest\":1}]. Assignments are matched to categories by name (HW 3 -> Homework, Quiz 2 -> Quizzes, Unit Test -> Tests). Leave out for a total-points grade.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 300000
        },
        {
          "maxItems": 3000,
          "type": "array",
          "items": {}
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "assignments": {
      "description": "Optional details per assignment when names do not show the category or the points: [{\"name\":\"Unit 1\",\"category\":\"Tests\",\"points_possible\":50}], or lines like \"Unit 1, Tests, 50\". Mark bonus work with \"extra_credit\": true.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 300000
        },
        {
          "maxItems": 3000,
          "type": "array",
          "items": {}
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "points_possible": {
      "description": "Points possible when the table does not say: one number for every assignment (e.g. 100), a list in column order (e.g. \"20, 20, 10, 50\"), or {\"Quiz 1\": 10}. A 'Points possible' row in the table or headers like \"Quiz 1 (10)\" also work. Default 100.",
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "string",
          "maxLength": 4000
        },
        {
          "maxItems": 300,
          "type": "array",
          "items": {}
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "drop_lowest": {
      "description": "Drop each student's lowest scores per category, e.g. {\"Quizzes\": 1} or \"Quizzes 1, Homework 2\". A plain number applies to every category.",
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "string",
          "maxLength": 400
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        {
          "maxItems": 30,
          "type": "array",
          "items": {}
        }
      ]
    },
    "blank_as": {
      "description": "How to treat empty cells: not_graded (default, left out) or zero (count as 0). EX means excused (left out); M or missing counts as 0.",
      "type": "string",
      "maxLength": 30
    },
    "letter_scale": {
      "description": "Letter cutoffs. Default A 90, B 80, C 70, D 60, F below 60. Use \"plus_minus\" for A+ 97 / A 93 / A- 90 ... D- 60, or a custom list like \"A 93, B 85, C 75, D 65\".",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 300000
        },
        {
          "maxItems": 3000,
          "type": "array",
          "items": {}
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "plus_minus": {
      "description": "true for +/- letters (A+ 97, A 93, A- 90, ...). Default false.",
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "string",
          "maxLength": 10
        }
      ]
    },
    "round_for_letter": {
      "description": "true to round the final percent to a whole number before picking the letter (89.5 -> 90 -> A). Default false: 89.5 is a B.",
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "string",
          "maxLength": 10
        }
      ]
    },
    "category_scoring": {
      "description": "How a category score is built: points (default, total points earned / possible in the category) or average (each assignment counts equally).",
      "type": "string",
      "maxLength": 20
    },
    "class_name": {
      "description": "Class name for the files, e.g. Algebra 1, Period 3.",
      "type": "string",
      "maxLength": 120
    },
    "teacher_name": {
      "description": "Teacher or tutor name for the reports, e.g. Ms. Rivera.",
      "type": "string",
      "maxLength": 80
    },
    "term": {
      "description": "Grading period, e.g. Fall 2026 Quarter 1.",
      "type": "string",
      "maxLength": 60
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string"
    },
    "class_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "grading": {
      "type": "string"
    },
    "letter_scale": {
      "type": "string"
    },
    "students_count": {
      "type": "number"
    },
    "graded_count": {
      "type": "number"
    },
    "assignments_count": {
      "type": "number"
    },
    "stats": {
      "type": "object",
      "properties": {
        "mean": {
          "type": [
            "number",
            "null"
          ]
        },
        "median": {
          "type": [
            "number",
            "null"
          ]
        },
        "min": {
          "type": [
            "number",
            "null"
          ]
        },
        "max": {
          "type": [
            "number",
            "null"
          ]
        },
        "stdev": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "mean",
        "median",
        "min",
        "max",
        "stdev"
      ],
      "additionalProperties": false
    },
    "distribution": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "letter": {
            "type": "string"
          },
          "count": {
            "type": "number"
          }
        },
        "required": [
          "letter",
          "count"
        ],
        "additionalProperties": false
      }
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "weight": {
            "type": [
              "number",
              "null"
            ]
          },
          "drop_lowest": {
            "type": "number"
          },
          "class_average": {
            "type": [
              "number",
              "null"
            ]
          },
          "assignments": {
            "type": "number"
          }
        },
        "required": [
          "name",
          "weight",
          "drop_lowest",
          "class_average",
          "assignments"
        ],
        "additionalProperties": false
      }
    },
    "students": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "final": {
            "type": [
              "number",
              "null"
            ]
          },
          "letter": {
            "type": "string"
          },
          "missing": {
            "type": "number"
          }
        },
        "required": [
          "name",
          "final",
          "letter",
          "missing"
        ],
        "additionalProperties": false
      }
    },
    "students_shown": {
      "type": "number"
    },
    "missing_work": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "student": {
            "type": "string"
          },
          "assignments": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "student",
          "assignments"
        ],
        "additionalProperties": false
      }
    },
    "missing_total": {
      "type": "number"
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "pages": {
      "type": "number"
    },
    "downloads": {
      "type": "object",
      "properties": {
        "xlsx": {
          "type": "string"
        },
        "csv": {
          "type": "string"
        },
        "pdf": {
          "type": "string"
        }
      },
      "additionalProperties": false
    },
    "privacy": {
      "type": "string"
    }
  },
  "required": [
    "kind",
    "class_name",
    "grading",
    "letter_scale",
    "students_count",
    "graded_count",
    "assignments_count",
    "stats",
    "distribution",
    "categories",
    "students",
    "students_shown",
    "missing_work",
    "missing_total",
    "notes",
    "warnings",
    "downloads",
    "privacy"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🟢generate_progress_reports(roster, students, file, ignore_columns, id_column, ...)

Use this when the user wants a progress report template filled in for students; list ID and info columns (student number, StudentID, email, SIS, section) in ignore_columns so they stay out of the grades. Examples: printable progress reports, grade reports for parents, 'make a progress report for each student'. Takes the same roster and grading settings as calculate_class_grades plus optional teacher comments per student, class name, teacher, term, report date and a subset of students. Returns one PDF with one page per student (current grade and letter, category scores, each assignment with excused/missing/dropped marks, missing work list, comment) and the Excel gradebook. Does not email or post reports, and does not store data.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "roster": {
      "description": "The scores, one row per student: a pasted table (CSV, tab-separated or a markdown table) with a header row of assignment names, e.g. \"Student, HW1, HW2, Quiz 1, Test 1\\nAna Diaz, 18, 20, 9, 45\\nBen Ito, 15, EX, 7, M\". Also accepts a list of rows or [{\"name\":\"Ana Diaz\",\"scores\":{\"HW1\":18,\"Quiz 1\":9}}]. Send this or file.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 300000
        },
        {
          "maxItems": 3000,
          "type": "array",
          "items": {}
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "students": {
      "description": "Same as roster (either name works), e.g. [{\"name\":\"Ana Diaz\",\"scores\":{\"HW1\":18}}].",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 300000
        },
        {
          "maxItems": 3000,
          "type": "array",
          "items": {}
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "file": {
      "type": "object",
      "properties": {
        "download_url": {
          "type": "string",
          "description": "Temporary download link for the file, supplied by ChatGPT."
        },
        "file_id": {
          "type": "string",
          "description": "ChatGPT file id, e.g. file_abc123."
        },
        "mime_type": {
          "description": "Media type if known, e.g. application/pdf.",
          "type": "string"
        },
        "file_name": {
          "description": "Original file name if known, e.g. statement.pdf.",
          "type": "string"
        }
      },
      "required": [
        "download_url",
        "file_id"
      ],
      "description": "A gradebook export as CSV or XLSX, e.g. the Google Classroom grades CSV or the Canvas gradebook export. One row per student, one column per assignment."
    },
    "ignore_columns": {
      "description": "Columns that are not scores and must not be graded or copied, by header name: student IDs, student numbers, SIS/login/email, section, notes. Example: [\"Student Number\", \"Email\"] or \"StudentID, Nr albumu\". Always name ID and info columns here.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2000
        },
        {
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 120
          }
        }
      ]
    },
    "id_column": {
      "description": "The header of the student ID / student number column, if any, e.g. \"StudentID\". It is ignored (same as ignore_columns).",
      "type": "string",
      "maxLength": 120
    },
    "categories": {
      "description": "Category weights, e.g. \"Homework 20%, Quizzes 30%, Tests 50%\" or [{\"name\":\"Quizzes\",\"weight\":30,\"drop_lowest\":1}]. Assignments are matched to categories by name (HW 3 -> Homework, Quiz 2 -> Quizzes, Unit Test -> Tests). Leave out for a total-points grade.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 300000
        },
        {
          "maxItems": 3000,
          "type": "array",
          "items": {}
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "assignments": {
      "description": "Optional details per assignment when names do not show the category or the points: [{\"name\":\"Unit 1\",\"category\":\"Tests\",\"points_possible\":50}], or lines like \"Unit 1, Tests, 50\". Mark bonus work with \"extra_credit\": true.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 300000
        },
        {
          "maxItems": 3000,
          "type": "array",
          "items": {}
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "points_possible": {
      "description": "Points possible when the table does not say: one number for every assignment (e.g. 100), a list in column order (e.g. \"20, 20, 10, 50\"), or {\"Quiz 1\": 10}. A 'Points possible' row in the table or headers like \"Quiz 1 (10)\" also work. Default 100.",
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "string",
          "maxLength": 4000
        },
        {
          "maxItems": 300,
          "type": "array",
          "items": {}
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "drop_lowest": {
      "description": "Drop each student's lowest scores per category, e.g. {\"Quizzes\": 1} or \"Quizzes 1, Homework 2\". A plain number applies to every category.",
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "string",
          "maxLength": 400
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        {
          "maxItems": 30,
          "type": "array",
          "items": {}
        }
      ]
    },
    "blank_as": {
      "description": "How to treat empty cells: not_graded (default, left out) or zero (count as 0). EX means excused (left out); M or missing counts as 0.",
      "type": "string",
      "maxLength": 30
    },
    "letter_scale": {
      "description": "Letter cutoffs. Default A 90, B 80, C 70, D 60, F below 60. Use \"plus_minus\" for A+ 97 / A 93 / A- 90 ... D- 60, or a custom list like \"A 93, B 85, C 75, D 65\".",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 300000
        },
        {
          "maxItems": 3000,
          "type": "array",
          "items": {}
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "plus_minus": {
      "description": "true for +/- letters (A+ 97, A 93, A- 90, ...). Default false.",
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "string",
          "maxLength": 10
        }
      ]
    },
    "round_for_letter": {
      "description": "true to round the final percent to a whole number before picking the letter (89.5 -> 90 -> A). Default false: 89.5 is a B.",
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "string",
          "maxLength": 10
        }
      ]
    },
    "category_scoring": {
      "description": "How a category score is built: points (default, total points earned / possible in the category) or average (each assignment counts equally).",
      "type": "string",
      "maxLength": 20
    },
    "class_name": {
      "description": "Class name for the files, e.g. Algebra 1, Period 3.",
      "type": "string",
      "maxLength": 120
    },
    "teacher_name": {
      "description": "Teacher or tutor name for the reports, e.g. Ms. Rivera.",
      "type": "string",
      "maxLength": 80
    },
    "term": {
      "description": "Grading period, e.g. Fall 2026 Quarter 1.",
      "type": "string",
      "maxLength": 60
    },
    "comments": {
      "description": "Optional teacher comment per student, e.g. {\"Ana Diaz\":\"Strong quiz scores; turn in HW 3.\"} or lines \"Ana Diaz: Strong quiz scores\".",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 300000
        },
        {
          "maxItems": 3000,
          "type": "array",
          "items": {}
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "only_students": {
      "description": "Optional subset of student names to print, e.g. \"Ana Diaz, Ben Ito\". Default: every student.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 300000
        },
        {
          "maxItems": 3000,
          "type": "array",
          "items": {}
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "report_date": {
      "description": "Date printed on the reports, e.g. October 26, 2026. Default: today (US Eastern).",
      "type": "string",
      "maxLength": 40
    },
    "paper": {
      "description": "letter (default) or a4.",
      "type": "string",
      "maxLength": 20
    },
    "show_class_average": {
      "description": "Print the class average on each report. Default true.",
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "string",
          "maxLength": 10
        }
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string"
    },
    "class_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "grading": {
      "type": "string"
    },
    "letter_scale": {
      "type": "string"
    },
    "students_count": {
      "type": "number"
    },
    "graded_count": {
      "type": "number"
    },
    "assignments_count": {
      "type": "number"
    },
    "stats": {
      "type": "object",
      "properties": {
        "mean": {
          "type": [
            "number",
            "null"
          ]
        },
        "median": {
          "type": [
            "number",
            "null"
          ]
        },
        "min": {
          "type": [
            "number",
            "null"
          ]
        },
        "max": {
          "type": [
            "number",
            "null"
          ]
        },
        "stdev": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "mean",
        "median",
        "min",
        "max",
        "stdev"
      ],
      "additionalProperties": false
    },
    "distribution": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "letter": {
            "type": "string"
          },
          "count": {
            "type": "number"
          }
        },
        "required": [
          "letter",
          "count"
        ],
        "additionalProperties": false
      }
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "weight": {
            "type": [
              "number",
              "null"
            ]
          },
          "drop_lowest": {
            "type": "number"
          },
          "class_average": {
            "type": [
              "number",
              "null"
            ]
          },
          "assignments": {
            "type": "number"
          }
        },
        "required": [
          "name",
          "weight",
          "drop_lowest",
          "class_average",
          "assignments"
        ],
        "additionalProperties": false
      }
    },
    "students": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "final": {
            "type": [
              "number",
              "null"
            ]
          },
          "letter": {
            "type": "string"
          },
          "missing": {
            "type": "number"
          }
        },
        "required": [
          "name",
          "final",
          "letter",
          "missing"
        ],
        "additionalProperties": false
      }
    },
    "students_shown": {
      "type": "number"
    },
    "missing_work": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "student": {
            "type": "string"
          },
          "assignments": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "student",
          "assignments"
        ],
        "additionalProperties": false
      }
    },
    "missing_total": {
      "type": "number"
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "pages": {
      "type": "number"
    },
    "downloads": {
      "type": "object",
      "properties": {
        "xlsx": {
          "type": "string"
        },
        "csv": {
          "type": "string"
        },
        "pdf": {
          "type": "string"
        }
      },
      "additionalProperties": false
    },
    "privacy": {
      "type": "string"
    }
  },
  "required": [
    "kind",
    "class_name",
    "grading",
    "letter_scale",
    "students_count",
    "graded_count",
    "assignments_count",
    "stats",
    "distribution",
    "categories",
    "students",
    "students_shown",
    "missing_work",
    "missing_total",
    "notes",
    "warnings",
    "downloads",
    "privacy"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🟢calculate_grade_needed(current_grade, final_weight, target, final_points_possible, students, ...)

Use this when someone asks what they need on the final: 'what do I need on my final to get a B', final grade calculator, score needed on the final exam to pass, or a teacher asking what each student needs on the final for a C. Takes the current grade percent (or a list of students with current grades), how much the final is worth, and a target percent or letter (default all letters on the scale). Returns the score needed on the final for each target (and the points needed when final points are given), whether it is reachable, and what-if course grades. Assumes the final is a separate weight on top of the current grade; does not model a final inside a weighted category.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "current_grade": {
      "description": "The grade before the final, as a percent, e.g. 84.5 or \"84.5%\".",
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "string",
          "maxLength": 40
        }
      ]
    },
    "final_weight": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "string",
          "maxLength": 40
        }
      ],
      "description": "How much the final counts toward the course grade, as a percent, e.g. 20 or \"20%\" (0.2 is read as 20%)."
    },
    "target": {
      "description": "The course grade wanted: a percent (90), a letter (\"B\") or several (\"A, B, C\"). Default: every letter on the scale.",
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "maxItems": 20,
          "type": "array",
          "items": {
            "type": [
              "number",
              "string"
            ]
          }
        }
      ]
    },
    "final_points_possible": {
      "description": "Points on the final exam, e.g. 120, to also show the points needed.",
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "string",
          "maxLength": 20
        }
      ]
    },
    "students": {
      "description": "For a teacher: several students' current grades, e.g. \"Ana Diaz 84.5, Ben Ito 71\" or [{\"name\":\"Ana Diaz\",\"current_grade\":84.5}]. Send this or current_grade.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 20000
        },
        {
          "maxItems": 500,
          "type": "array",
          "items": {}
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "letter_scale": {
      "description": "Letter cutoffs for letter targets. Default A 90, B 80, C 70, D 60; \"plus_minus\" or a custom list like \"A 93, B 85, C 75, D 65\".",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 300000
        },
        {
          "maxItems": 3000,
          "type": "array",
          "items": {}
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      ]
    },
    "plus_minus": {
      "description": "true for +/- letters. Default false.",
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "string",
          "maxLength": 10
        }
      ]
    }
  },
  "required": [
    "final_weight"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string"
    },
    "final_weight": {
      "type": "number"
    },
    "current_grade": {
      "type": [
        "number",
        "null"
      ]
    },
    "letter_scale": {
      "type": "string"
    },
    "targets": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "target": {
            "type": "string"
          },
          "target_percent": {
            "type": "number"
          },
          "needed_percent": {
            "type": "number"
          },
          "needed_points": {
            "type": [
              "number",
              "null"
            ]
          },
          "status": {
            "type": "string"
          }
        },
        "required": [
          "target",
          "target_percent",
          "needed_percent",
          "needed_points",
          "status"
        ],
        "additionalProperties": false
      }
    },
    "what_if": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "final_score": {
            "type": "number"
          },
          "course_grade": {
            "type": "number"
          },
          "letter": {
            "type": "string"
          }
        },
        "required": [
          "final_score",
          "course_grade",
          "letter"
        ],
        "additionalProperties": false
      }
    },
    "students": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "current_grade": {
            "type": "number"
          },
          "needed_percent": {
            "type": "number"
          },
          "status": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "current_grade",
          "needed_percent",
          "status"
        ],
        "additionalProperties": false
      }
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "kind",
    "final_weight",
    "current_grade",
    "letter_scale",
    "targets",
    "what_if",
    "students",
    "notes"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet3 Tools