omni_cockcroft_gault_crcl
Calculates Cockcroft-Gault creatinine clearance to estimate renal function, classify impairment stage, and flag FDA renal dosing adjustments from patient age, weight, serum creatinine, and sex.
Instructions
Cockcroft-Gault Creatinine Clearance (CrCl) & Renal Dosing Calculator. Calculate estimated Creatinine Clearance (CrCl) via the standard Cockcroft-Gault equation for clinical pharmacokinetic drug dosing and renal impairment staging. Discipline: BIOTECH. Governing mathematical model / formula: CrCl (Male) = [(140 - Age) · Weight (kg)] / (72 · SCr) | CrCl (Female) = CrCl (Male) · 0.85.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of estimated_crcl_ml_min (Estimated Creatinine Clearance (CrCl)), ckd_renal_impairment_stage (Renal Function Impairment Classification), cleared_volume_24hr (Daily Filtered Blood Plasma), dosing_adjustment_alert (FDA Renal Dosing Advisory) using patient_age_years (Patient Age (Years) in years), patient_weight_kg (Actual Body Weight (kg) in kg), serum_creatinine_mg_dl (Serum Creatinine (SCr in mg/dL) in mg/dL), patient_sex_biological (Biological Sex (1=Male, 0=Female) in 1=M, 0=F). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'Cockcroft-Gault Creatinine Clearance (CrCl) & Renal Dosing Calculator' rather than generic dispatchers like omni_universal_query.
For multi-calculation chained jobs, use 'omni_batch_calculate'.
To inspect schema fields, see 'omni_describe_solver'.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "cockcroft-gault-crcl"
category (string): "biotech"
name (string): "Cockcroft-Gault Creatinine Clearance (CrCl) & Renal Dosing Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.estimated_crcl_ml_min (Estimated Creatinine Clearance (CrCl)): Formatted display string (e.g. '53.6 mL/min')
metrics.ckd_renal_impairment_stage (Renal Function Impairment Classification): Formatted display string (e.g. 'Moderate Renal Impairment (30-59 mL/min)')
metrics.cleared_volume_24hr (Daily Filtered Blood Plasma): Formatted display string (e.g. '77.1 Liters / Day')
metrics.dosing_adjustment_alert (FDA Renal Dosing Advisory): Formatted display string (e.g. 'Dose Reduction Required for Renally Cleared Drugs')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_cockcroft_gault_crcl"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| patient_age_years | No | Patient Age (Years) (years). Adult patient age. Default: 65. Min: 18. Max: 110. | |
| patient_weight_kg | No | Actual Body Weight (kg) (kg). Patient weight in kilograms (1 lb = 0.4536 kg). Default: 72. Min: 30. Max: 250. | |
| patient_sex_biological | No | Biological Sex (1=Male, 0=Female) (1=M, 0=F). Female factor multiplies result by 0.85 due to lower average muscle mass. Default: 1. Min: 0. Max: 1. | |
| serum_creatinine_mg_dl | No | Serum Creatinine (SCr in mg/dL) (mg/dL). Laboratory serum creatinine concentration. Default: 1.4. Min: 0.2. Max: 15. |