Clinical Calculators Tools

Configuration File: clinical_calculators_tools.json Tool Type: Local Tools Count: 10

This page contains all tools defined in the clinical_calculators_tools.json configuration file.

Available Tools

ClinicalCalc_ASCVD_risk (Type: ClinicalCalculatorTool)

10-year atherosclerotic cardiovascular disease (ASCVD) risk by the 2013 ACC/AHA Pooled Cohort Equ…

ClinicalCalc_ASCVD_risk tool specification

Tool Information:

  • Name: ClinicalCalc_ASCVD_risk

  • Type: ClinicalCalculatorTool

  • Description: 10-year atherosclerotic cardiovascular disease (ASCVD) risk by the 2013 ACC/AHA Pooled Cohort Equations (Goff 2013). Validated for ages 40-79. Returns risk percent and category (low/borderline/intermediate/high) used to guide statin therapy. Inputs: age, total and HDL cholesterol, systolic BP (treated or not), smoking, diabetes, sex, and race (White/African American).

Parameters:

  • age (number) (required) Age in years (40-79)

  • total_cholesterol (number) (required) Total cholesterol in mg/dL

  • hdl_cholesterol (number) (required) HDL cholesterol in mg/dL

  • systolic_bp (number) (required) Systolic blood pressure in mmHg

  • bp_treated (boolean) (optional) Currently on blood-pressure-lowering medication

  • smoker (boolean) (optional) Current smoker

  • diabetes (boolean) (optional) Diabetes mellitus

  • female (boolean) (optional) Female sex

  • race (string) (optional) ‘white’ (or other) vs ‘black’/’African American’; affects the coefficient set

Example Usage:

query = {
    "name": "ClinicalCalc_ASCVD_risk",
    "arguments": {
        "age": "example_value",
        "total_cholesterol": "example_value",
        "hdl_cholesterol": "example_value",
        "systolic_bp": "example_value"
    }
}
result = tu.run(query)

ClinicalCalc_CHA2DS2_VASc (Type: ClinicalCalculatorTool)

CHA2DS2-VASc score: stroke risk in non-valvular atrial fibrillation, used to decide oral anticoag…

ClinicalCalc_CHA2DS2_VASc tool specification

Tool Information:

  • Name: ClinicalCalc_CHA2DS2_VASc

  • Type: ClinicalCalculatorTool

  • Description: CHA2DS2-VASc score: stroke risk in non-valvular atrial fibrillation, used to decide oral anticoagulation. Deterministic point score (0-9). Provide age plus boolean risk factors. Returns score, anticoagulation interpretation, and per-component points.

Parameters:

  • age (number) (required) Age in years

  • chf (boolean) (optional) Congestive heart failure / LV dysfunction

  • hypertension (boolean) (optional) History of hypertension

  • diabetes (boolean) (optional) Diabetes mellitus

  • stroke_history (boolean) (optional) Prior stroke, TIA, or thromboembolism (2 points)

  • vascular_disease (boolean) (optional) Vascular disease (prior MI, PAD, aortic plaque)

  • female (boolean) (optional) Female sex

Example Usage:

query = {
    "name": "ClinicalCalc_CHA2DS2_VASc",
    "arguments": {
        "age": "example_value"
    }
}
result = tu.run(query)

ClinicalCalc_CURB_65 (Type: ClinicalCalculatorTool)

