Infection / VTE · LIVE

VACS-CCI (McGinnis 2024)

Compute the McGinnis 2024 Table 2 Model 7 VACS-CCI Cox linear predictor from caller-assigned sex, age, VACS Index 2.0 biomarkers (hemoglobin, FIB-4, eGFR, albumin, WBC, BMI), hepatitis C, and Charlson comorbidity groupings. CD4 and HIV-1 RNA are not inputs.

LIVE $0.005 USDC GET /api/calc/vacs_cci

Markdown: /docs/vacs-cci.md · Canonical: https://magentlab.com/docs/vacs-cci

Not a medical device. Not a diagnosis, dose, or listing recommendation.

What it computes

Compute the McGinnis 2024 Table 2 Model 7 VACS-CCI Cox linear predictor from caller-assigned sex, age, VACS Index 2.0 biomarkers (hemoglobin, FIB-4, eGFR, albumin, WBC, BMI), hepatitis C, and Charlson comorbidity groupings. CD4 and HIV-1 RNA are not inputs.

When to use

When an agent already has those caller-assigned values and needs the published Table 2 linear predictor. magent does not code ICD comorbidities, compute FIB-4 or eGFR, or invent the unpublished 0-100 score transform.

When not to use

• Not a medical device and not a diagnosis or prognosis for an individual patient. magent does not assign comorbidities or code the chart.
• Table 2 Model 7 is the linear predictor. The 0-100 VACS-CCI score divides Xbeta by the unpublished development min-max range. magent does not invent that scale. The paper prints 0-100 score 30 → 1%, 3%, 8%, 18% and score 45 → 6%, 14%, 35%, 61% at 1/2/5/10 years. No baseline survival S0.
• Extreme values were replaced with 1st or 99th percentiles in the paper; those percentiles are not published, so magent does not winsorize.
• FIB-4 and eGFR are caller-assigned. magent does not recompute FIB-4 and does not compute CKD-EPI.
• The 2025 corrigendum (PMID 39845833) corrects Figure 4 interpretation only. Table 2 coefficients are unchanged.

Formula

lp = sex_female -0.513 + age_poly(X=age-50, 0.278/0.006/-0.001) + hb_poly(X=hemoglobin-14, -0.115/0.024/0.004) + fib4_poly(X, 0.205/-0.006) + egfr_poly(X=egfr-90, 0.071/0.036/0.002) + alb_poly(X=albumin-4, -0.405/0.326/0.156) + wbc_poly(X=WBC-4, -0.011/0.053/-0.008/0.000) + bmi_poly(X=BMI-25, -0.061/0.005/0.000) + hepatitis_c 0.273 + Table 2 Charlson condition coefficients + CCI-group x age-band interaction (CCI 0/1/2/3+ by <50, 50-64, 65-79, 80+; CCI 1 x 50-64 is reference 0); cci_group from caller-assigned condition weights (MI 1, CHF 1, PVD 1, CVD 1, dementia 1, pulmonary 1, rheumatic 1, PUD 1, DM without 1, DM with 2, hemiplegia 2, kidney mild-to-moderate 2, kidney severe 2, any malignancy 2, metastatic 6, liver mild 1, liver moderate-to-severe 3); McGinnis 2024 Table 2 Model 7; 1st/99th percentile winsorizing not published; 0-100 score uses unpublished development min/max Xbeta so magent does not scale; paper prints 0-100 score 30 → 1-year 1%, 2-year 3%, 5-year 8%, 10-year 18% and score 45 → 6%, 14%, 35%, 61%; no published S0; 2025 corrigendum PMID 39845833 does not change Table 2 coefficients; caller-assigned comorbidities, FIB-4, and eGFR

Citation

Title

Combining Charlson comorbidity and VACS indices improves prognostic accuracy for all-cause mortality for patients with and without HIV in the Veterans Health Administration

Authors

McGinnis KA, Justice AC, Marconi VC, et al.

