# magent Berg Balance Scale (BBS) Calculator

> magent Berg Balance Scale (BBS) 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-14).

Computes the Berg Balance Scale total score (0–56) from 14 caller-assigned item scores and returns the associated functional mobility band

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/berg_balance
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/magent-berg-balance-scale-bbs-calculator-a9422dfc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CvYjDVjpMwUQrY6mapIeN

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-berg-balance-scale-bbs-calculator-a9422dfc
```

Example prompt: Calculate the Berg Balance Scale total for a patient who scored: sitting to standing 3, standing unsupported 4, sitting unsupported 4, standing to sitting 3, transfers 3, standing eyes closed 2, standing feet together 3, reaching forward 2, retrieving object from floor 2, turning to look behind 2, turning 360 degrees 2, alternate foot on stool 2, tandem stance 1, standing on one foot 1.

## When to prefer this

Use this endpoint when you need a fast, reliable arithmetic computation of the Berg Balance Scale total and band classification from 14 pre-assigned item scores. Prefer it over manual summation in clinical documentation workflows, EHR integrations, or rehabilitation tracking agents where structured BBS output is needed consistently. It is not a diagnostic tool and should not replace clinical observation.

## Known failure modes

- Missing any of the 14 required query parameters returns a validation error
- Any item score outside the integer range 0–4 returns a validation error
- Non-integer values (floats, strings) for item scores cause a request rejection
- Payment failure (x402) if USDC balance is insufficient or x402 header is missing/invalid

## How this service works

Berg 1992 Berg Balance Scale (BBS): fourteen caller-assigned integers 0-4 (sitting to standing through standing on one foot). Sum 0-56. magent does not observe. Berg 1992 printed no 0-20 wheelchair / 21-40 walking-with-assistance / 41-56 independent website bands. Not Timed Up and Go, not a diagnosis, and not a medical device.

## Output

Returns the summed Berg Balance Scale total (integer 0–56) computed from the 14 input item scores, along with the Berg 1992 functional mobility band: 0–20 (wheelchair level), 21–40 (walking with assistance), or 41–56 (independent ambulation). The endpoint performs arithmetic only and does not observe or diagnose the patient.

## 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": [
      "sitting_to_standing",
      "standing_unsupported",
      "sitting_unsupported",
      "standing_to_sitting",
      "transfers",
      "standing_eyes_closed",
      "standing_feet_together",
      "reaching_forward",
      "retrieving_object_from_floor",
      "turning_to_look_behind",
      "turning_360",
      "alternate_foot_on_stool",
      "tandem_stance",
      "standing_on_one_foot"
     ],
     "properties": {
      "transfers": {
       "type": "integer",
       "description": "Caller-assigned Berg 1992 transfers (integer 0-4): 4 able to transfer safely with minor use of hands; 3 able to transfer safely definite need of hands; 2 able to transfer with verbal cuing and/or supervision; 1 needs one person to assist; 0 needs two people to assist or supervise to be safe. magent does not observe the patient."
      },
      "turning_360": {
       "type": "integer",
       "description": "Caller-assigned Berg 1992 turning 360 degrees (integer 0-4): 4 able to turn 360 degrees safely in 4 seconds or less; 3 able to turn 360 degrees safely one side only in 4 seconds or less; 2 able to turn 360 degrees safely but slowly; 1 needs close supervision or verbal cuing; 0 needs assistance while turning. magent does not observe the patient."
      },
      "tandem_stance": {
       "type": "integer",
       "description": "Caller-assigned Berg 1992 standing unsupported one foot in front (integer 0-4): 4 able to place foot tandem independently and hold 30 seconds; 3 able to place foot ahead of other independently and hold 30 seconds; 2 able to take small step independently and hold 30 seconds; 1 needs help to step but can hold 15 seconds; 0 loses balance while stepping or standing. magent does not observe the patient."
      },
      "reaching_forward": {
       "type": "integer",
       "description": "Caller-assigned Berg 1992 reaching forward with outstretched arm while standing (integer 0-4): 
… (truncated)
```

## More

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