{"uid":"cap_3gB6vBMR70naYOyr_EN6B","slug":"cage-alcohol-screening-score-calculator-21ec47fe","name":"CAGE Alcohol Screening Score Calculator","description":"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.","url":"https://api.magentlab.com/api/calc/cage","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_A8dn8P-DDOGOXHw0zmKTW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes the Ewing 1984 CAGE questionnaire score (0–4) from four yes/no items and flags screen-positive if score ≥ 2","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Patient intake alcohol screening","prompt":"Run the CAGE screen for my patient: they answered yes to cutting down, yes to being annoyed, yes to guilt, and no to the eye-opener — what's their score and are they screen-positive?"},{"title":"EHR automation for substance use flag","prompt":"I have four CAGE responses from the intake form — cut_down: true, annoyed: false, guilty: false, eye_opener: false — calculate the score so I can decide whether to flag this chart for follow-up."},{"title":"Research cohort CAGE scoring","prompt":"Score the CAGE questionnaire for a study participant who answered no to all four items and confirm they're screen-negative."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:09:33.280Z","isFirstParty":false}