# Hunt and Hess 1968 SAH Surgical-Risk Grade Calculator

> Hunt and Hess 1968 SAH Surgical-Risk Grade 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-10-12).

Returns the deterministic Hunt and Hess 1968 subarachnoid hemorrhage surgical-risk grade (1–5) with citation, adjusting one category worse if serious systemic disease is present, capped at grade 5.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/hunt_hess?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hunt-and-hess-1968-sah-surgical-risk-grade-calculator-c0f94c51
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RGYdnz2yLQZdcJFQiT-N-

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 hunt-and-hess-1968-sah-surgical-risk-grade-calculator-c0f94c51
```

Example prompt: My patient has a Hunt and Hess clinical grade of 3 and has severe hypertension — can you compute the adjusted Hunt and Hess 1968 surgical-risk grade with systemic disease taken into account?

## When to prefer this

Use this endpoint when you need the deterministic, citeable Hunt and Hess 1968 SAH surgical-risk grade — specifically the original 1968 classification with the systemic-disease penalty rule — and not the WFNS scale or the Hunt-Kosnik 1974 variant. Ideal for clinical documentation, registry entry, or automated neurosurgery triage workflows where the exact published grading algorithm and citation are required.

## Known failure modes

- Grade integer outside 1–5 range returns a validation error
- Missing required query parameters (grade or serious_systemic_disease) returns a 400-level error
- Payment not included or insufficient triggers x402 payment-required response
- Boolean serious_systemic_disease not parseable returns schema error

## How this service works

Deterministic published-formula arithmetic plus ICD-10-CM, RxNorm, and LOINC. Pay in USDC on Base via x402.

## Output

Returns the final Hunt and Hess 1968 surgical-risk grade (integer 1–5), incorporating the one-step downward adjustment when serious systemic disease is present (capped at 5), along with the grade interpretation and a citation to the 1968 Hunt and Hess paper. Not a diagnosis; does not return WFNS or Hunt-Kosnik grades.

## 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": [
      "grade",
      "serious_systemic_disease"
     ],
     "properties": {
      "grade": {
       "type": "integer",
       "description": "Hunt and Hess 1968 clinical grade 1-5 as assigned by the caller. magent does not examine the patient."
      },
      "serious_systemic_disease": {
       "type": "boolean",
       "description": "true if serious systemic disease is present (hypertension, diabetes, severe arteriosclerosis, chronic pulmonary disease, or severe angiographic vasospasm as assigned by the caller). The 1968 paper places the patient in the next less favorable category."
      }
     }
    }
   },
   "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/hunt_hess",
  "count": 2,
  "items": [
   {
    "grade": 2,
    "score": 2,
    "formula": "hunt_hess",
    "citation": {
     "id": "hunt-hess-1968",
     "doi": "10.3171/jns.1968.28.1.0014",
     "title": "Surgical risk as related to time of intervention in the repair of intracranial aneurysms",
     "source": "J Neurosurg. 1968;28(1):14-20",
     "authors": "Hunt WE, Hess RM"
    },
    "max_score": 5,
    "components": [
     {
      "factor": "assigned_grade",
      "points": 2,
      "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.",
    "description": "Moderate to severe headache, nuchal rigidity, no neurologic deficit other than cranial nerve palsy",
    "input_grade": 2,
    "formula_expression": "assigned_grade = min(5, grade + 1) if serious_systemic_disease, else grade; Hunt and Hess 1968 grades 1-5",
    "serious_systemic_disease": false
   },
   {
    "grade": 2,
    "score": 2,
    "formula": "hunt_hess",
    "citation": {
     "id": "hunt-hess-1968",
     "doi": "10.3171/jns.1968.28.1.0014",
     "title": "Surgical risk as related to time of intervention in the repair of intracranial aneurysms",
     "source": "J Neurosurg. 1968;28(1):14-20",
     "authors": "Hunt WE, Hess RM"
    },
    "max_score": 5,
    "components": [
     {
      "factor": "assigned_grade",
      "points": 2,
      "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.",
    "description": "Moderate to severe headache, nuchal rigidity, no neurologic deficit other than cranial nerve palsy",
    "input_grade": 2,
    "formula_expression": "assigned_grade = min(5, grade + 1) if serious_systemic_disease, else grade; Hunt and Hess 1968 grades 1-5",
    "serious_systemic_disease": false
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hunt-and-hess-1968-sah-surgical-risk-grade-calculator-c0f94c51/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)
