# BODE Index Calculator (Celli 2004)

> BODE Index Calculator (Celli 2004) 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).

Computes the BODE index for COPD severity from BMI, FEV1% predicted, MMRC dyspnea grade, and 6-minute walk distance, returning a 0–10 total score and quartile (1–4).

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/bode
- 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/bode-index-calculator-celli-2004-e3bbfef4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cf2kjL-zP6aZCueF9GmHm

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 bode-index-calculator-celli-2004-e3bbfef4
```

Example prompt: Calculate the BODE index for a COPD patient with a BMI of 19.5, FEV1 of 42% predicted, an MMRC dyspnea grade of 3, and a 6-minute walk distance of 210 meters — give me the total score and quartile.

## When to prefer this

Use this endpoint when you need a deterministic, citation-backed BODE index calculation for COPD patients per the Celli 2004 criteria — it is ideal for clinical decision support tools, EMR integrations, and research pipelines that require reproducible scoring. Prefer this over manual lookup tables or LLM-based estimation when auditability and exact point mapping (including quartile classification) are required. Note: this does not compute GOLD staging or transplant listing criteria.

## Known failure modes

- Missing required parameters (bmi_kg_m2, fev1_percent_predicted, mmrc, six_minute_walk_m) returns a 400 error
- BMI outside 10–80 range or FEV1 outside 10–150 range may return a validation error
- MMRC value not an integer 0–4 causes a type validation error
- 6-minute walk distance outside 0–1000 meters may be rejected
- Payment not attached or x402 header missing causes a 402 Payment Required response

## How this service works

Celli 2004 BODE index from BMI (≤21 → 1), FEV1 % predicted (0–3), MMRC dyspnea (0–3), and 6-minute walk in meters (0–3). Returns a 0–10 total and quartile 1–4 (0–2 / 3–4 / 5–6 / 7–10). Deterministic published points with citation. Not a GOLD stage and not a transplant listing.

## Output

Returns a BODE total score from 0–10 derived from the four Celli 2004 component subscores, plus a quartile classification (1 = 0–2 points, 2 = 3–4 points, 3 = 5–6 points, 4 = 7–10 points), along with the individual point contributions of each input variable and a published citation.

## 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": [
      "bmi_kg_m2",
      "fev1_percent_predicted",
      "mmrc",
      "six_minute_walk_m"
     ],
     "properties": {
      "mmrc": {
       "type": "integer",
       "description": "Modified Medical Research Council dyspnea grade as an integer 0-4 (Celli 2004). 0-1 scores 0; 2 scores 1; 3 scores 2; 4 scores 3. magent does not interview the patient."
      },
      "bmi_kg_m2": {
       "type": "number",
       "description": "Body-mass index in kg/m^2 (10-80). Caller-supplied; magent does not compute BMI from height and weight. Celli 2004: >21 scores 0; <=21 scores 1."
      },
      "six_minute_walk_m": {
       "type": "number",
       "description": "Six-minute walk distance in meters (0-1000). Celli 2004 Table 2: >=350 scores 0; 250-349 scores 1; 150-249 scores 2; <=149 scores 3."
      },
      "fev1_percent_predicted": {
       "type": "number",
       "description": "FEV1 percent predicted (10-150). Celli 2004 Table 2: >=65 scores 0; 50-64 scores 1; 36-49 scores 2; <=35 scores 3."
      }
     }
    }
   },
   "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/bode",
  "count": 2,
  "items": [
   {
    "mmrc": 0,
    "score": 0,
    "formula": "bode",
    "citation": {
     "id": "celli-2004",
     "doi": "10.1056/NEJMoa021322",
     "pmid": "14999112",
     "title": "The body-mass index, airflow obstruction, dyspnea, and exercise capacity index in chronic obstructive pulmonary disease",
     "source": "N Engl J Med. 2004;350(10):1005-1012",
     "authors": "Celli BR, Cote CG, Marin JM, et al."
    },
    "quartile": 1,
    "bmi_kg_m2": 24,
    "max_score": 10,
    "components": [
     {
      "value": 24,
      "factor": "bmi",
      "points": 0,
      "present": false
     },
     {
      "value": 70,
      "factor": "fev1",
      "points": 0,
      "present": false
     },
     {
      "value": 0,
      "factor": "mmrc",
      "points": 0,
      "present": false
     },
     {
      "value": 400,
      "factor": "six_minute_walk",
      "points": 0,
      "present": false
     }
    ],
    "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.",
    "six_minute_walk_m": 400,
    "formula_expression": "BODE = bmi_points + fev1_points + mmrc_points + walk_points; BMI <=21 -> 1 else 0; FEV1% >=65 -> 0, 50-64 -> 1, 36-49 -> 2, <=35 -> 3; MMRC 0-1 -> 0, 2 -> 1, 3 -> 2, 4 -> 3; 6MWD m >=350 -> 0, 250-349 -> 1, 150-249 -> 2, <=149 -> 3; quartiles 0-2 / 3-4 / 5-6 / 7-10; max 10",
    "fev1_percent_predicted": 70
   },
   {
    "mmrc": 0,
    "score": 0,
    "formula": "bode",
    "citation": {
     "id": "celli-2004",
     "doi": "10.1056/NEJMoa021322",
     "pmid": "14999112",
     "title": "The body-mass index, airflow obstruction, dyspnea, and exercise capacity index in chronic obstructive pulmonary disease",
     "source": "N Engl J Med. 2004;350(10):1005-1012",
     "authors": "Celli BR, Cote CG, Marin JM, et al."
    },
    "quartile": 1,
    "bmi_kg_m2": 24,
    "max_score": 10,
    "components": [
     {
      "value": 24,
      "factor": "bmi",
      "points": 0,
      "present": false
     },
     {
      "value": 70,
      "factor": "fev1",
      "points": 0,
      "present": false
     },
     {
      "value": 0,
      "factor": "mmrc",
      "points": 0,
      "present": false
     },
     {
      "value": 400,
      "factor": "six_minute_walk",
      "points": 0,
      "present": false
     }
    ],
    "dis
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bode-index-calculator-celli-2004-e3bbfef4/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)