GradeAtlas MCP

● Active

io.github.Aziz0346/gradeatlas

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

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "gradeatlas": {
      "url": "https://zhitmyoghxfwqcprrqjf.supabase.co/functions/v1/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http gradeatlas https://zhitmyoghxfwqcprrqjf.supabase.co/functions/v1/mcp
VS Code
code --add-mcp '{"name":"gradeatlas","type":"http","url":"https://zhitmyoghxfwqcprrqjf.supabase.co/functions/v1/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Other
Version
0.1.0
Registry
active
Published
11/17/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Mostly fine: GradeAtlas MCP is maintained, hosted endpoint answering without a key.

Maintained
Active
Last commit 5 days ago (Nov 17, 2026), 0 open issues.
Official registry
Active
Published as io.github.Aziz0346/gradeatlas in the official MCP registry, version 0.1.0.
Source
No licence found
Public repository, but GitHub reports no recognised licence (0 stars). Check the README before shipping it in a product.
Runs
Hosted by the publisher
Your client talks to zhitmyoghxfwqcprrqjf.supabase.co: prompts and tool arguments leave your machine for that host.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 00:07 UTCStatus history & uptime →
● Working328 msprotocol 2025-06-18v1.0.0tools

The endpoint answered the MCP handshake as "gradeatlas-mcp" and listed 12 tools. Answering since Nov 18, 2026.

Context cost ≈ 1.8k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 12 tools.

Tools (12)

  • convert_grade9 params

    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.

    Show parameters
    • source_gradestringrequiredGrade label (e.g. 'A', '8.5', 'First Class') in the source system
    • source_system_idstringgrading_systems id for the source system
    • target_system_idstringgrading_systems id for the target system
    • source_max_scalenumberSource scale maximum (e.g. 10 for India 10-point, 4 for US)
    • source_min_passnumberSource scale pass mark
    • target_max_scalenumberTarget scale maximum
    • target_min_passnumberTarget scale pass mark
    • source_mappingsarraySource grade mappings to use directly, instead of the database
    • target_mappingsarrayTarget grade mappings to use directly, instead of the database
  • get_us_equivalent5 params

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

    Show parameters
    • grade_pointsnumberrequiredGrade points on the source scale
    • max_scalenumberSource scale maximum (default 4)
    • min_passnumberSource scale pass mark
    • grading_system_idstringgrading_systems id whose bands set the US equivalent
    • mappingsarrayGrade mappings to use directly, instead of the database
  • gpa_to_percentage2 params

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

    Show parameters
    • gpanumberrequiredGPA value
    • max_scalenumberScale maximum (default 4)
  • calculate_gpa3 params

    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.

    Show parameters
    • coursesarrayrequired
    • scalestringScale to report the GPA on (default 4.0)
    • grading_system_idstringgrading_systems id whose bands resolve course grades
  • resolve_grading_scale2 params

    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.

    Show parameters
    • institution_idstringinstitutions id
    • country_codestringTwo-letter country code (e.g. IN, DE, US)
  • List countries with their default grading scale.

    Show parameters
    • regionstringFilter by region substring (e.g. Asia, Europe)
    • limitnumberMaximum countries to return (default 100, max 500)
  • get_country_grading_systems2 params

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

    Show parameters
    • country_codestringrequiredTwo-letter country code (e.g. IN, DE, US)
    • include_mappingsbooleanInclude grade mappings for each system (default true)
  • get_grade_mappings1 param

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

    Show parameters
    • grading_system_idstringrequiredgrading_systems id
  • search_universities2 params

    Search institutions, grading systems and institution candidates by name.

    Show parameters
    • querystringrequiredSearch text (at least 2 characters)
    • limitnumberMaximum results per source (default 10, max 50)
  • get_institution2 params

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

    Show parameters
    • institution_idstringinstitutions id
    • slugstringInstitution slug (or name, as a fallback)
  • calculate_normalized_gpa4 params

    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.

    Show parameters
    • grading_system_version_idstringgrading_system_versions id
    • grading_system_idstringgrading_system_canonical id (resolved to its active version)
    • raw_gradestringrequiredRaw grade label or number (e.g. 'A', '8.5')
    • raw_percentnumberRaw percentage (0-100), used for numeric band matching
  • get_country_guide1 param

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

    Show parameters
    • country_codestringrequiredTwo-letter country code (e.g. IN, DE, US)

Checked by Serverdex with a plain initialize + tools/list call to zhitmyoghxfwqcprrqjf.supabase.co/functions/v1/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 18, 2026
Stars
0
Forks
0
Last push
Nov 17, 2026
License
—

From the 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): 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: convertgrade, getusequivalent, gpatopercentage, calculategpa, resolvegradingscale, listcountries, getcountrygradingsystems, getgrademappings, searchuniversities, getinstitution, calculatenormalizedgpa, and getcountryguide. 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

Read the full README on GitHub →

Remotes

  • streamable-httphttps://zhitmyoghxfwqcprrqjf.supabase.co/functions/v1/mcp

The most-starred Other servers in the index, with their live-check result.

ServerStarsLast pushLive check
Labelhead Artist Momentum114,594Nov 2026Working
World Monitor91,002Nov 2026Needs sign-in
Tldraw51,470Nov 2026Working
OpenSEO28,515Nov 2026Needs sign-in
Windows MCP11,833Nov 2026Local / not checked

GradeAtlas MCP: questions people ask

Is GradeAtlas MCP a remote or a local MCP server?
According to its entry in the official MCP registry, GradeAtlas MCP ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does GradeAtlas MCP need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is GradeAtlas MCP safe to use?
Mostly fine: GradeAtlas MCP is maintained, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: No licence found; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is GradeAtlas MCP still maintained?
Active: the repository's last commit 5 days ago. Last push Nov 17, 2026, 0 GitHub stars. Read from GitHub on Nov 18, 2026.
What tools does GradeAtlas MCP expose?
12 tools as listed by the server itself during the live check, including convert_grade, get_us_equivalent, gpa_to_percentage, calculate_gpa, resolve_grading_scale. The full list with parameters is in the Live check section above.
How do I add GradeAtlas MCP to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Other →

Add the badge to your site

Show visitors that GradeAtlas MCP is listed here — it’s also the link we check for a free listing.

GradeAtlas MCP — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-aziz0346-gradeatlas?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="GradeAtlas MCP — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![GradeAtlas MCP — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-aziz0346-gradeatlas?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-aziz0346-gradeatlas) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-aziz0346-gradeatlas) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-aziz0346-gradeatlas)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-aziz0346-gradeatlas"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-aziz0346-gradeatlas"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-aziz0346-gradeatlas"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).