{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"final-grade"},"result":{"entity_type":"calculator","id":"final-grade","calculator_id":"final-grade","canonical_url":"https://tttkmbb.com/everyday/final-grade","name":"Final Grade Calculator","title":"Final Grade Calculator – Score Needed on the Final Exam to Reach a Target Grade","category":"everyday","category_name":"Everyday Life","tool_name":"calculate_required_final_grade","featured_mcp_tool":false,"description":"Solves the weighted-average grade equation for the final exam score required to reach a desired overall grade, given the current grade and the final's weight, and reports whether that score is achievable.","use_when":"You know your current course grade and the final exam's weight and want the minimum final score for a target grade.","do_not_use_when":"Grades are combined by points or categories rather than a percentage weight (compute the weighted mean directly with weighted-average), or you need a GPA (use gpa).","inputs":[{"name":"current_grade_percent","label":"Current grade","type":"number","unit":"%","required":true,"min":0,"max":150,"description":"Current weighted grade over all work except the final, in percent.","example":85},{"name":"final_weight_percent","label":"Weight of the final","type":"number","unit":"%","required":true,"max":100,"exclusive_min":0,"description":"Share of the overall grade determined by the final exam.","example":30},{"name":"desired_grade_percent","label":"Desired overall grade","type":"number","unit":"%","required":true,"min":0,"max":150,"description":"Overall grade you want to end up with.","example":90}],"outputs":[{"name":"required_final_percent","label":"Required final score","type":"number","unit":"%","decimals":2,"description":"Minimum score on the final; can be below 0 or above 100."},{"name":"achievable","label":"Achievable","type":"boolean","decimals":4,"description":"true when the required score is at most 100 %."},{"name":"assessment","label":"Assessment","type":"string","decimals":4,"description":"Plain-language feasibility of the target."},{"name":"max_possible_grade_percent","label":"Best possible overall grade","type":"number","unit":"%","decimals":2,"description":"Overall grade with 100 % on the final."},{"name":"min_possible_grade_percent","label":"Lowest possible overall grade","type":"number","unit":"%","decimals":2,"description":"Overall grade with 0 % on the final."}],"input_schema":{"type":"object","properties":{"current_grade_percent":{"description":"Current weighted grade over all work except the final, in percent. Unit: %.","type":"number","minimum":0,"maximum":150,"examples":[85],"x-unit":"%"},"final_weight_percent":{"description":"Share of the overall grade determined by the final exam. Unit: %.","type":"number","maximum":100,"exclusiveMinimum":0,"examples":[30],"x-unit":"%"},"desired_grade_percent":{"description":"Overall grade you want to end up with. Unit: %.","type":"number","minimum":0,"maximum":150,"examples":[90],"x-unit":"%"}},"additionalProperties":false,"required":["current_grade_percent","final_weight_percent","desired_grade_percent"]},"output_schema":{"type":"object","properties":{"required_final_percent":{"description":"Minimum score on the final; can be below 0 or above 100. Unit: %.","type":"number","x-unit":"%"},"achievable":{"description":"true when the required score is at most 100 %.","type":"boolean"},"assessment":{"description":"Plain-language feasibility of the target.","type":"string"},"max_possible_grade_percent":{"description":"Overall grade with 100 % on the final. Unit: %.","type":"number","x-unit":"%"},"min_possible_grade_percent":{"description":"Overall grade with 0 % on the final. Unit: %.","type":"number","x-unit":"%"}}},"formula":"w = final_weight_percent / 100; required = (desired_grade_percent − current_grade_percent × (1 − w)) / w; max = current × (1 − w) + 100 × w; min = current × (1 − w)","sources":[{"name":"Weighted arithmetic mean (Wikipedia)","url":"https://en.wikipedia.org/wiki/Weighted_arithmetic_mean","type":"reference","retrieved_at":"2026-09-23"}],"freshness":{"type":"static","max_age_seconds":null,"note":"Deterministic formula with fixed constants; results never go stale. Inputs supplied by the caller determine the output."},"examples":[{"name":"85 % now, final worth 30 %, want 90 %","inputs":{"current_grade_percent":85,"final_weight_percent":30,"desired_grade_percent":90},"expected":{"required_final_percent":101.67,"achievable":false,"max_possible_grade_percent":89.5,"min_possible_grade_percent":59.5},"url":"https://tttkmbb.com/api/v1/calculate/final-grade?current_grade_percent=85&final_weight_percent=30&desired_grade_percent=90"},{"name":"78 % now, final worth 40 %, want 80 %","inputs":{"current_grade_percent":78,"final_weight_percent":40,"desired_grade_percent":80},"expected":{"required_final_percent":83,"achievable":true,"max_possible_grade_percent":86.8,"min_possible_grade_percent":46.8},"url":"https://tttkmbb.com/api/v1/calculate/final-grade?current_grade_percent=78&final_weight_percent=40&desired_grade_percent=80"}],"faq":[{"q":"What is 'current grade'?","a":"Your weighted average over everything graded so far, expressed as a percentage of the non-final portion; many learning platforms show it as the running course grade."},{"q":"The required score is above 100 %. What now?","a":"The target is out of reach without extra credit; max_possible_grade_percent shows the best you can still achieve."}],"tags":["final grade calculator","what do I need on my final","exam score needed","grade calculator","final exam"],"related":[{"calculator_id":"gpa","reason":"Combine course grades into a GPA."},{"calculator_id":"weighted-average","reason":"Weighted mean of several assessment categories."}],"links":{"html":"https://tttkmbb.com/everyday/final-grade","markdown":"https://tttkmbb.com/everyday/final-grade.md","json":"https://tttkmbb.com/everyday/final-grade.json","api":"https://tttkmbb.com/api/v1/calculate/final-grade","schema":"https://tttkmbb.com/api/v1/calculators/final-grade","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-23"},"timestamp":"2026-09-23T23:25:35Z","next_actions":[{"tool":"run_calculator","calculator_id":"final-grade","reason":"Run Final Grade Calculator with the inputs above."}],"links":{"markdown":"https://tttkmbb.com/everyday/final-grade.md"}}