Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Scale to report the GPA on (default 4.0)
grading_systems id whose bands resolve course grades
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http gradeatlas https://zhitmyoghxfwqcprrqjf.supabase.co/functions/v1/mcp
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.
| Argument | Type | Description |
|---|---|---|
| scale | string | Scale to report the GPA on (default 4.0) |
| courses* | array | |
| grading_system_id | string | grading_systems id whose bands resolve course grades |
{
"type": "object",
"required": [
"courses"
],
"properties": {
"scale": {
"enum": [
"4.0",
"5.0",
"percentage",
"ects",
"bavarian"
],
"type": "string",
"description": "Scale to report the GPA on (default 4.0)"
},
"courses": {
"type": "array",
"items": {
"type": "object",
"required": [
"grade",
"credits"
],
"properties": {
"grade": {
"type": "string",
"description": "Letter grade, percentage, or a grade label from the grading system"
},
"weight": {
"enum": [
"regular",
"honors",
"ap",
"ib"
],
"type": "string"
},
"credits": {
"type": "number"
}
}
}
},
"grading_system_id": {
"type": "string",
"description": "grading_systems id whose bands resolve course grades"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| raw_grade* | string | Raw grade label or number (e.g. 'A', '8.5') |
| raw_percent | number | Raw percentage (0-100), used for numeric band matching |
| grading_system_id | string | grading_system_canonical id (resolved to its active version) |
| grading_system_version_id | string | grading_system_versions id |
{
"type": "object",
"required": [
"raw_grade"
],
"properties": {
"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"
},
"grading_system_id": {
"type": "string",
"description": "grading_system_canonical id (resolved to its active version)"
},
"grading_system_version_id": {
"type": "string",
"description": "grading_system_versions id"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| source_grade* | string | Grade label (e.g. 'A', '8.5', 'First Class') in the source system |
| source_mappings | array | Source grade mappings to use directly, instead of the database |
| source_min_pass | number | Source scale pass mark |
| target_mappings | array | Target grade mappings to use directly, instead of the database |
| target_min_pass | number | Target scale pass mark |
| source_max_scale | number | Source scale maximum (e.g. 10 for India 10-point, 4 for US) |
| source_system_id | string | grading_systems id for the source system |
| target_max_scale | number | Target scale maximum |
| target_system_id |
Get the grading systems for a country, with their grade mappings.
| Argument | Type | Description |
|---|---|---|
| country_code* | string | Two-letter country code (e.g. IN, DE, US) |
| include_mappings | boolean | Include grade mappings for each system (default true) |
{
"type": "object",
"required": [
"country_code"
],
"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)"
}
}
}Assemble a country grading guide: scale table with US 4.0 equivalents, conversion tables, FAQs, common mistakes and confidence/coverage stats.
| Argument | Type | Description |
|---|---|---|
| country_code* | string | Two-letter country code (e.g. IN, DE, US) |
{
"type": "object",
"required": [
"country_code"
],
"properties": {
"country_code": {
"type": "string",
"description": "Two-letter country code (e.g. IN, DE, US)"
}
}
}Get the grade-to-GPA mapping bands for one grading system.
| Argument | Type | Description |
|---|---|---|
| grading_system_id* | string | grading_systems id |
{
"type": "object",
"required": [
"grading_system_id"
],
"properties": {
"grading_system_id": {
"type": "string",
"description": "grading_systems id"
}
}
}Get an institution's detail, its country, its grading override and its resolved grading scale.
| Argument | Type | Description |
|---|---|---|
| slug | string | Institution slug (or name, as a fallback) |
| institution_id | string | institutions id |
{
"type": "object",
"required": [],
"properties": {
"slug": {
"type": "string",
"description": "Institution slug (or name, as a fallback)"
},
"institution_id": {
"type": "string",
"description": "institutions id"
}
}
}Convert grade points on any scale to a US GPA, with letter grade and honours classification.
| Argument | Type | Description |
|---|---|---|
| mappings | array | Grade mappings to use directly, instead of the database |
| min_pass | number | Source scale pass mark |
| max_scale | number | Source scale maximum (default 4) |
| grade_points* | number | Grade points on the source scale |
| grading_system_id | string | grading_systems id whose bands set the US equivalent |
{
"type": "object",
"required": [
"grade_points"
],
"properties": {
"mappings": {
"type": "array",
"items": {
"type": "object",
"required": [
"grade",
"points"
],
"properties": {
"grade": {
"type": "string"
},
"points": {
"type": "number"
},
"max_value": {
"type": "number"
},
"min_value": {
"type": "number"
},
"us_equivalent": {
"type": [
"string",
"number"
]
},
"classification": {
"type": "string"
}
}
},
"description": "Grade mappings to use directly, instead of the database"
},
"min_pass": {
"type": "number",
"description": "Source scale pass mark"
},
"max_scale": {
"type": "number",
"description": "Source scale maximum (default 4)"
},
"grade_points": {
"type": "number",
"description": "Grade points on the source scale"
},
"grading_system_id": {
"type": "string",
"description": "grading_systems id whose bands set the US equivalent"
}
}
}Convert a GPA to a percentage (0-100) on its scale.
| Argument | Type | Description |
|---|---|---|
| gpa* | number | GPA value |
| max_scale | number | Scale maximum (default 4) |
{
"type": "object",
"required": [
"gpa"
],
"properties": {
"gpa": {
"type": "number",
"description": "GPA value"
},
"max_scale": {
"type": "number",
"description": "Scale maximum (default 4)"
}
}
}List countries with their default grading scale.
| Argument | Type | Description |
|---|---|---|
| limit | number | Maximum countries to return (default 100, max 500) |
| region | string | Filter by region substring (e.g. Asia, Europe) |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "number",
"description": "Maximum countries to return (default 100, max 500)"
},
"region": {
"type": "string",
"description": "Filter by region substring (e.g. Asia, Europe)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| country_code | string | Two-letter country code (e.g. IN, DE, US) |
| institution_id | string | institutions id |
{
"type": "object",
"required": [],
"properties": {
"country_code": {
"type": "string",
"description": "Two-letter country code (e.g. IN, DE, US)"
},
"institution_id": {
"type": "string",
"description": "institutions id"
}
}
}Search institutions, grading systems and institution candidates by name.
| Argument | Type | Description |
|---|---|---|
| limit | number | Maximum results per source (default 10, max 50) |
| query* | string | Search text (at least 2 characters) |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "number",
"description": "Maximum results per source (default 10, max 50)"
},
"query": {
"type": "string",
"description": "Search text (at least 2 characters)"
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 17, 2026.
No readOnlyHint / destructiveHint annotations, so clients can't tell a read from a write without asking.
Fix: Add annotations to each tool, e.g. { readOnlyHint: true } for tools that only read.
| string |
| grading_systems id for the target system |
{
"type": "object",
"required": [
"source_grade"
],
"properties": {
"source_grade": {
"type": "string",
"description": "Grade label (e.g. 'A', '8.5', 'First Class') in the source system"
},
"source_mappings": {
"type": "array",
"items": {
"type": "object",
"required": [
"grade",
"points"
],
"properties": {
"grade": {
"type": "string"
},
"points": {
"type": "number"
},
"max_value": {
"type": "number"
},
"min_value": {
"type": "number"
},
"us_equivalent": {
"type": [
"string",
"number"
]
},
"classification": {
"type": "string"
}
}
},
"description": "Source grade mappings to use directly, instead of the database"
},
"source_min_pass": {
"type": "number",
"description": "Source scale pass mark"
},
"target_mappings": {
"type": "array",
"items": {
"type": "object",
"required": [
"grade",
"points"
],
"properties": {
"grade": {
"type": "string"
},
"points": {
"type": "number"
},
"max_value": {
"type": "number"
},
"min_value": {
"type": "number"
},
"us_equivalent": {
"type": [
"string",
"number"
]
},
"classification": {
"type": "string"
}
}
},
"description": "Target grade mappings to use directly, instead of the database"
},
"target_min_pass": {
"type": "number",
"description": "Target scale pass mark"
},
"source_max_scale": {
"type": "number",
"description": "Source scale maximum (e.g. 10 for India 10-point, 4 for US)"
},
"source_system_id": {
"type": "string",
"description": "grading_systems id for the source system"
},
"target_max_scale": {
"type": "number",
"description": "Target scale maximum"
},
"target_system_id": {
"type": "string",
"description": "grading_systems id for the target system"
}
}
}