# CAGE Alcohol Screening Score Calculator

> CAGE Alcohol Screening 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-13).

Computes the Ewing 1984 CAGE questionnaire score (0–4) from four yes/no items and flags screen-positive if score ≥ 2

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/cage
- 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/cage-alcohol-screening-score-calculator-21ec47fe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3gB6vBMR70naYOyr_EN6B

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 cage-alcohol-screening-score-calculator-21ec47fe
```

Example prompt: Score the CAGE questionnaire for a patient who said yes to feeling they should cut down, yes to being annoyed by criticism, no to feeling guilty, and no to needing an eye-opener — give me the total score and whether they're screen-positive.

## When to prefer this

Use this endpoint when you need a deterministic, citable implementation of the Ewing 1984 CAGE alcohol screening score — not AUDIT, not CIWA-Ar, and not any other alcohol use instrument. Ideal for automating patient intake workflows, EHR integrations, or research pipelines that require a published scoring algorithm with a traceable citation rather than a free-text interpretation.

## Known failure modes

- Missing required boolean parameter (cut_down, annoyed, guilty, or eye_opener) returns a validation error
- Non-boolean values for any parameter cause a schema error
- Payment failure due to insufficient USDC balance or x402 misconfiguration blocks the request
- Network timeout on rare occasions under load

## How this service works

Ewing 1984 CAGE questionnaire: four caller-assigned yes/no items (cut down, annoyed, guilty, eye-opener), 1 point each, max 4. Screen-positive when two or more answers are affirmative (score ≥2). Deterministic published score with citation; not a diagnosis of alcohol use disorder, not CIWA-Ar, and not AUDIT. magent does not interpret individual items.

## Output

Returns the total CAGE score (integer 0–4) based on the sum of affirmative answers, plus an indication of whether the score meets the screen-positive threshold (≥ 2), with a citation to Ewing 1984. Does not interpret individual items or provide a diagnosis.

## 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": [
      "cut_down",
      "annoyed",
      "guilty",
      "eye_opener"
     ],
     "properties": {
      "guilty": {
       "type": "boolean",
       "description": "Have you ever felt bad or Guilty about your drinking? (Ewing 1984). true or false as assigned by the caller. magent does not interpret the item."
      },
      "annoyed": {
       "type": "boolean",
       "description": "Have people Annoyed you by criticizing your drinking? (Ewing 1984). true or false as assigned by the caller. magent does not interpret the item."
      },
      "cut_down": {
       "type": "boolean",
       "description": "Have you ever felt you should Cut down on your drinking? (Ewing 1984). true or false as assigned by the caller. magent does not interpret the item."
      },
      "eye_opener": {
       "type": "boolean",
       "description": "Have you ever had a drink first thing in the morning to steady your nerves or get rid of a hangover (Eye-opener)? (Ewing 1984). true or false as assigned by the caller. magent does not interpret the item."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "path": "/api/calc/cage",
  "count": 2,
  "items": [
   {
    "score": 0,
    "formula": "cage",
    "citation": {
     "id": "ewing-1984",
     "doi": "10.1001/jama.1984.03350140051025",
     "title": "Detecting alcoholism. The CAGE questionnaire",
     "source": "JAMA. 1984;252(14):1905-1907",
     "authors": "Ewing JA"
    },
    "max_score": 4,
    "components": [
     {
      "factor": "cut_down",
      "points": 0,
      "present": false
     },
     {
      "factor": "annoyed",
      "points": 0,
      "present": false
     },
     {
      "factor": "guilty",
      "points": 0,
      "present": false
     },
     {
      "factor": "eye_opener",
      "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.",
    "screen_positive": false,
    "formula_expression": "CAGE = cut_down + annoyed + guilty + eye_opener; each 1 if true; max 4"
   },
   {
    "score": 0,
    "formula": "cage",
    "citation": {
     "id": "ewing-1984",
     "doi": "10.1001/jama.1984.03350140051025",
     "title": "Detecting alcoholism. The CAGE questionnaire",
     "source": "JAMA. 1984;252(14):1905-1907",
     "authors": "Ewing JA"
    },
    "max_score": 4,
    "components": [
     {
      "factor": "cut_down",
      "points": 0,
      "present": false
     },
     {
      "factor": "annoyed",
      "points": 0,
      "present": false
     },
     {
      "factor": "guilty",
      "points": 0,
      "present": false
     },
     {
      "factor": "eye_opener",
      "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.",
    "screen_positive": false,
    "formula_expression": "CAGE = cut_down + annoyed + guilty + eye_opener; each 1 if true; max 4"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cage-alcohol-screening-score-calculator-21ec47fe/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)