CURB-65 score: community-acquired pneumonia severity and disposition (outpatient vs inpatient vs …

ClinicalCalc_CURB_65 tool specification

Tool Information:

  • Name: ClinicalCalc_CURB_65

  • Type: ClinicalCalculatorTool

  • Description: CURB-65 score: community-acquired pneumonia severity and disposition (outpatient vs inpatient vs ICU). Point score (0-5) from confusion, urea, respiratory rate, blood pressure, and age >=65.

Parameters:

  • age (number) (required) Age in years (>=65 scores 1)

  • confusion (boolean) (optional) New-onset confusion / altered mental status

  • elevated_urea (boolean) (optional) Blood urea nitrogen >7 mmol/L (>19 mg/dL BUN)

  • high_resp_rate (boolean) (optional) Respiratory rate >=30/min

  • low_bp (boolean) (optional) SBP <90 mmHg or DBP <=60 mmHg

Example Usage:

query = {
    "name": "ClinicalCalc_CURB_65",
    "arguments": {
        "age": "example_value"
    }
}
result = tu.run(query)

ClinicalCalc_Child_Pugh (Type: ClinicalCalculatorTool)

Child-Pugh score and class (A/B/C): severity of chronic liver disease / cirrhosis and surgical ri…

ClinicalCalc_Child_Pugh tool specification

Tool Information:

  • Name: ClinicalCalc_Child_Pugh

  • Type: ClinicalCalculatorTool

  • Description: Child-Pugh score and class (A/B/C): severity of chronic liver disease / cirrhosis and surgical risk. Sum (5-15) of bilirubin, albumin, INR, ascites, and encephalopathy points. Provide lab values and clinical grades.

Parameters:

  • bilirubin (number) (required) Total bilirubin in mg/dL

  • albumin (number) (required) Serum albumin in g/dL

  • inr (number) (required) INR (prothrombin time ratio)

  • ascites (string) (optional) Ascites severity. Accepted: ‘none’/’absent’ (1 pt), ‘mild’/’slight’ (2 pts), ‘moderate’/’severe’ (3 pts). Unrecognized values are rejected (no silent best-case default).

  • encephalopathy (string) (optional) Hepatic encephalopathy grade. Accepted: ‘none’/’absent’ (1 pt), ‘grade1-2’ (2 pts), ‘grade3-4’ (3 pts). Unrecognized values are rejected (no silent best-case default).

Example Usage:

query = {
    "name": "ClinicalCalc_Child_Pugh",
    "arguments": {
        "bilirubin": "example_value",
        "albumin": "example_value",
        "inr": "example_value"
    }
}
result = tu.run(query)

ClinicalCalc_HAS_BLED (Type: ClinicalCalculatorTool)

HAS-BLED score: 1-year major bleeding risk in patients with atrial fibrillation on anticoagulatio…

ClinicalCalc_HAS_BLED tool specification

Tool Information:

  • Name: ClinicalCalc_HAS_BLED

  • Type: ClinicalCalculatorTool

  • Description: HAS-BLED score: 1-year major bleeding risk in patients with atrial fibrillation on anticoagulation. Point score (0-9); >=3 indicates high risk warranting caution and review of reversible factors. Complements CHA2DS2-VASc.

Parameters:

  • age (number) (required) Age in years (>65 scores 1 point)

  • hypertension (boolean) (optional) Uncontrolled hypertension (SBP >160)

  • renal_disease (boolean) (optional) Abnormal renal function (dialysis, transplant, Cr >2.26 mg/dL)

  • liver_disease (boolean) (optional) Abnormal liver function (cirrhosis, bilirubin >2x or AST/ALT >3x normal)

  • stroke_history (boolean) (optional) Prior stroke

  • bleeding_history (boolean) (optional) Prior major bleeding or predisposition

  • labile_inr (boolean) (optional) Labile INR (unstable/high, TTR <60%)

  • drugs (boolean) (optional) Concomitant antiplatelet or NSAID use

  • alcohol (boolean) (optional) Alcohol >=8 drinks/week

Example Usage:

query = {
    "name": "ClinicalCalc_HAS_BLED",
    "arguments": {
        "age": "example_value"
    }
}
result = tu.run(query)

ClinicalCalc_MELD_Na (Type: ClinicalCalculatorTool)

MELD-Na score (UNOS/OPTN 2016): 90-day mortality risk in chronic liver disease and liver transpla…

ClinicalCalc_MELD_Na tool specification

Tool Information:

  • Name: ClinicalCalc_MELD_Na

  • Type: ClinicalCalculatorTool

  • Description: MELD-Na score (UNOS/OPTN 2016): 90-day mortality risk in chronic liver disease and liver transplant allocation priority. Range 6-40. Uses creatinine, bilirubin, INR, and sodium (with the standard lower/upper bounds and dialysis rule).

Parameters:

  • creatinine (number) (required) Serum creatinine in mg/dL (bounded 1.0-4.0; set to 4.0 if on dialysis)

  • bilirubin (number) (required) Total bilirubin in mg/dL (lower-bounded at 1.0)

  • inr (number) (required) INR (lower-bounded at 1.0)

  • sodium (number) (required) Serum sodium in mmol/L (bounded 125-137)

  • dialysis (boolean) (optional) Two or more dialysis sessions in the past week (forces creatinine to 4.0)

Example Usage:

query = {
    "name": "ClinicalCalc_MELD_Na",
    "arguments": {
        "creatinine": "example_value",
        "bilirubin": "example_value",
        "inr": "example_value",
        "sodium": "example_value"
    }
}
result = tu.run(query)

ClinicalCalc_Wells_DVT (Type: ClinicalCalculatorTool)

Wells score for deep vein thrombosis (DVT) pretest probability. Sum of clinical features (minus 2…

ClinicalCalc_Wells_DVT tool specification

Tool Information:

  • Name: ClinicalCalc_Wells_DVT

  • Type: ClinicalCalculatorTool

  • Description: Wells score for deep vein thrombosis (DVT) pretest probability. Sum of clinical features (minus 2 if an alternative diagnosis is as likely); score >=2 means DVT likely. Guides D-dimer vs ultrasound workup.

Parameters:

  • active_cancer (boolean) (optional) Active cancer (treatment within 6 months or palliative)

  • immobilization (boolean) (optional) Paralysis, paresis, or recent lower-limb immobilization

  • recent_surgery (boolean) (optional) Recently bedridden >=3 days or major surgery within 12 weeks

  • localized_tenderness (boolean) (optional) Localized tenderness along deep venous system

  • leg_swollen (boolean) (optional) Entire leg swollen

  • calf_swelling (boolean) (optional) Calf swelling >3 cm vs asymptomatic side

  • pitting_edema (boolean) (optional) Pitting edema confined to symptomatic leg

  • collateral_veins (boolean) (optional) Collateral superficial (non-varicose) veins

  • previous_dvt (boolean) (optional) Previously documented DVT

  • alternative_diagnosis (boolean) (optional) Alternative diagnosis at least as likely as DVT (subtracts 2)

Example Usage:

query = {
    "name": "ClinicalCalc_Wells_DVT",
    "arguments": {
    }
}
result = tu.run(query)

ClinicalCalc_Wells_PE (Type: ClinicalCalculatorTool)

Wells score for pulmonary embolism (PE) pretest probability. Weighted score giving three-tier (lo…

ClinicalCalc_Wells_PE tool specification

Tool Information:

  • Name: ClinicalCalc_Wells_PE

  • Type: ClinicalCalculatorTool

  • Description: Wells score for pulmonary embolism (PE) pretest probability. Weighted score giving three-tier (low/moderate/high) and two-tier (PE unlikely <=4 / likely >4) risk to guide D-dimer vs CT pulmonary angiography.

Parameters:

  • clinical_dvt (boolean) (optional) Clinical signs/symptoms of DVT (3 points)

  • pe_most_likely (boolean) (optional) PE is the most likely diagnosis (3 points)

  • tachycardia (boolean) (optional) Heart rate >100 bpm (1.5)

  • immobilization (boolean) (optional) Immobilization >=3 days or surgery within 4 weeks (1.5)

  • previous_vte (boolean) (optional) Previous DVT or PE (1.5)

  • hemoptysis (boolean) (optional) Hemoptysis (1)

  • malignancy (boolean) (optional) Malignancy treated within 6 months or palliative (1)

Example Usage:

query = {
    "name": "ClinicalCalc_Wells_PE",
    "arguments": {
    }
}
result = tu.run(query)

ClinicalCalc_eGFR_CKD_EPI (Type: ClinicalCalculatorTool)

Estimated glomerular filtration rate (eGFR) by the CKD-EPI 2021 creatinine equation (race-free, I…

ClinicalCalc_eGFR_CKD_EPI tool specification

Tool Information:

  • Name: ClinicalCalc_eGFR_CKD_EPI

  • Type: ClinicalCalculatorTool

  • Description: Estimated glomerular filtration rate (eGFR) by the CKD-EPI 2021 creatinine equation (race-free, Inker 2021), with CKD stage (G1-G5). Inputs: serum creatinine, age, sex. Reported in mL/min/1.73m^2.

Parameters:

  • creatinine (number) (required) Serum creatinine in mg/dL

  • age (number) (required) Age in years

  • female (boolean) (optional) Female sex

Example Usage:

query = {
    "name": "ClinicalCalc_eGFR_CKD_EPI",
    "arguments": {
        "creatinine": "example_value",
        "age": "example_value"
    }
}
result = tu.run(query)

ClinicalCalc_qSOFA (Type: ClinicalCalculatorTool)

qSOFA (quick SOFA): bedside identification of patients with suspected infection at higher risk of…

ClinicalCalc_qSOFA tool specification

Tool Information:

  • Name: ClinicalCalc_qSOFA

  • Type: ClinicalCalculatorTool

  • Description: qSOFA (quick SOFA): bedside identification of patients with suspected infection at higher risk of poor outcome. Point score (0-3); >=2 is concerning for sepsis. Uses respiratory rate, mentation, and systolic blood pressure only.

Parameters:

  • high_resp_rate (boolean) (optional) Respiratory rate >=22/min

  • altered_mentation (boolean) (optional) Altered mental status (GCS <15)

  • low_sbp (boolean) (optional) Systolic blood pressure <=100 mmHg

Example Usage:

query = {
    "name": "ClinicalCalc_qSOFA",
    "arguments": {
    }
}
result = tu.run(query)