# Grade Calculator — REST API endpoint `grade-calculator`

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.

- Category: education
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/grade-calculator/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/api/grade-calculator/
- Same tool on the other surface: https://findutils.com/mcp/grade-calculator/

## Call the endpoint (verified example)

```bash
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
curl https://api.findutils.com/api/tools/grade-calculator
```

## 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):

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

OpenAPI 3.1 spec: https://findutils.com/api/openapi.json · Interactive docs: https://findutils.com/api/docs/

## Also an MCP tool

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

Then ask the client to call `findutils:grade_calculator`. Full MCP reference: https://findutils.com/mcp/grade-calculator/

---
Full catalog: GET https://api.findutils.com/api/tools · https://findutils.com/api/ · https://findutils.com/llms.txt