# SMART-COP Score for Community-Acquired Pneumonia (Charles 2008) > SMART-COP Score for Community-Acquired Pneumonia (Charles 2008) 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). Calculates the SMART-COP score to predict need for intensive respiratory or vasopressor support in community-acquired pneumonia patients ## Facts - Endpoint: GET https://api.magentlab.com/api/calc/smart_cop - 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/smart-cop-score-for-community-acquired-pneumonia-charles-2008-52971e6a - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VdunjAyZoA5GIAfw5lsYA 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 smart-cop-score-for-community-acquired-pneumonia-charles-2008-52971e6a ``` Example prompt: Calculate the SMART-COP score for a 67-year-old patient with community-acquired pneumonia: systolic BP 88 mmHg, multilobar infiltrates on CXR, albumin 2.8 g/dL, respiratory rate 32 breaths/min, heart rate 130 bpm, new confusion present, SpO2 88%, and arterial pH 7.30. ## When to prefer this Use this endpoint when you need to predict the risk of needing intensive respiratory or vasopressor support (IRVS) in a community-acquired pneumonia patient according to the validated Charles 2008 SMART-COP criteria. Prefer this over PSI/PORT or CURB-65 when the specific clinical question is ICU-level support need rather than 30-day mortality or site-of-care triage. Note this is not a site-of-care protocol — it predicts IRVS need, not admission vs. discharge. ## Known failure modes - Missing required parameters (age, systolic_mm_hg, multilobar_cxr, respiratory_rate, heart_rate_bpm, confusion) returns validation error - Providing more than one oxygenation input (pao2_mm_hg, spo2_percent, pf_ratio) simultaneously returns an error - Providing both albumin_g_dl and albumin_g_l simultaneously returns an error - Values outside allowed ranges (e.g. age outside 18–120, pH outside 6.80–7.80) return validation error - Omitting arterial pH is valid and scores 0 per Charles 2008 convention - Payment failure (x402) returns 402 with payment details required ## How this service works Charles 2008 SMART-COP for intensive respiratory or vasopressor support in community-acquired pneumonia: SBP <90 (2), multilobar CXR (1), albumin <3.5 g/dL (1), age-adjusted RR (1), HR >=125 (1), new confusion (1), age-adjusted low oxygen (2), arterial pH <7.35 (2; omitted pH scores 0). Max 11. IRVS 0-2 low, 3-4 moderate, 5-6 high, >=7 very high. Not a site-of-care protocol. Albumin g/dL or g/L. Exactly one of PaO2, SpO2, or P/F. ## Output Returns the total SMART-COP score (0–11), the IRVS risk category (low: 0–2, moderate: 3–4, high: 5–6, very high: ≥7), and the individual point contributions from each clinical parameter (SBP, multilobar CXR, albumin, age-adjusted respiratory rate, heart rate, confusion, age-adjusted oxygenation, and arterial pH). ## 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": [ "age", "systolic_mm_hg", "multilobar_cxr", "respiratory_rate", "heart_rate_bpm", "confusion" ], "properties": { "age": { "type": "integer", "description": "Age in years (18-120). Age ≤50 uses RR ≥25, PaO2 <70, SpO2 ≤93%, P/F <333. Age >50 uses RR ≥30, PaO2 <60, SpO2 ≤90%, P/F <250." }, "pf_ratio": { "type": "number", "description": "PaO2/FiO2 ratio (20-800). Provide exactly one of pao2_mm_hg, spo2_percent, or pf_ratio. Age ≤50: <333 scores 2. Age >50: <250 scores 2." }, "confusion": { "type": "boolean", "description": "New or acute confusion as assigned by the caller (Charles 2008 C). true or false. 1 point if true. magent does not assess mental status." }, "pao2_mm_hg": { "type": "number", "description": "Arterial PaO2 in mm Hg (20-700). Provide exactly one of pao2_mm_hg, spo2_percent, or pf_ratio. Age ≤50: <70 scores 2. Age >50: <60 scores 2." }, "albumin_g_l": { "type": "number", "description": "Albumin in g/L (10-60). Converted as g/dL = g/L / 10. Provide this or albumin_g_dl, not both. Scores 1 when <35 g/L." }, "arterial_ph": { "type": "number", "description": "Arterial pH (6.80-7.80). Optional. Scores 2 when <7.35; 7.35 does not score. Omitted pH scores 0 (Charles 2008 missing-pH assumption)." }, "albumin_g_dl": { "type": "number", "description": "Albumin in g/dL (1-6). Provide this or albumin_g_l, not both. Scores 1 when <3.5; 3.5 does not score (Charles 2008 A)." }, "spo2_percent": { "type": "number", "description": "Oxygen saturation percent (50-100). Provide exactly one of pao2_mm_hg, spo2_percent, or pf_ratio. Age ≤50: ≤93 scores 2. Age >50: ≤90 scores 2." }, "heart_rate_bpm": { "type": "integer", "description": … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "path": "/api/calc/smart_cop", "count": 2, "items": [ { "score": 0, "formula": "smart_cop", "citation": { "id": "charles-2008", "doi": "10.1086/589754", "pmid": "18558884", "title": "SMART-COP: a tool for predicting the need for intensive respiratory or vasopressor support in community-acquired pneumonia", "source": "Clin Infect Dis. 2008;47(3):375-384", "authors": "Charles PGP, Wolfe R, Whitby M, et al." }, "age_years": 40, "irvs_risk": "low", "max_score": 11, "components": [ { "value": 120, "factor": "systolic_lt_90", "points": 0, "present": false }, { "factor": "multilobar_cxr", "points": 0, "present": false }, { "value": 4, "factor": "albumin_lt_3_5", "points": 0, "present": false }, { "value": 16, "factor": "respiratory_rate", "points": 0, "present": false }, { "value": 80, "factor": "heart_rate_ge_125", "points": 0, "present": false }, { "factor": "confusion", "points": 0, "present": false }, { "input": "spo2_percent", "value": 98, "factor": "oxygen_low", "points": 0, "present": false }, { "value": 7.4, "factor": "arterial_ph_lt_7_35", "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.", "arterial_ph": 7.4, "albumin_g_dl": 4, "spo2_percent": 98, "heart_rate_bpm": 80, "systolic_mm_hg": 120, "respiratory_rate": 16, "formula_expression": "SMART-COP (Charles 2008) = SBP<90 (2) + multilobar_cxr (1) + albumin<3.5 g/dL (1) + age-adjusted RR (1; age<=50 RR>=25, age>50 RR>=30) + HR>=125 (1) + confusion (1) + age-adjusted low oxygen (2; age<=50 PaO2<70 or SpO2<=93 or P/F<333; age>50 PaO2<60 or SpO2<=90 or P/F<250) + arterial_pH<7.35 (2; omitted pH scores 0); max 11; IRVS 0-2 low, 3-4 moderate, 5-6 high, >=7 very high" }, { "score": 0, "formula": "smart_cop", "citation": { "id": "charles-2008", "doi": "10.1086/589754", "pmid": "18558884", "title": "SMART-COP: a tool for predicting the need for intensive respiratory or vasopressor support in comm … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/smart-cop-score-for-community-acquired-pneumonia-charles-2008-52971e6a/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)