GradeAtlas MCP

io.github.Aziz0346Published by GitHub account Aziz0346v0.1.0Updated Nov 17, 2026

Convert grades between 1,159 grading systems across 246 countries into the US 4.0 GPA scale.

The publisher's own server: Red Atlas Api

VerifiedStreamable HTTPWeb executable

Overview

AI-generated overview

Remote MCP server that converts grades between 1,159 grading systems in 246 countries and the US 4.0 GPA scale, with university lookup and country guides.

What you can do
  • Convert grades between grading systems and to US GPA equivalents, including letter grades and honours
  • Convert GPA to percentage and calculate weighted GPA from courses with credits and course weight
  • Resolve the applicable grading scale for an institution or country, with confidence and explanation
  • Look up countries, their grading systems, grade-to-GPA mapping bands and institution details
  • Search institutions and grading systems by name
  • Assemble a country grading guide with scale tables, conversion tables, FAQs and common mistakes
When to use it
Useful when an assistant has to interpret foreign transcripts, compare grades across countries, compute a US GPA equivalent, or explain how a particular country or university grades students.
Requirements
A remote Streamable HTTP endpoint; no authentication, API keys or environment variables are declared. Any MCP client that supports remote Streamable HTTP servers can connect.
Before you install
Conversions are estimates based on band logic and fallbacks, so results should be checked against official institutional rules before being used for admissions or credential decisions. The server is read-only and requires no credentials.

Installation

In SourceWeft

  1. Open GradeAtlas MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Aziz0346%2Fgradeatlas/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "gradeatlas": {
      "type": "http",
      "url": "https://zhitmyoghxfwqcprrqjf.supabase.co/functions/v1/mcp"
    }
  }
}

README

GradeAtlas MCP

GradeAtlas MCP — convert grades between 1,159 grading systems across 246 countries into the US 4.0 GPA scale, with university search and country grading guides.

MCP endpoint

Remote MCP server (Streamable HTTP, no authentication required):

https://zhitmyoghxfwqcprrqjf.supabase.co/functions/v1/mcp

Add the URL above as a remote MCP server in Claude, ChatGPT, Cursor, or any MCP client that supports Streamable HTTP servers. More on https://gradeatlas.org.

Tools

The server exposes 12 tools: convert_grade, get_us_equivalent, gpa_to_percentage, calculate_gpa, resolve_grading_scale, list_countries, get_country_grading_systems, get_grade_mappings, search_universities, get_institution, calculate_normalized_gpa, and get_country_guide.

Registry

This repository publishes the server to the official MCP Registry as io.github.Aziz0346/gradeatlas. Publishing is automated: pushing a tag like v0.1.0 runs the workflow in .github/workflows/publish-mcp.yml.

License

MIT

Source: README.md at commit 2b9a36a

Tools

12

convert_grade

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.

Parameterssource_graderequiredsource_mappingssource_min_passtarget_mappingstarget_min_passsource_max_scalesource_system_idtarget_max_scaletarget_system_id

get_us_equivalent

Convert grade points on any scale to a US GPA, with letter grade and honours classification.

Parametersmappingsmin_passmax_scalegrade_pointsrequiredgrading_system_id

gpa_to_percentage

Convert a GPA to a percentage (0-100) on its scale.

Parametersgparequiredmax_scale

calculate_gpa

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.

Parametersscalecoursesrequiredgrading_system_id

resolve_grading_scale

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.

Parameterscountry_codeinstitution_id

list_countries

List countries with their default grading scale.

Parameterslimitregion

get_country_grading_systems

Get the grading systems for a country, with their grade mappings.

Parameterscountry_coderequiredinclude_mappings

get_grade_mappings

Get the grade-to-GPA mapping bands for one grading system.

Parametersgrading_system_idrequired

search_universities

Search institutions, grading systems and institution candidates by name.

Parameterslimitqueryrequired

get_institution

Get an institution's detail, its country, its grading override and its resolved grading scale.

Parameterssluginstitution_id

calculate_normalized_gpa

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.

Parametersraw_graderequiredraw_percentgrading_system_idgrading_system_version_id

get_country_guide

Assemble a country grading guide: scale table with US 4.0 equivalents, conversion tables, FAQs, common mistakes and confidence/coverage stats.

Parameterscountry_coderequired

Version history

1
  1. v0.1.0LatestNov 17, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Atlas integrations