# magent Stanford Sleepiness Scale Calculator

> magent Stanford Sleepiness 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-14).

Returns the Hoddes 1973 Stanford Sleepiness Scale score, published wording, and metadata for a caller-assigned degree 1–7.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/stanford_sleepiness
- 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-stanford-sleepiness-scale-calculator-15bb4665
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TES6goU-4T28sStQJANkG

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-stanford-sleepiness-scale-calculator-15bb4665
```

Example prompt: Look up Stanford Sleepiness Scale degree 5 and give me the published Hoddes 1973 wording for that level.

## When to prefer this

Choose this endpoint when you need the verbatim Hoddes 1973 Stanford Sleepiness Scale published wording for a caller-assigned degree 1–7, as opposed to the Epworth Sleepiness Scale or any other subjective sleepiness instrument. It does not diagnose sleep disorders and does not observe or assess the patient — the caller is responsible for assigning the degree. Prefer this over manual lookup when building clinical documentation pipelines, research annotation tools, or any workflow that needs the exact published SSS text programmatically.

## Known failure modes

- Missing or out-of-range degree (not 1–7) returns a validation error
- Non-integer value for stanford_sleepiness parameter causes a 400-level error
- Payment failure (x402 protocol) blocks the request before computation
- No network connectivity to api.magentlab.com results in timeout

## How this service works

Hoddes 1973 Stanford Sleepiness Scale degree 1-7 as assigned by the caller. Returns the degree, score (same as the degree), max 7, and published wording (feeling active and vital; alert; wide awake through almost in reverie; sleep onset soon). Not the Epworth Sleepiness Scale. Not a sleep-disorder diagnosis; magent does not observe the patient.

## Output

Returns a JSON object with the integer degree (1–7) echoed back, the numeric score (equal to the degree), the maximum possible score (7), and the verbatim published Hoddes 1973 wording for that level (e.g. 'almost in reverie; sleep onset soon; lost struggle to remain awake' for degree 7).

## 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": [
      "stanford_sleepiness"
     ],
     "properties": {
      "stanford_sleepiness": {
       "type": "integer",
       "description": "Hoddes 1973 Stanford Sleepiness Scale degree 1-7 as assigned by the caller (1 feeling active and vital, alert, wide awake; 2 functioning at a high level, but not at peak, able to concentrate; 3 relaxed, awake, not at full alertness, responsive; 4 a little foggy, not at peak, let down; 5 fogginess, beginning to lose interest in remaining awake, slowed down; 6 sleepiness, prefer to be lying down, fighting sleep, woozy; 7 almost in reverie, sleep onset soon, lost struggle to remain awake). Not Epworth. magent does not observe 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-stanford-sleepiness-scale-calculator-15bb4665/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)