Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_drug_volume_of_distribution

Calculate apparent volume of distribution and required loading dose from IV dose, extrapolated peak concentration, patient weight, and target plasma concentration.

Instructions

Apparent Volume of Distribution (Vd) & Loading Dose Calculator. Calculate apparent Volume of Distribution (Vd in L and L/kg) and determine exact intravenous or oral loading doses required to reach target plasma concentrations immediately. Discipline: BIOTECH. Governing mathematical model / formula: Vd = Dose_IV / C₀ | Loading Dose = (Target Plasma Conc · Vd) / Bioavailability (F).

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of apparent_volume_of_distribution_vd (Apparent Volume of Distribution (Vd)), normalized_vd_liters_per_kg (Normalized Vd (L/kg)), calculated_target_loading_dose (Required Loading Dose (IV)), tissue_binding_classification (Physiological Distribution Pattern) using administered_iv_dose_mg (Administered IV Bolus Dose (mg) in mg), extrapolated_peak_c0_mg_l (Extrapolated Peak Plasma Conc C₀ (mg/L) in mg/L), patient_body_weight_kg (Patient Weight (kg) in kg), desired_target_plasma_conc (Desired Target Plasma Level (mg/L) in mg/L). 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 'Apparent Volume of Distribution (Vd) & Loading Dose 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): "drug-volume-of-distribution"

    • category (string): "biotech"

    • name (string): "Apparent Volume of Distribution (Vd) & Loading Dose Calculator"

    • formula (string): Governing mathematical formula string

    • inputs (object): Echoed input parameter dictionary with applied defaults

    • metrics (object): Dictionary of computed outputs:

      • metrics.apparent_volume_of_distribution_vd (Apparent Volume of Distribution (Vd)): Formatted display string (e.g. '40.0 Liters')

      • metrics.normalized_vd_liters_per_kg (Normalized Vd (L/kg)): Formatted display string (e.g. '0.57 L/kg')

      • metrics.calculated_target_loading_dose (Required Loading Dose (IV)): Formatted display string (e.g. '600.0 mg Loading Dose')

      • metrics.tissue_binding_classification (Physiological Distribution Pattern): Formatted display string (e.g. 'Total Body Water Distribution (~0.6 L/kg)')

    • 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_drug_volume_of_distribution"
  }
}

Input Schema

NameRequiredDescriptionDefault
patient_body_weight_kgNoPatient Weight (kg) (kg). Patient weight to calculate normalized Vd (L/kg). Default: 70. Min: 10. Max: 250.
administered_iv_dose_mgNoAdministered IV Bolus Dose (mg) (mg). Intravenous dose administered at start of trial. Default: 500. Min: 1. Max: 10000.
extrapolated_peak_c0_mg_lNoExtrapolated Peak Plasma Conc C₀ (mg/L) (mg/L). Plasma level extrapolated back to time t=0. Default: 12.5. Min: 0.01. Max: 500.
desired_target_plasma_concNoDesired Target Plasma Level (mg/L) (mg/L). Therapeutic trough or peak target. Default: 15. Min: 0.1. Max: 500.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools