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

A
Description quality
97%
Schema completeness
97%
Naming quality
97%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,589Tokens (tool definitions)
~1.2 KBTypical response size
Moderate attention impact (1.24% of 128k context)

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-http

What it can do

Tool inventory

Tools (12)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded12 tools