Hematology · LIVE
HCT-CI (hematopoietic cell transplantation comorbidity index)
HCT-CI
Sum the Sorror 2005 HCT-specific comorbidity index weights and return low (0), intermediate (1–2), or high (≥3).
Markdown: /docs/hct-ci.md · Canonical: https://magentlab.com/docs/hct-ci
Not a medical device. Not a diagnosis, dose, or listing recommendation.
What it computes
Sum the Sorror 2005 HCT-specific comorbidity index weights and return low (0), intermediate (1–2), or high (≥3).
When to use
When an agent needs the published HCT-CI point total and risk group from caller-assigned comorbidities and must not substitute Charlson weights or invent a transplant listing.
When not to use
- Not a medical device and not a diagnosis. Not a transplant listing. magent does not examine the patient.
- This is the Sorror 2005 HCT-CI, not the Charlson comorbidity index. Weights are the HCT-CI published integers, not Charlson weights.
- magent does not interpret PFTs, echo, BMI, or laboratory values. The caller assigns each comorbidity as present or absent, including the published pulmonary and hepatic grades.
- Moderate and severe pulmonary grades are mutually exclusive. Mild and moderate/severe hepatic grades are mutually exclusive. Both-true returns HTTP 400. Mild pulmonary and mild renal are not scored in Sorror 2005.
- Risk groups follow Sorror 2005 (0 low, 1–2 intermediate, ≥3 high). JSON does not include unofficial survival percentages.
Formula
HCT-CI = arrhythmia 1 + cardiac 1 + inflammatory_bowel_disease 1 + diabetes 1 + cerebrovascular_disease 1 + psychiatric_disturbance 1 + mild_hepatic 1 + obesity 1 + infection 1 + rheumatologic 2 + peptic_ulcer 2 + moderate_severe_renal 2 + moderate_pulmonary 2 + prior_solid_tumor 3 + heart_valve_disease 3 + severe_pulmonary 3 + moderate_severe_hepatic 3; Sorror 2005 HCT-CI weights; max 26; pulmonary moderate vs severe exclusive; hepatic mild vs moderate/severe exclusive; risk groups 0 low / 1-2 intermediate / >=3 high
Citation
- Authors
- Sorror ML, Maris MB, Storb R, et al.
- Source
- Blood. 2005;106(9):2912-2919
Worked example
No comorbidities
Given:
arrhythmia=falsecardiac=falsecerebrovascular_disease=falsediabetes=falseheart_valve_disease=falseinfection=falseinflammatory_bowel_disease=falsemild_hepatic=falsemoderate_pulmonary=falsemoderate_severe_hepatic=falsemoderate_severe_renal=falseobesity=falsepeptic_ulcer=falseprior_solid_tumor=falsepsychiatric_disturbance=falserheumatologic=falsesevere_pulmonary=false
- All 17 flags false
- score = 0
- risk_group = low
Mutually compatible maxima
Given:
arrhythmia=truecardiac=truecerebrovascular_disease=truediabetes=trueheart_valve_disease=trueinfection=trueinflammatory_bowel_disease=truemild_hepatic=falsemoderate_pulmonary=falsemoderate_severe_hepatic=truemoderate_severe_renal=trueobesity=truepeptic_ulcer=trueprior_solid_tumor=truepsychiatric_disturbance=truerheumatologic=truesevere_pulmonary=true
- Severe pulmonary 3 and moderate/severe hepatic 3; remaining independent weights
- score = 26 (max 26); risk_group = high
Also searched as
- HCT-CI
- hematopoietic cell transplantation comorbidity index
- HCT specific comorbidity index
- Sorror comorbidity index
- Sorror 2005 HCT-CI
- HCT comorbidity index
- hematopoietic cell transplant CI
Try
Opens the live endpoint. Unpaid browser requests show the paywall; agents should send Accept: application/json.
Full URL: https://api.magentlab.com/api/calc/hct_ci?arrhythmia=false&cardiac=false&inflammatory_bowel_disease=false&diabetes=false&cerebrovascular_disease=false&psychiatric_disturbance=false&mild_hepatic=false&obesity=false&infection=false&rheumatologic=false&peptic_ulcer=false&moderate_severe_renal=false&moderate_pulmonary=false&prior_solid_tumor=false&heart_valve_disease=false&severe_pulmonary=false&moderate_severe_hepatic=false
Call
Expect HTTP 402 until you retry with PAYMENT-SIGNATURE. Incomplete query params
return HTTP 400 before any quote or charge.
curl -i -H "Accept: application/json" "https://api.magentlab.com/api/calc/hct_ci?arrhythmia=false&cardiac=false&inflammatory_bowel_disease=false&diabetes=false&cerebrovascular_disease=false&psychiatric_disturbance=false&mild_hepatic=false&obesity=false&infection=false&rheumatologic=false&peptic_ulcer=false&moderate_severe_renal=false&moderate_pulmonary=false&prior_solid_tumor=false&heart_valve_disease=false&severe_pulmonary=false&moderate_severe_hepatic=false"
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
arrhythmia |
boolean | required | Arrhythmia as assigned by the caller (Sorror 2005: atrial fibrillation or flutter, sick sinus syndrome, or ventricular arrhythmias). true scores 1. magent does not diagnose arrhythmia. |
cardiac |
boolean | required | Cardiac comorbidity as assigned by the caller (Sorror 2005: coronary artery disease, congestive heart failure, myocardial infarction, or ejection fraction ≤50%). true scores 1. magent does not interpret echo or diagnose cardiac disease. |
inflammatory_bowel_disease |
boolean | required | Inflammatory bowel disease as assigned by the caller (Sorror 2005: Crohn disease or ulcerative colitis). true scores 1. magent does not diagnose IBD. |
diabetes |
boolean | required | Diabetes requiring insulin or oral hypoglycemics, not diet alone, as assigned by the caller (Sorror 2005). true scores 1. magent does not diagnose diabetes. |
cerebrovascular_disease |
boolean | required | Cerebrovascular disease as assigned by the caller (Sorror 2005: TIA or cerebrovascular accident). true scores 1. magent does not diagnose stroke or TIA. |
psychiatric_disturbance |
boolean | required | Psychiatric disturbance as assigned by the caller (Sorror 2005: depression or anxiety requiring psychiatric consult or treatment). true scores 1. magent does not diagnose psychiatric disease. |
mild_hepatic |
boolean | required | Mild hepatic comorbidity as assigned by the caller (Sorror 2005: chronic hepatitis, bilirubin >ULN to 1.5×ULN, or AST/ALT >ULN to 2.5×ULN). true scores 1. Mutually exclusive with moderate_severe_hepatic. magent does not grade liver tests. |
obesity |
boolean | required | Obesity as assigned by the caller (Sorror 2005: body mass index >35 kg/m²). true scores 1. magent does not compute BMI. |
infection |
boolean | required | Infection requiring continuation of antimicrobial treatment after day 0 as assigned by the caller (Sorror 2005). true scores 1. magent does not diagnose infection. |
rheumatologic |
boolean | required | Rheumatologic comorbidity as assigned by the caller (Sorror 2005: SLE, RA, polymyositis, mixed CTD, or polymyalgia rheumatica). true scores 2. magent does not diagnose rheumatologic disease. |
peptic_ulcer |
boolean | required | Peptic ulcer requiring treatment as assigned by the caller (Sorror 2005). true scores 2. magent does not diagnose ulcer disease. |
moderate_severe_renal |
boolean | required | Moderate/severe renal comorbidity as assigned by the caller (Sorror 2005: serum creatinine >2 mg/dL, dialysis, or prior renal transplantation). true scores 2. magent does not grade kidney disease from creatinine. |
moderate_pulmonary |
boolean | required | Moderate pulmonary comorbidity as assigned by the caller (Sorror 2005: DLco and/or FEV1 66%–80% or dyspnea on slight activity). true scores 2. Mutually exclusive with severe_pulmonary. magent does not interpret PFTs. |
prior_solid_tumor |
boolean | required | Prior solid tumor treated at any time, excluding nonmelanoma skin cancer, as assigned by the caller (Sorror 2005). true scores 3. magent does not diagnose cancer. |
heart_valve_disease |
boolean | required | Heart valve disease except mitral valve prolapse as assigned by the caller (Sorror 2005). true scores 3. magent does not interpret echo. |
severe_pulmonary |
boolean | required | Severe pulmonary comorbidity as assigned by the caller (Sorror 2005: DLco and/or FEV1 ≤65% or dyspnea at rest or requiring oxygen). true scores 3. Mutually exclusive with moderate_pulmonary. magent does not interpret PFTs. |
moderate_severe_hepatic |
boolean | required | Moderate/severe hepatic comorbidity as assigned by the caller (Sorror 2005: cirrhosis, bilirubin >1.5×ULN, or AST/ALT >2.5×ULN). true scores 3. Mutually exclusive with mild_hepatic. magent does not grade liver tests. |
Bulk (POST)
POST the same path with a JSON items array. The first item is the GET unit; each additional item is $0.002. Invalid items return HTTP 400 before settlement.
- 1 to 25 items. Each item uses the same keys as the GET query parameters.
- POST of 1 item costs the same as GET. Lists longer than 25: chunk into multiple POSTs. Extra items still execute; do not pad dummy rows.
- The first invalid item fails the whole request (index in the 400 JSON). You are not charged.
- HTTP 200 is {count, path, items}. Each items[i] is the GET 200 body for that row.
- Catalog misses (empty matches, found=false) stay paid 200s inside that slot.
- x402 resource URL is this path plus n and body_sha256. Browsers that prefer text/html get the same paywall as GET; Pay retries POST with the same items.
Example request (fixture)
{
"items": [
{
"arrhythmia": "false",
"cardiac": "false",
"cerebrovascular_disease": "false",
"diabetes": "false",
"heart_valve_disease": "false",
"infection": "false",
"inflammatory_bowel_disease": "false",
"mild_hepatic": "false",
"moderate_pulmonary": "false",
"moderate_severe_hepatic": "false",
"moderate_severe_renal": "false",
"obesity": "false",
"peptic_ulcer": "false",
"prior_solid_tumor": "false",
"psychiatric_disturbance": "false",
"rheumatologic": "false",
"severe_pulmonary": "false"
},
{
"arrhythmia": "false",
"cardiac": "false",
"cerebrovascular_disease": "false",
"diabetes": "false",
"heart_valve_disease": "false",
"infection": "false",
"inflammatory_bowel_disease": "false",
"mild_hepatic": "false",
"moderate_pulmonary": "false",
"moderate_severe_hepatic": "false",
"moderate_severe_renal": "false",
"obesity": "false",
"peptic_ulcer": "false",
"prior_solid_tumor": "false",
"psychiatric_disturbance": "false",
"rheumatologic": "false",
"severe_pulmonary": "false"
}
]
}
Opens a two-item fixture on the API host. Unpaid browsers get the same MetaMask paywall as GET; Pay retries POST with those items.
Example 200 (fixture)
{
"count": 2,
"path": "/api/calc/hct_ci",
"items": [
{
"components": [
{
"factor": "arrhythmia",
"points": 0,
"present": false
},
{
"factor": "cardiac",
"points": 0,
"present": false
},
{
"factor": "inflammatory_bowel_disease",
"points": 0,
"present": false
},
{
"factor": "diabetes",
"points": 0,
"present": false
},
{
"factor": "cerebrovascular_disease",
"points": 0,
"present": false
},
{
"factor": "psychiatric_disturbance",
"points": 0,
"present": false
},
{
"factor": "mild_hepatic",
"points": 0,
"present": false
},
{
"factor": "obesity",
"points": 0,
"present": false
},
{
"factor": "infection",
"points": 0,
"present": false
},
{
"factor": "rheumatologic",
"points": 0,
"present": false
},
{
"factor": "peptic_ulcer",
"points": 0,
"present": false
},
{
"factor": "moderate_severe_renal",
"points": 0,
"present": false
},
{
"factor": "moderate_pulmonary",
"points": 0,
"present": false
},
{
"factor": "prior_solid_tumor",
"points": 0,
"present": false
},
{
"factor": "heart_valve_disease",
"points": 0,
"present": false
},
{
"factor": "severe_pulmonary",
"points": 0,
"present": false
},
{
"factor": "moderate_severe_hepatic",
"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.",
"citation": {
"authors": "Sorror ML, Maris MB, Storb R, et al.",
"doi": "10.1182/blood-2005-05-2004",
"id": "sorror-2005",
"pmid": "15994282",
"source": "Blood. 2005;106(9):2912-2919",
"title": "Hematopoietic cell transplantation (HCT)-specific comorbidity index: a new tool for risk assessment before allogeneic HCT"
},
"formula": "hct_ci",
"formula_expression": "HCT-CI = arrhythmia 1 + cardiac 1 + inflammatory_bowel_disease 1 + diabetes 1 + cerebrovascular_disease 1 + psychiatric_disturbance 1 + mild_hepatic 1 + obesity 1 + infection 1 + rheumatologic 2 + peptic_ulcer 2 + moderate_severe_renal 2 + moderate_pulmonary 2 + prior_solid_tumor 3 + heart_valve_disease 3 + severe_pulmonary 3 + moderate_severe_hepatic 3; Sorror 2005 HCT-CI weights; max 26; pulmonary moderate vs severe exclusive; hepatic mild vs moderate/severe exclusive; risk groups 0 low / 1-2 intermediate / >=3 high",
"max_score": 26,
"score": 0,
"risk_group": "low"
},
{
"components": [
{
"factor": "arrhythmia",
"points": 0,
"present": false
},
{
"factor": "cardiac",
"points": 0,
"present": false
},
{
"factor": "inflammatory_bowel_disease",
"points": 0,
"present": false
},
{
"factor": "diabetes",
"points": 0,
"present": false
},
{
"factor": "cerebrovascular_disease",
"points": 0,
"present": false
},
{
"factor": "psychiatric_disturbance",
"points": 0,
"present": false
},
{
"factor": "mild_hepatic",
"points": 0,
"present": false
},
{
"factor": "obesity",
"points": 0,
"present": false
},
{
"factor": "infection",
"points": 0,
"present": false
},
{
"factor": "rheumatologic",
"points": 0,
"present": false
},
{
"factor": "peptic_ulcer",
"points": 0,
"present": false
},
{
"factor": "moderate_severe_renal",
"points": 0,
"present": false
},
{
"factor": "moderate_pulmonary",
"points": 0,
"present": false
},
{
"factor": "prior_solid_tumor",
"points": 0,
"present": false
},
{
"factor": "heart_valve_disease",
"points": 0,
"present": false
},
{
"factor": "severe_pulmonary",
"points": 0,
"present": false
},
{
"factor": "moderate_severe_hepatic",
"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.",
"citation": {
"authors": "Sorror ML, Maris MB, Storb R, et al.",
"doi": "10.1182/blood-2005-05-2004",
"id": "sorror-2005",
"pmid": "15994282",
"source": "Blood. 2005;106(9):2912-2919",
"title": "Hematopoietic cell transplantation (HCT)-specific comorbidity index: a new tool for risk assessment before allogeneic HCT"
},
"formula": "hct_ci",
"formula_expression": "HCT-CI = arrhythmia 1 + cardiac 1 + inflammatory_bowel_disease 1 + diabetes 1 + cerebrovascular_disease 1 + psychiatric_disturbance 1 + mild_hepatic 1 + obesity 1 + infection 1 + rheumatologic 2 + peptic_ulcer 2 + moderate_severe_renal 2 + moderate_pulmonary 2 + prior_solid_tumor 3 + heart_valve_disease 3 + severe_pulmonary 3 + moderate_severe_hepatic 3; Sorror 2005 HCT-CI weights; max 26; pulmonary moderate vs severe exclusive; hepatic mild vs moderate/severe exclusive; risk groups 0 low / 1-2 intermediate / >=3 high",
"max_score": 26,
"score": 0,
"risk_group": "low"
}
]
}
Response
| Field | Type | Description |
|---|---|---|
formula |
string | hct_ci |
formula_expression |
string | Exact expression used |
score |
integer | HCT-CI points 0-26 |
max_score |
integer | 26 |
risk_group |
string | low when score is 0, intermediate when 1-2, high when ≥3 (Sorror 2005). A group, not a diagnosis and not a transplant listing. |
components |
array | Per-comorbidity points |
citation |
object | Sorror et al. Blood 2005 citation |
disclaimer |
string | Not-a-device notice |
Example JSON
Machine form of the same example. Frozen fixture. Not a live lookup.
{
"components": [
{
"factor": "arrhythmia",
"points": 0,
"present": false
},
{
"factor": "cardiac",
"points": 0,
"present": false
},
{
"factor": "inflammatory_bowel_disease",
"points": 0,
"present": false
},
{
"factor": "diabetes",
"points": 0,
"present": false
},
{
"factor": "cerebrovascular_disease",
"points": 0,
"present": false
},
{
"factor": "psychiatric_disturbance",
"points": 0,
"present": false
},
{
"factor": "mild_hepatic",
"points": 0,
"present": false
},
{
"factor": "obesity",
"points": 0,
"present": false
},
{
"factor": "infection",
"points": 0,
"present": false
},
{
"factor": "rheumatologic",
"points": 0,
"present": false
},
{
"factor": "peptic_ulcer",
"points": 0,
"present": false
},
{
"factor": "moderate_severe_renal",
"points": 0,
"present": false
},
{
"factor": "moderate_pulmonary",
"points": 0,
"present": false
},
{
"factor": "prior_solid_tumor",
"points": 0,
"present": false
},
{
"factor": "heart_valve_disease",
"points": 0,
"present": false
},
{
"factor": "severe_pulmonary",
"points": 0,
"present": false
},
{
"factor": "moderate_severe_hepatic",
"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.",
"citation": {
"authors": "Sorror ML, Maris MB, Storb R, et al.",
"doi": "10.1182/blood-2005-05-2004",
"id": "sorror-2005",
"pmid": "15994282",
"source": "Blood. 2005;106(9):2912-2919",
"title": "Hematopoietic cell transplantation (HCT)-specific comorbidity index: a new tool for risk assessment before allogeneic HCT"
},
"formula": "hct_ci",
"formula_expression": "HCT-CI = arrhythmia 1 + cardiac 1 + inflammatory_bowel_disease 1 + diabetes 1 + cerebrovascular_disease 1 + psychiatric_disturbance 1 + mild_hepatic 1 + obesity 1 + infection 1 + rheumatologic 2 + peptic_ulcer 2 + moderate_severe_renal 2 + moderate_pulmonary 2 + prior_solid_tumor 3 + heart_valve_disease 3 + severe_pulmonary 3 + moderate_severe_hepatic 3; Sorror 2005 HCT-CI weights; max 26; pulmonary moderate vs severe exclusive; hepatic mild vs moderate/severe exclusive; risk groups 0 low / 1-2 intermediate / >=3 high",
"max_score": 26,
"score": 0,
"risk_group": "low"
}
Client errors (HTTP 400)
Invalid params return 400 without charge. Shared HTTP 402 and 503 meanings: Payments.
| HTTP | Code | When |
|---|---|---|
| 400 | invalid_flag |
boolean clinical flags must be true or false Returned before settlement; you are not charged. |
| 400 | invalid_hct_ci |
each HCT-CI 2005 comorbidity must be scored as in Sorror 2005. Returned before settlement; you are not charged. |
| 400 | invalid_items |
POST body must be a JSON object with only an items array Returned before settlement; you are not charged. |
| 400 | invalid_item_count |
items must be an array of 1 to 25 objects Returned before settlement; you are not charged. |
| 400 | invalid_item |
each items entry must be a JSON object Returned before settlement; you are not charged. |
Related tools
- Charlson CCI — Sum the nineteen Charlson 1987 original comorbidity weights and return the published 1-year mortality group.
Payment
Unpaid requests return HTTP 402 even if query parameters or POST items are missing or invalid, so CDP and agents can index the path. After a PAYMENT-SIGNATURE, invalid params return HTTP 400 JSON before settlement. magent does not charge. Fix the params, then request a new 402 quote for that complete URL. Catalog misses (empty matches, found=false) are valid paid 200s. Unpaid valid requests return HTTP 402 with a base64
PAYMENT-REQUIRED
header. HTTP 503 is not a new quote: retry the same PAYMENT-SIGNATURE. Full handshake
and shared payment errors: Payments.
Stdio MCP: /docs/mcp.
Guarantees
- HTTP 402 is unpaid, including a missing query. After PAYMENT-SIGNATURE, invalid parameters return HTTP 400 before settlement. You are not charged. HTTP 402 never includes the tool JSON.
- exact: settlement finishes before the tool (paymentFlow upfront). batch-settlement: verify/deposit before the tool; chargedCumulativeAmount commits after HTTP 2xx. Uncertain or failed settlement fails closed (HTTP 503). Retry the same PAYMENT-SIGNATURE.
- HTTP 402 is unpaid only. Do not sign a second authorization because of a 503.
- Execution is timeout-bounded and concurrency-capped.
- Calculator inputs are stored encrypted for allowlisted operators (Magent Console). They are not in public logs, SSH lookups, catalog, or rollups. Request logs store path without query.