# magent NEWS Score Calculator (RCP 2012)

> magent NEWS Score Calculator (RCP 2012) 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 National Early Warning Score (NEWS, RCP 2012 Chart 1) from six vital signs and AVPU, returning a 0–20 total, Chart 2 clinical risk tier, and red-score flag.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/news
- 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-news-score-calculator-rcp-2012-dfaf4146
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QJUACZcpF8B7aZ6gqilto

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-news-score-calculator-rcp-2012-dfaf4146
```

Example prompt: Calculate the NEWS score for a patient with respiratory rate 22, SpO2 94%, no supplemental oxygen, temperature 38.5°C, systolic BP 105 mmHg, heart rate 112 bpm, and AVPU of alert — what's the total score and clinical risk level?

## When to prefer this

Choose this endpoint when you need a deterministic, citeable RCP 2012 NEWS (not NEWS2) score from seven discrete vital sign inputs with Chart 2 risk classification. Prefer it over manual lookup tables when automating triage pipelines, EHR integrations, or remote monitoring alerts where reproducibility and a published arithmetic standard matter. Do not use for ICU admission orders, NEWS2 SpO2 Scale 2 logic, or GCS-based consciousness scoring.

## Known failure modes

- Missing any of the seven required query parameters returns a validation error
- Out-of-range values (e.g. SpO2 outside 50–100, temperature outside 30–45) may be rejected
- AVPU value not matching the enum (alert/voice/pain/unresponsive) returns an error
- Payment failure or missing x402 header results in a 402 Payment Required response
- Does not accept NEWS2 Scale 2 SpO2 logic or Fahrenheit temperatures — caller must convert

## How this service works

NEWS from RCP 2012 Chart 1: respiratory rate, SpO2, supplemental oxygen, temperature (°C), systolic BP, heart rate, and caller-assigned AVPU (alert 0; voice, pain, or unresponsive 3 each) summed to a 0–20 total. Returns Chart 2 clinical_risk (low/medium/high) and red_score when any parameter scores 3. Deterministic published arithmetic with citation; not NEWS2; not an ICU-admission order.

## Output

Returns the summed NEWS total (0–20), the Chart 2 clinical risk band (low, medium, or high), and a red_score flag that is set when any single parameter scores 3, indicating a high-acuity concern per the RCP 2012 protocol.

## 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": [
      "systolic_mm_hg",
      "heart_rate_bpm",
      "respiratory_rate",
      "temperature_c",
      "spo2_percent",
      "supplemental_oxygen",
      "avpu"
     ],
     "properties": {
      "avpu": {
       "enum": [
        "alert",
        "voice",
        "pain",
        "unresponsive"
       ],
       "type": "string",
       "description": "Caller-assigned AVPU (alert, voice, pain, or unresponsive). RCP NEWS 2012 Chart 1: alert → 0; voice, pain, or unresponsive → 3 each. magent does not compute GCS here."
      },
      "spo2_percent": {
       "type": "number",
       "description": "Oxygen saturation percent (50-100). RCP NEWS 2012 Chart 1 Scale 1: ≤91 → 3, 92-93 → 2, 94-95 → 1, ≥96 → 0. Not NEWS2 Scale 2."
      },
      "temperature_c": {
       "type": "number",
       "description": "Temperature in °C (30.0-45.0). RCP NEWS 2012 Chart 1: ≤35.0 → 3, 35.1-36.0 → 1, 36.1-38.0 → 0, 38.1-39.0 → 1, ≥39.1 → 2. magent does not convert Fahrenheit."
      },
      "heart_rate_bpm": {
       "type": "integer",
       "description": "Heart rate in beats/min (integer 30-220). RCP NEWS 2012 Chart 1: ≤40 → 3, 41-50 → 1, 51-90 → 0, 91-110 → 1, 111-130 → 2, ≥131 → 3."
      },
      "systolic_mm_hg": {
       "type": "integer",
       "description": "Systolic blood pressure in mm Hg (integer 0-300). RCP NEWS 2012 Chart 1: ≤90 → 3, 91-100 → 2, 101-110 → 1, 111-219 → 0, ≥220 → 3."
      },
      "respiratory_rate": {
       "type": "integer",
       "description": "Respiratory rate in breaths/min (integer 0-80). RCP NEWS 2012 Chart 1: ≤8 → 3, 9-11 → 1, 12-20 → 0, 21-24 → 2, ≥25 → 3."
      },
      "supplemental_oxygen": {
       "type": "boolean",
       "description": "Any supplemental oxygen as assigned by the caller (true or false). RCP NEWS 2012 Chart 1: true → 2, false → 0."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [

… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "path": "/api/calc/news",
  "count": 2,
  "items": [
   {
    "avpu": "alert",
    "score": 0,
    "formula": "news",
    "citation": {
     "id": "rcp-news-2012",
     "title": "National Early Warning Score (NEWS): Standardising the assessment of acute-illness severity in the NHS",
     "source": "London: RCP; 2012. ISBN 978-1-86016-471-2",
     "authors": "Royal College of Physicians"
    },
    "max_score": 20,
    "red_score": false,
    "components": [
     {
      "value": 16,
      "factor": "respiratory_rate",
      "points": 0,
      "present": false
     },
     {
      "value": 98,
      "factor": "spo2_percent",
      "points": 0,
      "present": false
     },
     {
      "value": false,
      "factor": "supplemental_oxygen",
      "points": 0,
      "present": false
     },
     {
      "value": 37,
      "factor": "temperature_c",
      "points": 0,
      "present": false
     },
     {
      "value": 120,
      "factor": "systolic_mm_hg",
      "points": 0,
      "present": false
     },
     {
      "value": 70,
      "factor": "heart_rate_bpm",
      "points": 0,
      "present": false
     },
     {
      "value": "alert",
      "factor": "avpu",
      "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.",
    "spo2_percent": 98,
    "clinical_risk": "low",
    "temperature_c": 37,
    "heart_rate_bpm": 70,
    "systolic_mm_hg": 120,
    "respiratory_rate": 16,
    "formula_expression": "NEWS = rr_points + spo2_points + oxygen_points + temp_points + sbp_points + hr_points + avpu_points; RCP NEWS 2012 Chart 1; max 20",
    "supplemental_oxygen": false
   },
   {
    "avpu": "alert",
    "score": 0,
    "formula": "news",
    "citation": {
     "id": "rcp-news-2012",
     "title": "National Early Warning Score (NEWS): Standardising the assessment of acute-illness severity in the NHS",
     "source": "London: RCP; 2012. ISBN 978-1-86016-471-2",
     "authors": "Royal College of Physicians"
    },
    "max_score": 20,
    "red_score": false,
    "components": [
     {
      "value": 16,
      "factor": "respiratory_rate",
      "points": 0,
      "present": false
     },
     {
      "value": 98,
      "factor": "spo2_percent",
      "points": 0,
      "present": false
     },
     {
      "value": false,
   
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/magent-news-score-calculator-rcp-2012-dfaf4146/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)