Source

Front Med (Lausanne). 2024;10:1342466

DOI

10.3389/fmed.2023.1342466

Worked example

Also searched as

• VACS-CCI
• McGinnis 2024 VACS-CCI
• Veterans Aging Cohort Charlson
• VACS Index Charlson
• VACS-CCI Model 7
• Charlson VACS mortality index

Try

Opens the live endpoint. Unpaid browser requests show the paywall; agents should send Accept: application/json.

/api/calc/vacs_cci?sex=male&age=55&hemoglobin_g_dl=14&fib4=1.0&egfr_ml_min_1_73m2=90&albumin_g_dl=4&wbc_10e9_l=4&bmi_kg_m2=25&hepatitis_c=false&myocardial_infarction=false&congestive_heart_failure=false&peripheral_vascular_disease=false&cerebrovascular_disease=false&dementia=false&chronic_pulmonary_disease=false&rheumatic_disease=false&peptic_ulcer_disease=false&diabetes_without_complications=false&diabetes_with_complications=false&hemiplegia_or_paraplegia=false&kidney_mild_to_moderate=false&kidney_severe=false&any_malignancy=false&metastatic_solid_tumor=false&liver_mild=false&liver_moderate_to_severe=false

Full URL: https://api.magentlab.com/api/calc/vacs_cci?sex=male&age=55&hemoglobin_g_dl=14&fib4=1.0&egfr_ml_min_1_73m2=90&albumin_g_dl=4&wbc_10e9_l=4&bmi_kg_m2=25&hepatitis_c=false&myocardial_infarction=false&congestive_heart_failure=false&peripheral_vascular_disease=false&cerebrovascular_disease=false&dementia=false&chronic_pulmonary_disease=false&rheumatic_disease=false&peptic_ulcer_disease=false&diabetes_without_complications=false&diabetes_with_complications=false&hemiplegia_or_paraplegia=false&kidney_mild_to_moderate=false&kidney_severe=false&any_malignancy=false&metastatic_solid_tumor=false&liver_mild=false&liver_moderate_to_severe=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/vacs_cci?sex=male&age=55&hemoglobin_g_dl=14&fib4=1.0&egfr_ml_min_1_73m2=90&albumin_g_dl=4&wbc_10e9_l=4&bmi_kg_m2=25&hepatitis_c=false&myocardial_infarction=false&congestive_heart_failure=false&peripheral_vascular_disease=false&cerebrovascular_disease=false&dementia=false&chronic_pulmonary_disease=false&rheumatic_disease=false&peptic_ulcer_disease=false&diabetes_without_complications=false&diabetes_with_complications=false&hemiplegia_or_paraplegia=false&kidney_mild_to_moderate=false&kidney_severe=false&any_malignancy=false&metastatic_solid_tumor=false&liver_mild=false&liver_moderate_to_severe=false"

Parameters

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.

POST /api/calc/vacs_cci Max 25 unit_amount + extra_item_amount * (n - 1) extra $0.002 PREVIEW

