Grade Calculator API

POST https://api.findutils.com/api/tools/grade-calculator/execute

Calculate a weighted course grade from categories (homework, quizzes, exams) with assignment scores, the letter grade (A to F), and the score needed on the remaining weight to reach a target grade. Categories with no scored assignments count as remaining weight.

Open the tool Try it

Request body

application/json

categories

array required

Grade categories. Each item: { name?: string, weight: number (percent of the final grade), assignments: [{ name?: string, score: number, max_score?: number (default 100) }] }.
target_grade

number optional

Target final grade in percent. Default 90. Default 90.

Example arguments

Verified

{
  "categories": [
    {
      "name": "Homework",
      "weight": 40,
      "assignments": [
        {
          "score": 90
        }
      ]
    },
    {
      "name": "Final",
      "weight": 60,
      "assignments": []
    }
  ],
  "target_grade": 90
}

curl -X POST https://api.findutils.com/api/tools/grade-calculator/execute \
  -H "Content-Type: application/json" \
  -d '{
    "categories": [
      {
        "name": "Homework",
        "weight": 40,
        "assignments": [
          {
            "score": 90
          }
        ]
      },
      {
        "name": "Final",
        "weight": 60,
        "assignments": []
      }
    ],
    "target_grade": 90
  }'

const response = await fetch('https://api.findutils.com/api/tools/grade-calculator/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"categories":[{"name":"Homework","weight":40,"assignments":[{"score":90}]},{"name":"Final","weight":60,"assignments":[]}],"target_grade":90}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/grade-calculator/execute",
    json={"categories":[{"name":"Homework","weight":40,"assignments":[{"score":90}]},{"name":"Final","weight":60,"assignments":[]}],"target_grade":90},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/grade-calculator/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"categories":[{"name":"Homework","weight":40,"assignments":[{"score":90}]},{"name":"Final","weight":60,"assignments":[]}],"target_grade":90}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call grade_calculator from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: None
REST id: grade-calculator
MCP name: grade_calculator
Category: Education
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More Education tools

More to explore