{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"gpa"},"result":{"entity_type":"calculator","id":"gpa","calculator_id":"gpa","canonical_url":"https://tttkmbb.com/everyday/gpa","name":"GPA Calculator","title":"GPA Calculator – Credit-Weighted Grade Point Average on the 4.0 Scale","category":"everyday","category_name":"Everyday Life","tool_name":"calculate_gpa","featured_mcp_tool":false,"description":"Computes a grade point average as the credit-weighted mean of course grade points (quality points divided by total credits), with an unweighted average when credits are omitted, and the nearest US letter grade on the 4.0 scale.","use_when":"You have grade points (e.g. A = 4.0, B+ = 3.3) and credit hours for several courses and want the semester or cumulative GPA.","do_not_use_when":"You need the score required on a final exam (use final-grade), or a general weighted mean of other quantities (use weighted-average).","inputs":[{"name":"grade_points","label":"Grade points per course","type":"number_list","required":true,"description":"Grade points for each course on your scale, e.g. 4.0 for A, 3.7 for A−, 3.3 for B+, 3.0 for B, 2.0 for C, 1.0 for D, 0 for F.","example":[4,3.7,3.3,4]},{"name":"credits","label":"Credits per course","type":"number_list","required":false,"description":"Credit hours for each course, in the same order. Omit for an unweighted average (every course counts once).","example":[3,4,3,3]}],"outputs":[{"name":"gpa","label":"GPA","type":"number","decimals":2,"description":"Σ(grade_points × credits) / Σ credits."},{"name":"total_credits","label":"Total credits","type":"number","unit":"credits","decimals":2,"description":"Sum of credits (number of courses when credits are omitted)."},{"name":"total_quality_points","label":"Quality points","type":"number","decimals":2,"description":"Σ(grade_points × credits)."},{"name":"courses","label":"Courses","type":"integer","decimals":4,"description":"Number of courses included."},{"name":"letter_grade_equivalent","label":"Nearest letter grade","type":"string","decimals":4,"description":"Letter whose standard 4.0-scale value (A 4.0, A− 3.7, B+ 3.3 …) is closest to the GPA; only returned when all grade points are ≤ 4.3."}],"input_schema":{"type":"object","properties":{"grade_points":{"description":"Grade points for each course on your scale, e.g. 4.0 for A, 3.7 for A−, 3.3 for B+, 3.0 for B, 2.0 for C, 1.0 for D, 0 for F.","type":"array","items":{"type":"number"},"minItems":1,"examples":[[4,3.7,3.3,4]]},"credits":{"description":"Credit hours for each course, in the same order. Omit for an unweighted average (every course counts once).","type":"array","items":{"type":"number"},"minItems":1,"examples":[[3,4,3,3]]}},"additionalProperties":false,"required":["grade_points"]},"output_schema":{"type":"object","properties":{"gpa":{"description":"Σ(grade_points × credits) / Σ credits.","type":"number"},"total_credits":{"description":"Sum of credits (number of courses when credits are omitted). Unit: credits.","type":"number","x-unit":"credits"},"total_quality_points":{"description":"Σ(grade_points × credits).","type":"number"},"courses":{"description":"Number of courses included.","type":"integer"},"letter_grade_equivalent":{"description":"Letter whose standard 4.0-scale value (A 4.0, A− 3.7, B+ 3.3 …) is closest to the GPA; only returned when all grade points are ≤ 4.3.","type":"string"}}},"formula":"GPA = Σ(grade_points_i × credits_i) / Σ credits_i; without credits GPA = mean(grade_points)","method":"Uses the common US 4.0 scale mapping (A 4.0, A− 3.7, B+ 3.3, B 3.0, B− 2.7, C+ 2.3, C 2.0, C− 1.7, D+ 1.3, D 1.0, F 0). Institutions differ on A+ (4.0 or 4.3) and on weighting honours/AP courses; use your school's point values.","sources":[{"name":"College Board – How to Convert Your GPA to a 4.0 Scale","url":"https://pages.collegeboard.org/how-to-convert-gpa-4.0-scale","type":"reference","retrieved_at":"2026-09-23"},{"name":"Academic grading in the United States (Wikipedia)","url":"https://en.wikipedia.org/wiki/Academic_grading_in_the_United_States","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":"A, A−, B+, A with 3, 4, 3, 3 credits","inputs":{"grade_points":[4,3.7,3.3,4],"credits":[3,4,3,3]},"expected":{"gpa":3.75,"total_credits":13,"total_quality_points":48.7,"courses":4,"letter_grade_equivalent":"A-"},"url":"https://tttkmbb.com/api/v1/calculate/gpa?grade_points=4%2C3.7%2C3.3%2C4&credits=3%2C4%2C3%2C3"},{"name":"Unweighted: 3.0, 2.7, 4.0, 3.3","inputs":{"grade_points":[3,2.7,4,3.3]},"expected":{"gpa":3.25,"total_credits":4,"total_quality_points":13,"courses":4,"letter_grade_equivalent":"B+"},"url":"https://tttkmbb.com/api/v1/calculate/gpa?grade_points=3%2C2.7%2C4%2C3.3"}],"faq":[{"q":"How do I combine a previous cumulative GPA with new courses?","a":"Enter the old GPA as one 'course' with grade_points = old GPA and credits = total credits already completed, then add the new courses."},{"q":"Do pass/fail or withdrawn courses count?","a":"Usually not: they carry no grade points and are excluded from both quality points and credits. Leave them out."}],"tags":["gpa calculator","grade point average","weighted gpa","college gpa","semester gpa"],"related":[{"calculator_id":"final-grade","reason":"Score needed on a final exam to reach a target course grade."},{"calculator_id":"weighted-average","reason":"General weighted mean of any values."}],"links":{"html":"https://tttkmbb.com/everyday/gpa","markdown":"https://tttkmbb.com/everyday/gpa.md","json":"https://tttkmbb.com/everyday/gpa.json","api":"https://tttkmbb.com/api/v1/calculate/gpa","schema":"https://tttkmbb.com/api/v1/calculators/gpa","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-23"},"timestamp":"2026-09-23T23:28:22Z"}