Grade Calculator MCP Server

Grade Calculator

Work with course grades using percentage weights: compute your overall weighted average and letter grade, or figure out the minimum score required on a final or remaining assignment to reach a goal.

Capabilities

• Weighted average: Combine completed assignments with different weights (for example homework 30%, midterm 30%, final 40%) into an overall percentage, US letter grade, and 4.0-scale GPA points, with a per-item contribution breakdown.
• Drop lowest (same-weight groups): On the weighted-average tool, optional drop_lowest drops the lowest N scores within each group of items that share the same weight (for example five quizzes each worth 10%). Items with a unique weight are never dropped. Dropped rows still appear in the breakdown with dropped: true and zero contribution; the course average is sum(score × weight) over kept items divided by the sum of kept weights (remaining weights do not need to add to 100). The response includes dropped_count.
• Final or remaining score needed: Given grades you already have, the weight of what is left (final or major assignment), and a target overall percentage, compute the minimum score needed on that remaining portion. The tool reports whether that target is achievable (scores cannot exceed 100%), whether you have already locked in the target, and frames the target using standard letter cutoffs.
• US grading scale: Uses standard US letter grade cutoffs (A = 93+, B = 83+, etc.).

Gotchas

• Weights sum to 100: For the weighted-average tool with drop_lowest 0 or omitted, weights must total 100. When drop_lowest is greater than zero, that check is skipped; the average is still sum(score × weight) for kept items divided by the sum of kept weights. For the final-needed tool, the sum of weights for work already graded plus the weight of remaining work must total 100. Small rounding tolerance is allowed.
• Scores 0–100: Inputs are percentage scores on a 0–100 scale.
• Remaining weight: Must be the true share of the course still to be graded; the math assumes overall grade = (sum of score×weight for completed work + needed×remaining_weight) / 100.