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.
This page documents the HTTP endpoint POST /api/tools/grade-calculator/execute. See the MCP reference →
Call it over REST
POST https://api.findutils.com/api/tools/grade-calculator/execute · no API keys · 60 requests/min per IP
Execute — verified arguments
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
}'Parameter schema for this endpoint
curl https://api.findutils.com/api/tools/grade-calculatorInput schema
| Argument | Type | Required | Description |
|---|---|---|---|
| categories | array | yes | 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 | no | 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
}Also an MCP tool
Claude, Cursor, and any MCP client can call this tool as
findutils:grade_calculator after one connect command.
Connect once
claude mcp add findutils --transport http https://mcp.findutils.com/More Education tools
Attendance Sheet Generator
Generate a blank attendance sheet for a list of students over consecutive days and return the date columns, a CSV, a Markdown table, and a p
Course Quiz Generator
Build a printable course quiz from a list of questions (multiple choice, true/false, short answer, fill in the blank) and return the numbere
Essay Outline Generator
Generate a structured essay outline (introduction, body paragraphs, conclusion) for five essay types and three lengths, and return each sect
Flashcard Maker
Turn a list of front/back pairs into a flashcard deck and return the numbered cards plus ready-to-import formats: CSV (Front,Back), tab-sepa
Gpa Calculator
Calculate a grade point average (GPA) on the 4.0 scale from course letter grades and credits.
Lesson Plan Template
Fill a structured lesson plan template (header, learning objectives, materials, timed activities, assessment, homework, notes) and return th
Quiz Maker
Build a multiple-choice quiz from questions with options and a correct option index and return the numbered quiz, an answer key, a printable
Readability Calculator
Compute six readability scores for English text (Flesch Reading Ease, Flesch-Kincaid Grade, Gunning Fog, SMOG, Coleman-Liau, Automated Reada