# Modified Rankin Scale (mRS) Grade Lookup

> Modified Rankin Scale (mRS) Grade Lookup is a paid API for AI agents from api.magentlab.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns the published van Swieten 1988 wording for a caller-supplied Modified Rankin Scale grade 0–5

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/modified_rankin
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/modified-rankin-scale-mrs-grade-lookup-7e5258a9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Uh1r_tqp7RCUFhoj3ixxF

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability modified-rankin-scale-mrs-grade-lookup-7e5258a9
```

Example prompt: What is the official published description for Modified Rankin Scale grade 3 according to van Swieten 1988?

## When to prefer this

Use this endpoint when you need the canonical published wording of a van Swieten 1988 Modified Rankin Scale grade (0–5) — for example when documenting clinical scores in structured reports, displaying human-readable descriptions alongside numeric mRS values, or verifying that the correct official description is paired with a score. Prefer this over manually hardcoding grade descriptions to ensure accuracy and traceability to the published source. Note this is the six-grade 1988 scale (0–5) and does not include a grade 6 (dead) as found in some later variants.

## Known failure modes

- Invalid mrs value (not an integer 0–5) results in an error response
- Missing required query parameter mrs returns a validation error
- Grades outside 0–5 (e.g. grade 6 dead, used in other mRS variants) are not supported by this 1988 scale endpoint

## How this service works

Modified Rankin handicap grade 0-5 (van Swieten 1988) as assigned by the caller. Returns the published wording (no symptoms at all through severe disability: bedridden, incontinent, constant nursing). This 1988 scale has six grades 0-5 and does not include a dead grade. Not a diagnosis or discharge/disability-benefit protocol; magent does not interview the patient.

## Output

The endpoint returns the published van Swieten 1988 wording for the requested Modified Rankin Scale grade (e.g. grade 0: 'no symptoms at all'; grade 5: 'severe disability: bedridden, incontinent, constant nursing'). This is a reference text lookup; the endpoint does not perform clinical assessment or generate diagnoses.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "mrs"
     ],
     "properties": {
      "mrs": {
       "type": "integer",
       "description": "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."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "path": "/api/calc/modified_rankin",
  "count": 2,
  "items": [
   {
    "mrs": 0,
    "grade": "No symptoms at all",
    "score": 0,
    "formula": "modified_rankin",
    "citation": {
     "id": "van-swieten-1988",
     "doi": "10.1161/01.STR.19.5.604",
     "pmid": "3363593",
     "title": "Interobserver agreement for the assessment of handicap in stroke patients",
     "source": "Stroke. 1988;19(5):604-607",
     "authors": "van Swieten JC, Koudstaal PJ, Visser MC, Schouten HJ, van Gijn J"
    },
    "max_score": 5,
    "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.",
    "formula_expression": "modified Rankin 0-5 as assigned by the caller; van Swieten 1988 six grades (no dead grade)"
   },
   {
    "mrs": 0,
    "grade": "No symptoms at all",
    "score": 0,
    "formula": "modified_rankin",
    "citation": {
     "id": "van-swieten-1988",
     "doi": "10.1161/01.STR.19.5.604",
     "pmid": "3363593",
     "title": "Interobserver agreement for the assessment of handicap in stroke patients",
     "source": "Stroke. 1988;19(5):604-607",
     "authors": "van Swieten JC, Koudstaal PJ, Visser MC, Schouten HJ, van Gijn J"
    },
    "max_score": 5,
    "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.",
    "formula_expression": "modified Rankin 0-5 as assigned by the caller; van Swieten 1988 six grades (no dead grade)"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/modified-rankin-scale-mrs-grade-lookup-7e5258a9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.magentlab.com](https://www.zero.xyz/host/api.magentlab.com/llms.txt)
