# SOFA Score Calculator (Vincent 1996) > SOFA Score Calculator (Vincent 1996) is a paid API for AI agents from api.magentlab.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-12). Computes the SOFA (Sepsis-related Organ Failure Assessment) score across six organ systems using PaO2/FiO2, platelets, bilirubin, MAP/vasopressors, GCS, and creatinine or urine output. ## Facts - Endpoint: GET https://api.magentlab.com/api/calc/sofa?utm_source=zero.xyz - Price: $0.005/call - Payment: x402 - Status: unknown - Last checked: 2026-10-12 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/sofa-score-calculator-vincent-1996-1d89f560 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WjbNBQCZ6dKTz1OkEwbKA 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 sofa-score-calculator-vincent-1996-1d89f560 ``` Example prompt: Calculate the SOFA score for my ICU patient: PaO2 is 85 mm Hg, FiO2 is 0.5, the patient is ventilated, platelets are 90 (10^9/L), bilirubin is 2.5 mg/dL, MAP is 65 mm Hg, dopamine at 8 mcg/kg/min, GCS is 11, and creatinine is 2.1 mg/dL. ## When to prefer this Use this endpoint when you need a deterministic, citation-backed SOFA score per the original Vincent 1996 methodology for ICU or critical care clinical decision support, documentation, or research. Prefer this over manual computation or generic LLM estimation when accuracy, reproducibility, and auditability matter. This is not a Sepsis-3 qSOFA calculator — use it specifically when the full six-organ SOFA with adrenergic dosing bands is required. ## Known failure modes - Missing required parameters (pao2_mm_hg, fio2, ventilated, platelets, map_mm_hg, gcs) returns a validation error - Out-of-range values (e.g. FiO2 outside 0.21–1.0, GCS outside 3–15) may be rejected or produce undefined results - Neither bilirubin nor creatinine/urine output provided may return an incomplete or error response - PaO2/FiO2 <200 without ventilation=true is capped at respiratory subscore 2 by design, not an error - Vasopressor doses with incorrect units (e.g. providing mg instead of mcg/kg/min) will silently produce wrong subscores ## How this service works Deterministic published-formula arithmetic plus ICD-10-CM, RxNorm, and LOINC. Pay in USDC on Base via x402. ## Output Returns the total SOFA score (0–24) and individual subscores for each of the six organ systems: respiration (PaO2/FiO2 ± ventilation), coagulation (platelets), liver (bilirubin), cardiovascular (MAP and adrenergic agents), neurological (GCS), and renal (creatinine or urine output), along with the Vincent 1996 citation. This is a deterministic rule-based calculation, not a Sepsis-3 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": [ "pao2_mm_hg", "fio2", "ventilated", "platelets_10e9_l", "map_mm_hg", "gcs" ], "properties": { "gcs": { "type": "integer", "description": "Glasgow Coma Scale total as assigned by the caller (integer 3-15). 15 scores 0; 13-14 scores 1; 10-12 scores 2; 6-9 scores 3; <6 scores 4." }, "fio2": { "type": "number", "description": "Inspired oxygen as a fraction (0.21-1.0), not a percent." }, "map_mm_hg": { "type": "number", "description": "Mean arterial pressure in mm Hg (30-180). MAP <70 scores 1 unless a higher cardiovascular band applies." }, "dobutamine": { "type": "boolean", "description": "Any dobutamine. true or false when provided; absent is false. true scores cardiovascular 2 unless a higher band applies." }, "pao2_mm_hg": { "type": "number", "description": "Arterial PaO2 in mm Hg (20-700). Respiration uses PaO2/FiO2: ≥400 scores 0; <400 scores 1; <300 scores 2; <200 with ventilation scores 3; <100 with ventilation scores 4." }, "ventilated": { "type": "boolean", "description": "Respiratory support (Vincent 1996). true or false. Scores 3 and 4 require ventilation; unventilated PaO2/FiO2 <200 is capped at 2." }, "bilirubin_mg_dl": { "type": "number", "description": "Total bilirubin in mg/dL (0.1-40). Provide this or bilirubin_umol_l. <1.2 scores 0; 1.2-1.9 scores 1; 2.0-5.9 scores 2; 6.0-11.9 scores 3; >12.0 scores 4." }, "bilirubin_umol_l": { "type": "number", "description": "Total bilirubin in µmol/L. Converted as mg/dL = µmol/L / 17.1." }, "creatinine_mg_dl": { "type": "number", "description": "Creatinine in mg/dL (0.1-20). Provide this, creatinine_umol_l, or urine_output_ml_day. <1.2 scores 0; 1.2-1.9 scores 1; 2.0-3.4 sc … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "path": "/api/calc/sofa", "count": 2, "items": [ { "score": 0, "formula": "sofa", "citation": { "id": "vincent-1996", "doi": "10.1007/BF01709751", "title": "The SOFA (Sepsis-related Organ Failure Assessment) score to describe organ dysfunction/failure", "source": "Intensive Care Med. 1996;22(7):707-710", "authors": "Vincent JL, Moreno R, Takala J, Willatts S, De Mendonça A, Bruining H, Reinhart CK, Suter PM, Thijs LG" }, "max_score": 24, "components": [ { "value": 457.1428571428572, "factor": "respiration", "points": 0, "present": false }, { "value": 200, "factor": "coagulation", "points": 0, "present": false }, { "value": 0.8, "factor": "liver", "points": 0, "present": false }, { "value": 80, "factor": "cardiovascular", "points": 0, "present": false }, { "value": 15, "factor": "cns", "points": 0, "present": false }, { "value": 1, "factor": "renal", "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.", "formula_expression": "SOFA = respiration + coagulation + liver + cardiovascular + cns + renal; each 0-4; max 24" }, { "score": 0, "formula": "sofa", "citation": { "id": "vincent-1996", "doi": "10.1007/BF01709751", "title": "The SOFA (Sepsis-related Organ Failure Assessment) score to describe organ dysfunction/failure", "source": "Intensive Care Med. 1996;22(7):707-710", "authors": "Vincent JL, Moreno R, Takala J, Willatts S, De Mendonça A, Bruining H, Reinhart CK, Suter PM, Thijs LG" }, "max_score": 24, "components": [ { "value": 457.1428571428572, "factor": "respiration", "points": 0, "present": false }, { "value": 200, "factor": "coagulation", "points": 0, "present": false }, { "value": 0.8, "factor": "liver", "points": 0, "present": false }, { "value": 80, "factor": "cardiovascular", "points": 0, "present": false }, { "value": 15, "factor": "cns", "points": 0, … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sofa-score-calculator-vincent-1996-1d89f560/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)