nz_ncea_grade_calculator
Work out an NCEA result: credits, the co-requisite, the certificate, endorsements and UE, on NZQA's Assessment Rules 2026.
Use for: 'have I passed NCEA level 2', 'how many credits do I need for
NCEA', 'NCEA literacy and numeracy co-requisite', 'NCEA merit
endorsement', 'how many credits for excellence endorsement', 'course
endorsement NCEA', 'do I have University Entrance', 'NCEA calculator'.
60 CREDITS AT THE LEVEL OR ABOVE, PLUS THE CO-REQUISITE (10 LITERACY AND
10 NUMERACY, MET ONCE FOR EVERY LEVEL). NZQA's "80 credits" is 60 + 20.
The old rule of 80 credits alone is gone: 80 credits with no co-requisite
is not a certificate. Ask whether the co-requisite is met; if it was met
in an earlier year, or under the old rules in 2023 or earlier, pass 10
and 10. Do not put co-requisite credits in subjects.
50 GAINS A CERTIFICATE ENDORSEMENT, AND 49 DOES NOT, BUT ONLY WITH THE
CERTIFICATE. Excellence: 50 Excellence credits. Merit: 50 at Merit OR
Excellence, so Excellence credits count towards Merit. With 50 credits
but no certificate, *_endorsement_credits_met is true and
*_endorsement_earned is false: say it is awarded once the level is.
COURSE ENDORSEMENT IS 14 CREDITS IN ONE COURSE: Excellence at Excellence,
Merit at Merit or above, Achieved at any grade.
UE (LEVEL 3 ONLY): NCEA Level 3, three approved subjects each with 14+
credits, literacy of 5 reading AND 5 writing (not 10 in total), and 10
numeracy credits. Say which requirement is missing.
Not checked: the level of each standard, and the 3 internal and 3
external credits a course endorsement needs in most courses. New
qualifications replace NCEA from 2028 and are not modelled. For a rank
score, use nz_ncea_rank_score_calculator.
Args:
level: 1, 2 or 3.
subjects: List of {"name", "achieved", "merit", "excellence",
"ue_approved"}; credits that count towards the 60, whole numbers;
ue_approved is for Level 3 subjects on NZQA's approved list.
ue_literacy_reading_credits: Level 3: Level 2+ reading credits on the UE list.
ue_literacy_writing_credits: Level 3: Level 2+ writing credits on the UE list.
ue_numeracy_credits: Level 3: UE numeracy credits.
literacy_corequisite_credits: literacy co-requisite credits (need 10).
numeracy_corequisite_credits: numeracy co-requisite credits (need 10).
Returns:
Totals by grade, whether the 60 and the co-requisite are met, whether
the level is achieved and what is missing, both certificate
endorsements with credits still needed, each course endorsement, and
University Entrance at Level 3.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"level": "<level>",
"subjects": "<subjects>"
},
"name": "nz_ncea_grade_calculator"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| level | Yes | ||
| subjects | Yes | ||
| ue_numeracy_credits | No | ||
| ue_literacy_reading_credits | No | ||
| ue_literacy_writing_credits | No | ||
| literacy_corequisite_credits | No | ||
| numeracy_corequisite_credits | No |