# magent Braden Scale Calculator

> magent Braden Scale 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-13).

Computes the Bergstrom 1987 Braden Scale total score (6–23) and returns whether the patient is at risk for pressure sores (score ≤ 16).

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/braden
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/magent-braden-scale-calculator-315d5793
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_C_k7d4IjNJEQPUcfWUgG6

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-braden-scale-calculator-315d5793
```

Example prompt: Calculate the Braden Scale score for a patient with sensory perception 2, moisture 3, activity 1, mobility 2, nutrition 2, and friction/shear 1 — and tell me whether they're flagged as at risk for pressure sores.

## When to prefer this

Use this endpoint when you need a fast, reproducible, auditable Braden Scale computation from caller-supplied subscale ratings — particularly in automated clinical documentation pipelines, EHR integrations, or agentic workflows where consistent pressure-ulcer risk screening is required. Prefer this over manual calculation to eliminate arithmetic errors and enforce the canonical ≤16 at-risk threshold from the Bergstrom 1987 paper.

## Known failure modes

- Missing required subscale parameter returns a validation error
- Out-of-range integer (e.g. friction_shear=4 or any subscale=0) returns an error
- Non-integer values for subscale fields cause schema validation failure
- Payment not provided or insufficient USDC balance results in 402 response

## How this service works

Bergstrom 1987 Braden Scale: six caller-assigned subscales — sensory_perception, moisture, activity, mobility, nutrition (each 1-4) and friction_shear (1-3). magent sums only (range 6-23; lower is higher pressure-sore risk) and returns at_risk true iff score ≤16, the only cutoff in that paper's predictive-validity studies. magent does not examine the patient. Not a medical device, not a diagnosis, and not a treatment plan.

## Output

Returns the summed Braden Scale total score (integer, range 6–23) and a boolean at_risk field that is true when the score is 23 or below 17 (i.e., ≤ 16), indicating elevated pressure-sore risk per the Bergstrom 1987 predictive-validity cutoff.

## 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": [
      "sensory_perception",
      "moisture",
      "activity",
      "mobility",
      "nutrition",
      "friction_shear"
     ],
     "properties": {
      "activity": {
       "type": "integer",
       "description": "Caller-assigned Bergstrom 1987 Braden activity (integer 1-4): 1 bedfast; 2 chairfast; 3 walks occasionally; 4 walks frequently. magent does not examine the patient."
      },
      "mobility": {
       "type": "integer",
       "description": "Caller-assigned Bergstrom 1987 Braden mobility (integer 1-4): 1 completely immobile; 2 very limited; 3 slightly limited; 4 no limitations. magent does not examine the patient."
      },
      "moisture": {
       "type": "integer",
       "description": "Caller-assigned Bergstrom 1987 Braden moisture (integer 1-4): 1 constantly moist; 2 very moist; 3 occasionally moist; 4 rarely moist. magent does not examine the patient."
      },
      "nutrition": {
       "type": "integer",
       "description": "Caller-assigned Bergstrom 1987 Braden nutrition (integer 1-4): 1 very poor; 2 probably inadequate; 3 adequate; 4 excellent. magent does not examine the patient."
      },
      "friction_shear": {
       "type": "integer",
       "description": "Caller-assigned Bergstrom 1987 Braden friction and shear (integer 1-3 only): 1 problem; 2 potential problem; 3 no apparent problem. magent does not examine the patient."
      },
      "sensory_perception": {
       "type": "integer",
       "description": "Caller-assigned Bergstrom 1987 Braden sensory perception (integer 1-4): 1 completely limited; 2 very limited; 3 slightly limited; 4 no impairment. magent does not examine the patient."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/magent-braden-scale-calculator-315d5793/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)