Verified calculation capability

Final grade Calculation Capability

Need-on-final, overall after the exam, weighted categories, and points-to-weight for a fixed final exam share. · Education

Capability ID education.final_grade · version 1.1.1

Open calculator REST API MCP Evidence Evidence JSON CVP Manifest Review policy

Model

Needed (percent form)

Needed (percent form): Needed = (Goal×100 − Current×(100−W)) / W
Overall (percent form): Overall = Current×(100−W)/100 + Final×W/100
Overall (fraction form): Overall = Current×(1−w) + Final×w

Solve modes: need · overall · weighted · points

Inputs / Outputs

Canonical symbols for this capability. Agent schemas remain the contract.

Symbol	Quantity	Unit	Role
`currentInput`	Pre-final current grade % (Need / Overall). Must exclude the final.	—	input
`goalInput`	Desired course grade % (Need / Weighted remaining)	—	input
`weightInput`	Final exam weight W as a percent (40 = 40%). Need on final requires W > 0.	—	input
`finalScoreInput`	Final exam score % (Overall after final)	—	input
`remainWeightInput`	Remaining weight % (Weighted). Omit to use 100 − Σ completed weights.	—	input
`categories`	Completed categories: array of {name?, grade, weight} or packed string name:grade:weight\|…	—	input
`totalPointsInput`	Course total points including the final (Points → weight)	—	input
`finalPointsInput`	Final exam points (Points → weight)	—	input
`code`	—	—	output
`value`	Primary result: needed %, overall %, completed average, or final weight %	—	output
`unit`	—	—	output
`reachability`	—	—	output
`message`	—	—	output
`current`	—	—	output
`goal`	—	—	output
`weight`	—	—	output
`remain`	—	—	output
`needed`	—	—	output
`finalScore`	—	—	output
`overall`	—	—	output
`counted`	—	—	output
`weightSum`	—	—	output
`weightedSum`	—	—	output
`currentAvg`	—	—	output
`total`	—	—	output
`finalPts`	—	—	output

Assumptions / Validity

Declared scope for this capability. Do not use it outside this domain.

Assumptions

Category weights are percentages that should total about 100% including remaining work.
Need on final / Overall after final: Current must exclude the final. Do not enter a current grade that already counts the final as 0%.
Weighted course: enter category grades and weights as they actually appear in the syllabus or LMS for completed work.
No curve, drop-lowest, or extra credit unless you adjust inputs yourself.

Not supported

Official transcripts
curves
drop-lowest
or extra credit as built-in rules
treating the letter/GPA table as a universal scale.

Example

One numerical check. The calculator page holds worked steps and FAQ.

Current 85%, goal 90%, final 40% → need 97.5% on the final

Open this example in the calculator

Trust

CVP VERIFIED · CVP protocol 1.0.0-proposed · Engineering assurance. Computational verification is defined by CVP. Supplemental domain review (internal) and named expert review are defined by the Review policy and do not by themselves determine CVP conformance.

CVP: CVP VERIFIED · CVP protocol 1.0.0-proposed · Engineering assurance· View Manifest · CVP overview · Specification
Assurance: Engineering
Declared partition coverage: PASS · 5/5 declared partitions (need, overall, weighted, points, invalid-domain)
Calculation version: 1.1.1
Verification: 26/26 calculation tests · 5/5 legacy golden · 12/12 legacy boundary · 8/8 legacy property
Production surface contract: 4/4
Versions: Calculation 1.1.1 · CVP protocol 1.0.0-proposed
CVP identity: 8/8 property · digest d660dddb19db
Reference: O1 model · O2 expected_values · O2 numerical_behavior
Interfaces: PASS · UI (SSR) / REST / MCP
ui-ssr is query-result HTML, not a live browser session.
CVP suite: 1/1 golden · 12/12 CVP boundary · 4/4 invalid · 8/8 property · 1/1 cross-interface · 1/1 CVP contract
Supplemental domain review: Not performed
Named expert review: Not performed
Version lock: Supported (409 VERSION_MISMATCH)
Artifact consistency: Build verified · 1.1.1 (workspace artifacts agree)
Review-policy tier: Engine tested — catalog token engine_tested; supplemental; not CVP status

This calculator CURRENT · Public schema 1.1.1 matches · Semantic contract ✓ · Production attested · Public/cache ✓ · Origin ✓

Call this capability

Human page, REST, and MCP share the same engine and calculation_version. Build verified hashes workspace artifacts only. After deploy, attest:production GETs canonical URLs twice — the public/cached view an Agent actually hits, and origin — including every /capabilities/{id} HTML page. Public Capability HTML version must match catalog before production attestation passes. Live Trust rows above fetch /.well-known/calculatorx-production-attestation.json and the output schema const. Build hashes: release integrity. That proves currently published page / engine / schema / evidence / MCP agree — not that a historical version is independently immutable. Reference Calculation Standard — Production surface contract 4/4.

Tool id: final-grade
Engine: final-grade
REST: POST /api/v1/calc/final-grade
MCP: execute_calculation with capability_id: "education.final_grade"
Agent input schema: Canonical (MCP / Agent)
Output schema: JSON Schema (latest)
Versioned input schema: Immutable pin (1.1.1)
Versioned output schema: Immutable pin (1.1.1)

Operations

Declared calculation modes for this capability.

need
overall
weighted
points

References

Human-readable sources plus CVP reference evidence classes.

Sources

University of Chicago — Use Weighted Assignment Groups in Your Canvas Course — Total = Σ(category percentage × group weight); example: quizzes 20% + midterm 30% + final 40% + participation 10%
Appalachian State University — Gradebook: Weighted Mean of Grades (Percentages) — Weighted mean of grades; unentered items are excluded and remaining weights are rescaled until those scores exist
Weighted arithmetic mean (pre-final average and final exam weight) — Overall = Current×(100−W)/100 + Final×W/100, equivalently Current(1−w)+Final·w with w = W/100

Reference evidence classes: O1 model · O2 expected_values · O2 numerical_behavior

Try with an agent

Inspect this capability via same-origin MCP, then call execute_calculation.

curl -sS -X POST 'https://www.calculatorx.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/call' \
  -H 'Mcp-Name: inspect_capability' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"inspect_capability","arguments":{"capability_id":"education.final_grade"}}}'

Inspect the trust tier and required assurance level before execution. Pin calculation_version (1.1.1) when reproducibility matters. Full protocol notes: MCP docs.