NBMEcalc MCP

Official1 tool

by jiankn · TypeScript

Remote MCP server for deterministic educational practice-assessment score conversions.

io.github.jiankn/nbmecalc — Remote MCP Server

Remote MCP server for deterministic educational practice-assessment score conversions. It provides functionality to convert scores in an educational context using a repeatable, deterministic approach.

🛠️ Key Features

Remote MCP server
Deterministic educational practice-assessment score conversions

🚀 Use Cases

Converting educational practice-assessment scores for consistent results

⚡ Developer Benefits

Predictable, deterministic conversion behavior for score mapping

⚠️ Limitations

Scope described only as educational practice-assessment score conversions

Captured live from the server via tools/list.

convert_practice_score

Convert one supported practice-assessment score into an independent educational estimate. This is not an official conversion or an examination guarantee.

Parameters4

source	string	required
score	number	required
step	string	required
form	integer	optional	Optional NBME form number

Raw schema

{
  "type": "object",
  "properties": {
    "source": {
      "type": "string",
      "enum": [
        "NBME",
        "UWSA_1",
        "UWSA_2",
        "FREE_120",
        "AMBOSS",
        "CMS"
      ]
    },
    "score": {
      "type": "number"
    },
    "step": {
      "type": "string",
      "enum": [
        "STEP_1",
        "STEP_2",
        "STEP_3"
      ]
    },
    "form": {
      "description": "Optional NBME form number",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "source",
    "score",
    "step"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md1 KBView on GitHub

NBMEcalc MCP

A remote Model Context Protocol server exposing deterministic, offline practice-assessment conversions for integrations that complement the USMLE score predictor.

The Streamable HTTP endpoint is /mcp. The server exposes convert_practice_score and returns the estimate together with the v1.1 algorithm identifier and a required disclaimer.

It has no database, account system, analytics call, or learner-data storage. Mappings are independent model assumptions, not official conversions or examination guarantees. Do not use outputs for clinical decisions.

shell

npm install
npm test
npm run check
npm run deploy:dry

Apache-2.0 licensed.

Install

Tools (1)

convert_practice_score

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://nbmecalc-mcp.chenxuanshimo.workers.dev/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "nbmecalc": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://nbmecalc-mcp.chenxuanshimo.workers.dev/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.jiankn/nbmecalc — Remote MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

convert_practice_score

NBMEcalc MCP

Install

Remote endpoint

Related servers