GradeAtlas MCP
Convert grades between 1,159 grading systems across 246 countries into the US 4.0 GPA scale.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"gradeatlas": {
"url": "https://zhitmyoghxfwqcprrqjf.supabase.co/functions/v1/mcp"
}
}
}Remote endpoints
https://zhitmyoghxfwqcprrqjf.supabase.co/functions/v1/mcpstreamable-httpWhat it can do
Tool inventory
Tools (12)
🟢convert_grade(source_grade, source_system_id, target_system_id, source_max_scale, source_min_pass, ...)
Convert one grade between two grading systems using the real band-standing logic (Bavarian formula for inverted scales, linear fallback), via the US 4.0 baseline. Give grading-system ids to read bands from the database, or max_scale/min_pass numbers for a numeric conversion.
Input Schema
{
"type": "object",
"properties": {
"source_grade": {
"type": "string",
"description": "Grade label (e.g. 'A', '8.5', 'First Class') in the source system"
},
"source_system_id": {
"type": "string",
"description": "grading_systems id for the source system"
},
"target_system_id": {
"type": "string",
"description": "grading_systems id for the target system"
},
"source_max_scale": {
"type": "number",
"description": "Source scale maximum (e.g. 10 for India 10-point, 4 for US)"
},
"source_min_pass": {
"type": "number",
"description": "Source scale pass mark"
},
"target_max_scale": {
"type": "number",
"description": "Target scale maximum"
},
"target_min_pass": {
"type": "number",
"description": "Target scale pass mark"
},
"source_mappings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"grade": {
"type": "string"
},
"points": {
"type": "number"
},
"min_value": {
"type": "number"
},
"max_value": {
"type": "number"
},
"classification": {
"type": "string"
},
"us_equivalent": {
"type": [
"string",
"number"
]
}
},
"required": [
"grade",
"points"
]
},
"description": "Source grade mappings to use directly, instead of the database"
},
"target_mappings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"grade": {
"type": "string"
},
"points": {
"type": "number"
},
"min_value": {
"type": "number"
},
"max_value": {
"type": "number"
},
"classification": {
"type": "string"
},
"us_equivalent": {
"type": [
"string",
"number"
]
}
},
"required": [
"grade",
"points"
]
},
"description": "Target grade mappings to use directly, instead of the database"
}
},
"required": [
"source_grade"
]
}🟢get_us_equivalent(grade_points, max_scale, min_pass, grading_system_id, mappings)
Convert grade points on any scale to a US GPA, with letter grade and honours classification.
Input Schema
{
"type": "object",
"properties": {
"grade_points": {
"type": "number",
"description": "Grade points on the source scale"
},
"max_scale": {
"type": "number",
"description": "Source scale maximum (default 4)"
},
"min_pass": {
"type": "number",
"description": "Source scale pass mark"
},
"grading_system_id": {
"type": "string",
"description": "grading_systems id whose bands set the US equivalent"
},
"mappings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"grade": {
"type": "string"
},
"points": {
"type": "number"
},
"min_value": {
"type": "number"
},
"max_value": {
"type": "number"
},
"classification": {
"type": "string"
},
"us_equivalent": {
"type": [
"string",
"number"
]
}
},
"required": [
"grade",
"points"
]
},
"description": "Grade mappings to use directly, instead of the database"
}
},
"required": [
"grade_points"
]
}⚪gpa_to_percentage(gpa, max_scale)
Convert a GPA to a percentage (0-100) on its scale.
Input Schema
{
"type": "object",
"properties": {
"gpa": {
"type": "number",
"description": "GPA value"
},
"max_scale": {
"type": "number",
"description": "Scale maximum (default 4)"
}
},
"required": [
"gpa"
]
}🟢calculate_gpa(courses, scale, grading_system_id)
Calculate a weighted GPA from courses (grade, credits, weight regular/honors/ap/ib), optionally resolved against a grading system in the database using the real band logic.
Input Schema
{
"type": "object",
"properties": {
"courses": {
"type": "array",
"items": {
"type": "object",
"properties": {
"grade": {
"type": "string",
"description": "Letter grade, percentage, or a grade label from the grading system"
},
"credits": {
"type": "number"
},
"weight": {
"type": "string",
"enum": [
"regular",
"honors",
"ap",
"ib"
]
}
},
"required": [
"grade",
"credits"
]
}
},
"scale": {
"type": "string",
"enum": [
"4.0",
"5.0",
"percentage",
"ects",
"bavarian"
],
"description": "Scale to report the GPA on (default 4.0)"
},
"grading_system_id": {
"type": "string",
"description": "grading_systems id whose bands resolve course grades"
}
},
"required": [
"courses"
]
}⚪resolve_grading_scale(institution_id, country_code)
Resolve the applicable grading scale for an institution and/or country: institution override, then country profile, then global default, then a US 4.0 fallback — with confidence and an explanation.
Input Schema
{
"type": "object",
"properties": {
"institution_id": {
"type": "string",
"description": "institutions id"
},
"country_code": {
"type": "string",
"description": "Two-letter country code (e.g. IN, DE, US)"
}
},
"required": []
}🟢list_countries(region, limit)
List countries with their default grading scale.
Input Schema
{
"type": "object",
"properties": {
"region": {
"type": "string",
"description": "Filter by region substring (e.g. Asia, Europe)"
},
"limit": {
"type": "number",
"description": "Maximum countries to return (default 100, max 500)"
}
},
"required": []
}🟢get_country_grading_systems(country_code, include_mappings)
Get the grading systems for a country, with their grade mappings.
Input Schema
{
"type": "object",
"properties": {
"country_code": {
"type": "string",
"description": "Two-letter country code (e.g. IN, DE, US)"
},
"include_mappings": {
"type": "boolean",
"description": "Include grade mappings for each system (default true)"
}
},
"required": [
"country_code"
]
}🟢get_grade_mappings(grading_system_id)
Get the grade-to-GPA mapping bands for one grading system.
Input Schema
{
"type": "object",
"properties": {
"grading_system_id": {
"type": "string",
"description": "grading_systems id"
}
},
"required": [
"grading_system_id"
]
}🟢search_universities(query, limit)
Search institutions, grading systems and institution candidates by name.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search text (at least 2 characters)"
},
"limit": {
"type": "number",
"description": "Maximum results per source (default 10, max 50)"
}
},
"required": [
"query"
]
}🟢get_institution(institution_id, slug)
Get an institution's detail, its country, its grading override and its resolved grading scale.
Input Schema
{
"type": "object",
"properties": {
"institution_id": {
"type": "string",
"description": "institutions id"
},
"slug": {
"type": "string",
"description": "Institution slug (or name, as a fallback)"
}
},
"required": []
}🟢calculate_normalized_gpa(grading_system_version_id, grading_system_id, raw_grade, raw_percent)
Normalize a raw grade with the SQL calculate_normalized_gpa function (piecewise band match on a grading-system version), with a TypeScript piecewise fallback when the SQL function is unavailable.
Input Schema
{
"type": "object",
"properties": {
"grading_system_version_id": {
"type": "string",
"description": "grading_system_versions id"
},
"grading_system_id": {
"type": "string",
"description": "grading_system_canonical id (resolved to its active version)"
},
"raw_grade": {
"type": "string",
"description": "Raw grade label or number (e.g. 'A', '8.5')"
},
"raw_percent": {
"type": "number",
"description": "Raw percentage (0-100), used for numeric band matching"
}
},
"required": [
"raw_grade"
]
}🟢get_country_guide(country_code)
Assemble a country grading guide: scale table with US 4.0 equivalents, conversion tables, FAQs, common mistakes and confidence/coverage stats.
Input Schema
{
"type": "object",
"properties": {
"country_code": {
"type": "string",
"description": "Two-letter country code (e.g. IN, DE, US)"
}
},
"required": [
"country_code"
]
}Community
Evidence