• 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": [
    {
      "age": "55",
      "albumin_g_dl": "4",
      "any_malignancy": "false",
      "bmi_kg_m2": "25",
      "cerebrovascular_disease": "false",
      "chronic_pulmonary_disease": "false",
      "congestive_heart_failure": "false",
      "dementia": "false",
      "diabetes_with_complications": "false",
      "diabetes_without_complications": "false",
      "egfr_ml_min_1_73m2": "90",
      "fib4": "1.0",
      "hemiplegia_or_paraplegia": "false",
      "hemoglobin_g_dl": "14",
      "hepatitis_c": "false",
      "kidney_mild_to_moderate": "false",
      "kidney_severe": "false",
      "liver_mild": "false",
      "liver_moderate_to_severe": "false",
      "metastatic_solid_tumor": "false",
      "myocardial_infarction": "false",
      "peptic_ulcer_disease": "false",
      "peripheral_vascular_disease": "false",
      "rheumatic_disease": "false",
      "sex": "male",
      "wbc_10e9_l": "4"
    },
    {
      "age": "55",
      "albumin_g_dl": "4",
      "any_malignancy": "false",
      "bmi_kg_m2": "25",
      "cerebrovascular_disease": "false",
      "chronic_pulmonary_disease": "false",
      "congestive_heart_failure": "false",
      "dementia": "false",
      "diabetes_with_complications": "false",
      "diabetes_without_complications": "false",
      "egfr_ml_min_1_73m2": "90",
      "fib4": "1.0",
      "hemiplegia_or_paraplegia": "false",
      "hemoglobin_g_dl": "14",
      "hepatitis_c": "false",
      "kidney_mild_to_moderate": "false",
      "kidney_severe": "false",
      "liver_mild": "false",
      "liver_moderate_to_severe": "false",
      "metastatic_solid_tumor": "false",
      "myocardial_infarction": "false",
      "peptic_ulcer_disease": "false",
      "peripheral_vascular_disease": "false",
      "rheumatic_disease": "false",
      "sex": "male",
      "wbc_10e9_l": "4"
    }
  ]
}

