# McDonald 2017 MS Diagnostic Criteria Calculator

> McDonald 2017 MS Diagnostic Criteria Calculator 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).

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.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/mcdonald_2017
- 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/mcdonald-2017-ms-diagnostic-criteria-calculator-f6a33e45
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_On1cr_qUP8URvccrBfbDG

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 mcdonald-2017-ms-diagnostic-criteria-calculator-f6a33e45
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## 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": [
      "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_explanatio
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mcdonald-2017-ms-diagnostic-criteria-calculator-f6a33e45/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)