Back to Browse
FOUR Score Calculator (Wijdicks 2005)
x402
FOUR Score Calculator (Wijdicks 2005) 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-15).
Computes the Full Outline of UnResponsiveness (FOUR) score by summing four caller-assigned integer components: eye, motor, brainstem, and respiration (max 16).
Price / call$0.005
Success—
StatusUnknown
How this service works
FOUR score (Wijdicks 2005) from caller-assigned eye, motor, brainstem, and respiration integers 0-4; magent sums only (max 16) and does not pick a component from a narrative. Eye 4 tracking/blink to command to 0 closed to pain; motor 4 thumbs-up/fist/peace to 0 none or myoclonus status; brainstem 4 pupil and corneal present to 0 pupil, corneal, and cough absent; respiration 4 not intubated regular to 0 ventilator rate or apnea. Not a diagnosis and not a GCS conversion.
Output
Returns the summed FOUR score integer (0–16) derived from the four caller-supplied component scores (eye + motor + brainstem + respiration). Does not interpret clinical meaning, suggest a diagnosis, or convert to or from GCS.
Example use cases
ICU coma severity documentation
“My neurocritical care patient has eye score 1 (opens to pain), motor score 0 (no movement), brainstem score 2 (pupil or corneal absent), and respiration score 0 (on ventilator at set rate) — what is their FOUR score?”
Tracking neurological improvement over time
“Yesterday my patient scored eye 1, motor 1, brainstem 2, respiration 1. Today they are eye 2, motor 2, brainstem 3, respiration 1. Can you calculate both FOUR scores so I can compare them?”
Stroke patient neurological status at admission
“For my acute stroke admission, the attending assigned eye 3, motor 4, brainstem 4, and respiration 4 on the FOUR scale — what is the total FOUR score?”
Technical details
Endpoint
GEThttps://api.magentlab.com/api/calc/four_scoreWhen to prefer
Use when you have already clinically assessed and assigned the four FOUR score components per Wijdicks 2005 criteria and need a reliable, auditable sum. Do not use to derive component scores from narrative text or to convert GCS to FOUR. Prefer this over manual arithmetic when embedding neurological scoring into an automated clinical workflow or documentation pipeline.
Side effects
- Integer out of range (0-4) for any component returns an error
- Missing required query parameter (eye, motor, brainstem, or respiration) returns a validation error
- Non-integer values (e.g. decimals or strings) rejected
- Payment failure via x402 protocol returns 402
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
Schema · Response
{
"type": "json",
"example": {
"path": "/api/calc/four_score",
"count": 2,
"items": [
{
"score": 16,
"formula": "four_score",
"citation": {
"id": "wijdicks-2005",
"doi": "10.1002/ana.20611",
"pmid": "16178024",
"title": "Validation of a new coma scale: The FOUR score",
"source": "Ann Neurol. 2005;58(4):585-593",
"authors": "Wijdicks EFM, Bamlet WR, Maramattom BV, Manno EM, McClelland RL"
},
"max_score": 16,
"components": [
{
"value": 4,
"factor": "eye",
"points": 4,
"present": true
},
{
"value": 4,
"factor": "motor",
"points": 4,
"present": true
},
{
"value": 4,
"factor": "brainstem",
"points": 4,
"present": true
},
{
"value": 4,
"factor": "respiration",
"points": 4,
"present": true
}
],
"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.",
"formula_expression": "FOUR = eye + motor + brainstem + respiration; each caller-assigned integer 0-4; max 16"
},
{
"score": 16,
"formula": "four_score",
"citation": {
"id": "wijdicks-2005",
"doi": "10.1002/ana.20611",
"pmid": "16178024",
"title": "Validation of a new coma scale: The FOUR score",
"source": "Ann Neurol. 2005;58(4):585-593",
"authors": "Wijdicks EFM, Bamlet WR, Maramattom BV, Manno EM, McClelland RL"
},
"max_score": 16,
"components": [
{
"value": 4,
"factor": "eye",
"points": 4,
"present": true
},
{
"value": 4,
"factor": "motor",
"points": 4,
"present": true
},
{
"value": 4,
"factor": "brainstem",
"points": 4,
"present": true
},
{
"value": 4,
"factor": "respiration",
"points": 4,
"present": true
}
],
"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.",
"formula_expression": "FOUR = eye + motor + brainstem + respiration; each caller-assigned integer 0-4; max 16"
}
]
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"