Modified Rankin scale

Modified Rankin

Return the van Swieten 1988 modified Rankin handicap grade 0-5 from a caller-assigned integer, with the published grade wording.

LIVE $0.005 USDC GET /api/calc/modified_rankin

Markdown: /docs/modified-rankin.md · Canonical: https://magentlab.com/docs/modified-rankin

Not a medical device. Not a diagnosis, dose, or listing recommendation.

What it computes

Return the van Swieten 1988 modified Rankin handicap grade 0-5 from a caller-assigned integer, with the published grade wording.

When to use

When an agent needs the 1988 modified Rankin handicap grade 0-5 and must not invent grade 6 (dead), Rankin 1957 five-grade wording, or a discharge or disability-benefit protocol.

When not to use

Not a medical device and not a diagnosis. Not a discharge or disability-benefit protocol. magent does not interview the patient.
van Swieten 1988 is grades 0-5 only and does not include a dead grade. Grade 6 (dead) is a later addition and is not returned.
The caller assigns mrs 0-5. magent does not examine the patient or apply a structured interview.

Formula

modified Rankin 0-5 as assigned by the caller; van Swieten 1988 six grades (no dead grade)

Citation

Title: Interobserver agreement for the assessment of handicap in stroke patients
Authors: van Swieten JC, Koudstaal PJ, Visser MC, Schouten HJ, van Gijn J
Source: Stroke. 1988;19(5):604-607
DOI: 10.1161/01.STR.19.5.604

Worked example

Grade 0 no symptoms

Given: mrs=0

mrs 0 → no symptoms at all; score 0; max 5

Also searched as

mRS
modified Rankin scale
modified Rankin score
Rankin handicap grade
van Swieten Rankin
stroke disability grade
mRS 0-5

Try

Opens the live endpoint. Unpaid browser requests show the paywall; agents should send Accept: application/json.

/api/calc/modified_rankin?mrs=0

Full URL: https://api.magentlab.com/api/calc/modified_rankin?mrs=0

Call

Expect HTTP 402 until you retry with PAYMENT-SIGNATURE. Incomplete query params return HTTP 400 before any quote or charge.

curl -i -H "Accept: application/json" "https://api.magentlab.com/api/calc/modified_rankin?mrs=0"

Parameters

Name	Type	Required	Description
`mrs`	integer	required	van Swieten 1988 modified Rankin handicap grade 0-5 as assigned by the caller (0 no symptoms at all; 1 no significant disability despite symptoms; 2 slight disability; 3 moderate disability, walks unaided; 4 moderately severe, unable to walk unaided; 5 severe, bedridden, incontinent, constant nursing). magent does not interview the patient.

Bulk (POST)

POST the same path with a JSON items array. The first item is the GET unit; each additional item is $0.002. Invalid items return HTTP 400 before settlement.

POST /api/calc/modified_rankin Max 25 unit_amount + extra_item_amount * (n - 1) extra $0.002 PREVIEW

1 to 25 items. Each item uses the same keys as the GET query parameters.
POST of 1 item costs the same as GET. Lists longer than 25: chunk into multiple POSTs. Extra items still execute; do not pad dummy rows.
The first invalid item fails the whole request (index in the 400 JSON). You are not charged.
HTTP 200 is {count, path, items}. Each items[i] is the GET 200 body for that row.
Catalog misses (empty matches, found=false) stay paid 200s inside that slot.
x402 resource URL is this path plus n and body_sha256. Browsers that prefer text/html get the same paywall as GET; Pay retries POST with the same items.

Example request (fixture)

{
  "items": [
    {
      "mrs": "0"
    },
    {
      "mrs": "0"
    }
  ]
}

Open bulk paywall →

Opens a two-item fixture on the API host. Unpaid browsers get the same MetaMask paywall as GET; Pay retries POST with those items.

Example 200 (fixture)