Open bulk paywall →

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/vacs_cci",
  "items": [
    {
      "congestive_heart_failure": false,
      "formula_expression": "lp = sex_female -0.513 + age_poly(X=age-50, 0.278/0.006/-0.001) + hb_poly(X=hemoglobin-14, -0.115/0.024/0.004) + fib4_poly(X, 0.205/-0.006) + egfr_poly(X=egfr-90, 0.071/0.036/0.002) + alb_poly(X=albumin-4, -0.405/0.326/0.156) + wbc_poly(X=WBC-4, -0.011/0.053/-0.008/0.000) + bmi_poly(X=BMI-25, -0.061/0.005/0.000) + hepatitis_c 0.273 + Table 2 Charlson condition coefficients + CCI-group x age-band interaction (CCI 0/1/2/3+ by <50, 50-64, 65-79, 80+; CCI 1 x 50-64 is reference 0); cci_group from caller-assigned condition weights (MI 1, CHF 1, PVD 1, CVD 1, dementia 1, pulmonary 1, rheumatic 1, PUD 1, DM without 1, DM with 2, hemiplegia 2, kidney mild-to-moderate 2, kidney severe 2, any malignancy 2, metastatic 6, liver mild 1, liver moderate-to-severe 3); McGinnis 2024 Table 2 Model 7; 1st/99th percentile winsorizing not published; 0-100 score uses unpublished development min/max Xbeta so magent does not scale; paper prints 0-100 score 30 → 1-year 1%, 2-year 3%, 5-year 8%, 10-year 18% and score 45 → 6%, 14%, 35%, 61%; no published S0; 2025 corrigendum PMID 39845833 does not change Table 2 coefficients; caller-assigned comorbidities, FIB-4, and eGFR",
      "kidney_severe": false,
      "kidney_mild_to_moderate": false,
      "hemiplegia_or_paraplegia": false,
      "rheumatic_disease": false,
      "liver_moderate_to_severe": false,
      "any_malignancy": false,
      "myocardial_infarction": false,
      "bmi_kg_m2": 25.0,
      "albumin_g_dl": 4.0,
      "egfr_ml_min_1_73m2": 90.0,
      "dementia": false,
      "peptic_ulcer_disease": false,
      "fib4": 1.0,
      "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.",
      "peripheral_vascular_disease": false,
      "sex": "male",
      "citation": {
        "authors": "McGinnis KA, Justice AC, Marconi VC, et al.",
        "doi": "10.3389/fmed.2023.1342466",
        "id": "mcginnis-2024-vacs-cci",
        "pmid": "38356736",
        "source": "Front Med (Lausanne). 2024;10:1342466",
        "title": "Combining Charlson comorbidity and VACS indices improves prognostic accuracy for all-cause mortality for patients with and without HIV in the Veterans Health Administration"
      },
      "wbc_10e9_l": 4.0,
      "hepatitis_c": false,
      "liver_mild": false,
      "cci_group": "0",
      "hemoglobin_g_dl": 14.0,
      "cerebrovascular_disease": false,
      "cci_score": 0,
      "age": 55,
      "formula": "vacs_cci",
      "chronic_pulmonary_disease": false,
      "diabetes_with_complications": false,
      "linear_predictor": 1.228,
      "diabetes_without_complications": false,
      "metastatic_solid_tumor": false,
      "age_band": "50_64"
    },
    {
      "congestive_heart_failure": false,
      "formula_expression": "lp = sex_female -0.513 + age_poly(X=age-50, 0.278/0.006/-0.001) + hb_poly(X=hemoglobin-14, -0.115/0.024/0.004) + fib4_poly(X, 0.205/-0.006) + egfr_poly(X=egfr-90, 0.071/0.036/0.002) + alb_poly(X=albumin-4, -0.405/0.326/0.156) + wbc_poly(X=WBC-4, -0.011/0.053/-0.008/0.000) + bmi_poly(X=BMI-25, -0.061/0.005/0.000) + hepatitis_c 0.273 + Table 2 Charlson condition coefficients + CCI-group x age-band interaction (CCI 0/1/2/3+ by <50, 50-64, 65-79, 80+; CCI 1 x 50-64 is reference 0); cci_group from caller-assigned condition weights (MI 1, CHF 1, PVD 1, CVD 1, dementia 1, pulmonary 1, rheumatic 1, PUD 1, DM without 1, DM with 2, hemiplegia 2, kidney mild-to-moderate 2, kidney severe 2, any malignancy 2, metastatic 6, liver mild 1, liver moderate-to-severe 3); McGinnis 2024 Table 2 Model 7; 1st/99th percentile winsorizing not published; 0-100 score uses unpublished development min/max Xbeta so magent does not scale; paper prints 0-100 score 30 → 1-year 1%, 2-year 3%, 5-year 8%, 10-year 18% and score 45 → 6%, 14%, 35%, 61%; no published S0; 2025 corrigendum PMID 39845833 does not change Table 2 coefficients; caller-assigned comorbidities, FIB-4, and eGFR",
      "kidney_severe": false,
      "kidney_mild_to_moderate": false,
      "hemiplegia_or_paraplegia": false,
      "rheumatic_disease": false,
      "liver_moderate_to_severe": false,
      "any_malignancy": false,
      "myocardial_infarction": false,
      "bmi_kg_m2": 25.0,
      "albumin_g_dl": 4.0,
      "egfr_ml_min_1_73m2": 90.0,
      "dementia": false,
      "peptic_ulcer_disease": false,
      "fib4": 1.0,
      "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.",
      "peripheral_vascular_disease": false,
      "sex": "male",
      "citation": {
        "authors": "McGinnis KA, Justice AC, Marconi VC, et al.",
        "doi": "10.3389/fmed.2023.1342466",
        "id": "mcginnis-2024-vacs-cci",
        "pmid": "38356736",
        "source": "Front Med (Lausanne). 2024;10:1342466",
        "title": "Combining Charlson comorbidity and VACS indices improves prognostic accuracy for all-cause mortality for patients with and without HIV in the Veterans Health Administration"
      },
      "wbc_10e9_l": 4.0,
      "hepatitis_c": false,
      "liver_mild": false,
      "cci_group": "0",
      "hemoglobin_g_dl": 14.0,
      "cerebrovascular_disease": false,
      "cci_score": 0,
      "age": 55,
      "formula": "vacs_cci",
      "chronic_pulmonary_disease": false,
      "diabetes_with_complications": false,
      "linear_predictor": 1.228,
      "diabetes_without_complications": false,
      "metastatic_solid_tumor": false,
      "age_band": "50_64"
    }
  ]
}

