Grade Calculator

Education REST API MCP

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 MCP tool findutils:grade_calculator. See the REST reference →

Use in the browser View as Markdown

Call it over MCP

Tool name findutils:grade_calculator · no API keys · 120 requests/min per IP

Claude Code

claude mcp add findutils --transport http https://mcp.findutils.com/

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/"
    }
  }
}

Raw JSON-RPC (any MCP client) — verified example

curl -X POST https://mcp.findutils.com/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "grade_calculator",
      "arguments": {
        "categories": [
          {
            "name": "Homework",
            "weight": 40,
            "assignments": [
              {
                "score": 90
              }
            ]
          },
          {
            "name": "Final",
            "weight": 60,
            "assignments": []
          }
        ],
        "target_grade": 90
      }
    }
  }'

Input 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 a REST endpoint

The same tool answers plain HTTP at POST /api/tools/grade-calculator/execute — no key, 60 requests/min.

Open the REST reference for Grade Calculator →

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