{"uid":"cap_Uh1r_tqp7RCUFhoj3ixxF","slug":"modified-rankin-scale-mrs-grade-lookup-7e5258a9","name":"Modified Rankin Scale (mRS) Grade Lookup","description":"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.","url":"https://api.magentlab.com/api/calc/modified_rankin","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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)"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kPbfnRgLld6zghwi815eZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the published van Swieten 1988 wording for a caller-supplied Modified Rankin Scale grade 0–5","exampleAgentPrompt":"What is the official published description for Modified Rankin Scale grade 3 according to van Swieten 1988?","exampleUseCases":[{"title":"Stroke outcome documentation workflow","prompt":"My stroke patient has been assessed at mRS grade 2 — can you pull the official van Swieten 1988 wording for that grade so I can include it verbatim in the discharge summary?"},{"title":"Clinical trial reporting display","prompt":"We're building a dashboard that shows mRS grades next to patient records. Can you get me the standard published text for mRS grade 4 so we can display it alongside the numeric score?"},{"title":"Patient-facing report explanation","prompt":"A patient's mRS score was recorded as 1 after their stroke follow-up. What is the official description for that grade from the Modified Rankin Scale so I can include it in their report?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:46:43.247Z","isFirstParty":false}