Response

Example JSON

Machine form of the same example. Frozen fixture. Not a live lookup.

{
  "congestive_heart_failure": false,
  "formula_expression": "lp = sex_female -0.513 + age_poly(X=age-50, 0.278/0.006/-0.001) + hb_poly(X=hemoglobin-14, -0.115/0.024/0.004) + fib4_poly(X, 0.205/-0.006) + egfr_poly(X=egfr-90, 0.071/0.036/0.002) + alb_poly(X=albumin-4, -0.405/0.326/0.156) + wbc_poly(X=WBC-4, -0.011/0.053/-0.008/0.000) + bmi_poly(X=BMI-25, -0.061/0.005/0.000) + hepatitis_c 0.273 + Table 2 Charlson condition coefficients + CCI-group x age-band interaction (CCI 0/1/2/3+ by <50, 50-64, 65-79, 80+; CCI 1 x 50-64 is reference 0); cci_group from caller-assigned condition weights (MI 1, CHF 1, PVD 1, CVD 1, dementia 1, pulmonary 1, rheumatic 1, PUD 1, DM without 1, DM with 2, hemiplegia 2, kidney mild-to-moderate 2, kidney severe 2, any malignancy 2, metastatic 6, liver mild 1, liver moderate-to-severe 3); McGinnis 2024 Table 2 Model 7; 1st/99th percentile winsorizing not published; 0-100 score uses unpublished development min/max Xbeta so magent does not scale; paper prints 0-100 score 30 → 1-year 1%, 2-year 3%, 5-year 8%, 10-year 18% and score 45 → 6%, 14%, 35%, 61%; no published S0; 2025 corrigendum PMID 39845833 does not change Table 2 coefficients; caller-assigned comorbidities, FIB-4, and eGFR",
  "kidney_severe": false,
  "kidney_mild_to_moderate": false,
  "hemiplegia_or_paraplegia": false,
  "rheumatic_disease": false,
  "liver_moderate_to_severe": false,
  "any_malignancy": false,
  "myocardial_infarction": false,
  "bmi_kg_m2": 25.0,
  "albumin_g_dl": 4.0,
  "egfr_ml_min_1_73m2": 90.0,
  "dementia": false,
  "peptic_ulcer_disease": false,
  "fib4": 1.0,
  "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.",
  "peripheral_vascular_disease": false,
  "sex": "male",
  "citation": {
    "authors": "McGinnis KA, Justice AC, Marconi VC, et al.",
    "doi": "10.3389/fmed.2023.1342466",
    "id": "mcginnis-2024-vacs-cci",
    "pmid": "38356736",
    "source": "Front Med (Lausanne). 2024;10:1342466",
    "title": "Combining Charlson comorbidity and VACS indices improves prognostic accuracy for all-cause mortality for patients with and without HIV in the Veterans Health Administration"
  },
  "wbc_10e9_l": 4.0,
  "hepatitis_c": false,
  "liver_mild": false,
  "cci_group": "0",
  "hemoglobin_g_dl": 14.0,
  "cerebrovascular_disease": false,
  "cci_score": 0,
  "age": 55,
  "formula": "vacs_cci",
  "chronic_pulmonary_disease": false,
  "diabetes_with_complications": false,
  "linear_predictor": 1.228,
  "diabetes_without_complications": false,
  "metastatic_solid_tumor": false,
  "age_band": "50_64"
}

Client errors (HTTP 400)

Invalid params return 400 without charge. Shared HTTP 402 and 503 meanings: Payments.

Related tools

• VACS 2.0 — Compute the Tate 2019 VACS Index 2.0 score for 5-year all-cause mortality from age, CD4, HIV-1 RNA, hemoglobin, caller-assigned FIB-4 and eGFR, hepatitis C, albumin, WBC, and BMI using Appendix Table 1 coefficients.
• 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.