{"uid":"cap_On1cr_qUP8URvccrBfbDG","slug":"mcdonald-2017-ms-diagnostic-criteria-calculator-f6a33e45","name":"McDonald 2017 MS Diagnostic Criteria Calculator","description":"2017 McDonald typical CIS (Thompson 2018). mcdonald_ms iff typical_cis and no_better_explanation and: ≥2 attacks with ≥2 lesions; or ≥2 attacks with one lesion plus DIS; or CIS with ≥2 lesions plus MRI DIT or CSF-specific OCB; or CIS with one lesion plus DIS and MRI DIT or CSF-specific OCB. 2017: OCB may substitute for DIT when DIS is met. Symptomatic and cortical lesions count. Not PPMS. Not 2010 McDonald. magent does not read MRI or CSF. Not a diagnosis. Not a medical device.","url":"https://api.magentlab.com/api/calc/mcdonald_2017","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":["typical_cis","no_better_explanation","two_or_more_attacks","two_or_more_lesions","dis","dit_mri","csf_specific_ocb"],"properties":{"dis":{"type":"boolean","description":"Dissemination in space as assigned by the caller (2017: ≥1 T2-hyperintense lesion characteristic of MS in ≥2 of 4 areas: periventricular, cortical or juxtacortical, infratentorial, spinal cord; symptomatic lesions count; cortical lesions count). true or false. magent does not read MRI."},"dit_mri":{"type":"boolean","description":"MRI dissemination in time as assigned by the caller (simultaneous Gd-enhancing and non-enhancing lesions, or a new T2 or Gd-enhancing lesion on follow-up vs baseline). true or false. magent does not read MRI."},"typical_cis":{"type":"boolean","description":"Typical clinically isolated syndrome as assigned by the caller (Thompson 2018 panel 1). If false, mcdonald_ms is false; this tool does not diagnose MS from atypical presentations. true or false. magent does not examine the patient."},"csf_specific_ocb":{"type":"boolean","description":"CSF-specific oligoclonal bands as assigned by the caller (2017 DIT substitute when DIS is fulfilled). true or false. magent does not assay CSF."},"two_or_more_attacks":{"type":"boolean","description":"≥2 clinical attacks as assigned by the caller. true means two or more attacks; false means this is the first/CIS attack. true or false. magent does not date attacks."},"two_or_more_lesions":{"type":"boolean","description":"Objective clinical evidence of ≥2 lesions as assigned by the caller. true means ≥2 lesions; false means 1 lesion. true or false. magent does not examine the patient."},"no_better_explanation":{"type":"boolean","description":"No better explanation for the presentation as assigned by the caller (Thompson 2018). If false, mcdonald_ms is false. Remain vigilant for NMOSD. true or false. magent does not assign a better explanation."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_C97vSJqBJUL9gd2Im0lid","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":"Evaluates whether a patient's clinical data meets the 2017 McDonald criteria for a diagnosis of multiple sclerosis (MS) based on caller-assigned clinical and paraclinical inputs.","exampleAgentPrompt":"Check whether this MS patient meets the 2017 McDonald criteria: they have a typical CIS, no better explanation, two or more attacks, two or more lesions, DIS is true, MRI DIT is false, and CSF-specific OCB is true.","exampleUseCases":[{"title":"CIS with OCB substituting for DIT","prompt":"My patient has a typical CIS, no better explanation found, this is their first attack, one lesion, DIS is met, MRI DIT is not available, but CSF shows specific oligoclonal bands — do they meet the 2017 McDonald MS criteria?"},{"title":"Two attacks two lesions MS check","prompt":"Does a patient with a typical CIS, no better alternative explanation, two or more attacks, two or more clinically evident lesions, and DIS confirmed meet McDonald 2017 MS diagnostic criteria? DIT and OCB are both false."},{"title":"CIS with DIS and MRI DIT","prompt":"My neurology patient has a typical CIS, no other explanation, this is their first attack, one lesion found, DIS is met, MRI shows dissemination in time, and CSF OCB is negative — does the 2017 McDonald formula say they have MS?"}],"resultDescription":"Returns a boolean mcdonald_ms value: true if the caller-supplied clinical flags satisfy the 2017 McDonald MS diagnostic criteria, false otherwise. Does not read MRI, examine patients, assay CSF, or constitute a medical diagnosis.","failureModes":["Missing required query parameters (typical_cis, no_better_explanation, two_or_more_attacks, two_or_more_lesions, dis, dit_mri, csf_specific_ocb) returns a 400 error","Non-boolean values for boolean fields cause validation failure","If typical_cis or no_better_explanation is false, mcdonald_ms will always return false regardless of other inputs","Does not handle PPMS — returns false for primary progressive presentations","Network or payment failure returns non-200 status"],"whenToPreferThis":"Use this endpoint when you need a fast, reproducible computation of whether caller-assigned clinical flags satisfy the 2017 McDonald MS criteria, particularly when OCB substitution for DIT is relevant. Prefer it over manual criteria lookup when building clinical decision support pipelines, automating neurology workflows, or auditing whether structured EHR data meets MS diagnostic thresholds. Not appropriate for raw MRI or CSF interpretation, PPMS evaluation, or situations requiring a licensed clinician judgment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:20:31.147Z","isFirstParty":false}