{
  "count": 2,
  "path": "/api/calc/modified_rankin",
  "items": [
    {
      "components": [
        {
          "factor": "mrs",
          "points": 0,
          "present": true
        }
      ],
      "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
      "citation": {
        "authors": "van Swieten JC, Koudstaal PJ, Visser MC, Schouten HJ, van Gijn J",
        "doi": "10.1161/01.STR.19.5.604",
        "id": "van-swieten-1988",
        "pmid": "3363593",
        "source": "Stroke. 1988;19(5):604-607",
        "title": "Interobserver agreement for the assessment of handicap in stroke patients"
      },
      "formula": "modified_rankin",
      "formula_expression": "modified Rankin 0-5 as assigned by the caller; van Swieten 1988 six grades (no dead grade)",
      "max_score": 5,
      "score": 0,
      "grade": "No symptoms at all",
      "mrs": 0
    },
    {
      "components": [
        {
          "factor": "mrs",
          "points": 0,
          "present": true
        }
      ],
      "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
      "citation": {
        "authors": "van Swieten JC, Koudstaal PJ, Visser MC, Schouten HJ, van Gijn J",
        "doi": "10.1161/01.STR.19.5.604",
        "id": "van-swieten-1988",
        "pmid": "3363593",
        "source": "Stroke. 1988;19(5):604-607",
        "title": "Interobserver agreement for the assessment of handicap in stroke patients"
      },
      "formula": "modified_rankin",
      "formula_expression": "modified Rankin 0-5 as assigned by the caller; van Swieten 1988 six grades (no dead grade)",
      "max_score": 5,
      "score": 0,
      "grade": "No symptoms at all",
      "mrs": 0
    }
  ]
}

Response

Field	Type	Description
`formula`	string	modified_rankin
`formula_expression`	string	Published grade rule
`mrs`	integer	Caller-assigned modified Rankin grade 0-5
`score`	integer	Same as mrs
`max_score`	integer	5
`grade`	string	van Swieten 1988 wording for that grade
`components`	array	mrs component
`citation`	object	van Swieten 1988
`disclaimer`	string	Not a medical device

Example JSON

Machine form of the same example. Frozen fixture. Not a live lookup.

{
  "components": [
    {
      "factor": "mrs",
      "points": 0,
      "present": true
    }
  ],
  "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
  "citation": {
    "authors": "van Swieten JC, Koudstaal PJ, Visser MC, Schouten HJ, van Gijn J",
    "doi": "10.1161/01.STR.19.5.604",
    "id": "van-swieten-1988",
    "pmid": "3363593",
    "source": "Stroke. 1988;19(5):604-607",
    "title": "Interobserver agreement for the assessment of handicap in stroke patients"
  },
  "formula": "modified_rankin",
  "formula_expression": "modified Rankin 0-5 as assigned by the caller; van Swieten 1988 six grades (no dead grade)",
  "max_score": 5,
  "score": 0,
  "grade": "No symptoms at all",
  "mrs": 0
}

Client errors (HTTP 400)

Invalid params return 400 without charge. Shared HTTP 402 and 503 meanings: Payments.

HTTP	Code	When
400	`invalid_mrs`	mrs must be an integer from 0 to 5 (van Swieten 1988 grades). Returned before settlement; you are not charged.
400	`invalid_items`	POST body must be a JSON object with only an items array Returned before settlement; you are not charged.
400	`invalid_item_count`	items must be an array of 1 to 25 objects Returned before settlement; you are not charged.
400	`invalid_item`	each items entry must be a JSON object Returned before settlement; you are not charged.

Related tools

Glasgow Coma Scale — Compute the Glasgow Coma Scale as the sum of caller-assigned eye, verbal, and motor integers. The 1974 or 1976 edition is required.
ABCD2 score — Compute the ABCD2 score as age, blood pressure, caller-assigned clinical features, symptom duration, and diabetes.
FUNC score — Compute the Rost 2008 FUNC score from caller-assigned ICH volume, age, location, GCS, and pre-ICH cognitive impairment.

Payment

Unpaid requests return HTTP 402 even if query parameters or POST items are missing or invalid, so CDP and agents can index the path. After a PAYMENT-SIGNATURE, invalid params return HTTP 400 JSON before settlement. magent does not charge. Fix the params, then request a new 402 quote for that complete URL. Catalog misses (empty matches, found=false) are valid paid 200s. Unpaid valid requests return HTTP 402 with a base64 PAYMENT-REQUIRED header. HTTP 503 is not a new quote: retry the same PAYMENT-SIGNATURE. Full handshake and shared payment errors: Payments. Stdio MCP: /docs/mcp.

Guarantees

HTTP 402 is unpaid, including a missing query. After PAYMENT-SIGNATURE, invalid parameters return HTTP 400 before settlement. You are not charged.
exact: settlement finishes before the tool (paymentFlow upfront). batch-settlement: verify/deposit before the tool; chargedCumulativeAmount commits after HTTP 2xx. Uncertain or failed settlement fails closed (HTTP 503). Retry the same PAYMENT-SIGNATURE.
HTTP 402 is unpaid only. Do not sign a second authorization because of a 503.
Execution is timeout-bounded and concurrency-capped.
Calculator inputs are stored encrypted for allowlisted operators (Magent Console). They are not in public logs, SSH lookups, catalog, or rollups. Request logs store path without query.