# magent Liu 2004 Respiratory Clinical Score Calculator

> magent Liu 2004 Respiratory Clinical Score 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).

Sums the four caller-assigned Liu 2004 respiratory clinical score domains (respiratory rate, retractions, dyspnea, auscultation) to produce a total score out of 12

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/liu_respiratory
- 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/magent-liu-2004-respiratory-clinical-score-calculator-456cd74a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Yh1juic4Qj7j7EgDXgEhN

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 magent-liu-2004-respiratory-clinical-score-calculator-456cd74a
```

Example prompt: Calculate the Liu 2004 respiratory clinical score for a child with a respiratory rate score of 2, retractions score of 1, dyspnea score of 2, and auscultation score of 1 — what is the total out of 12?

## When to prefer this

Use this endpoint when you need to arithmetically compute the Liu 2004 respiratory clinical score from four pre-assessed ordinal domain values. Prefer this over manual calculation to ensure correctness and auditability. Note this is NOT the PRAM score, NOT the Westley 1978 croup score, and does NOT interpret severity bands — it only sums the four provided scores.

## Known failure modes

- Missing any of the four required query parameters returns an error
- Domain values outside the valid 0-3 integer range will be rejected
- Non-integer values for any domain score will fail validation
- Payment failure (402) if x402 payment header is not correctly provided

## How this service works

Liu 2004 respiratory clinical score: four caller-assigned 0-3 domains — respiratory_rate (age-banded Table 1 ordinal, not raw breaths/min), retractions, dyspnea, and auscultation. magent sums only (max 12) and does not count breaths or auscultate. Score only; Liu 2004 does not print mild/moderate/severe total-score cutoffs. Not a diagnosis or treatment order. Not PRAM. Not Westley 1978 croup.

## Output

Returns the total Liu 2004 respiratory clinical score as an integer between 0 and 12, computed by summing the four caller-assigned ordinal domain scores (respiratory_rate, retractions, dyspnea, auscultation). No severity band labels are provided, as Liu 2004 does not define mild/moderate/severe cutoffs for the total score.

## 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": [
      "respiratory_rate",
      "retractions",
      "dyspnea",
      "auscultation"
     ],
     "properties": {
      "dyspnea": {
       "type": "integer",
       "description": "Caller-assigned Liu 2004 dyspnea (integer 0-3). 0-2 years: 0 normal feeding, vocalizations and activity; 1 one of difficulty feeding, decreased vocalization or agitated; 2 two of those; 3 stops feeding, no vocalization, drowsy or confused. 2-4 years: 0 normal feeding, vocalizations and activity; 1 one of decreased appetite, increased coughing after play, hyperactivity; 2 two of those; 3 stops eating or drinking, stops playing, or drowsy and confused. >4 years: 0 counts to ≥10 in one breath; 1 counts to 7-9; 2 counts to 4-6; 3 counts to ≤3. magent does not examine the patient."
      },
      "retractions": {
       "type": "integer",
       "description": "Caller-assigned Liu 2004 retractions (integer 0-3): 0 none; 1 subcostal or intercostal; 2 two of subcostal, intercostal, substernal or nasal flaring (infant); 3 three of subcostal, intercostal, substernal, infraclavicular or nasal flaring/head bobbing (infant). magent does not examine the patient."
      },
      "auscultation": {
       "type": "integer",
       "description": "Caller-assigned Liu 2004 auscultation (integer 0-3): 0 normal breathing, no wheezing; 1 end-expiratory wheeze only; 2 expiratory wheeze only (greater than end-expiratory); 3 inspiratory and expiratory wheeze or diminished breath sounds or both. magent does not auscultate."
      },
      "respiratory_rate": {
       "type": "integer",
       "description": "Caller-assigned Liu 2004 respiratory-rate points (integer 0-3), not raw breaths/min. Table 1 age bands for 1/2/3: <2 months ≤60 / 61-69 / ≥70; 2-12 months ≤50 / 51-59 / ≥60; 1-2 years ≤40 / 41-44 / ≥45; 2-3 years ≤34 / 35-39 / ≥40; 4-5 years ≤30 / 31-35 / ≥36; 6-12 years ≤26 / 27-30 / ≥31; >12 years ≤23 / 24-27 / ≥28. 0 is the 0-point 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/magent-liu-2004-respiratory-clinical-score-calculator-456cd74a/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)
