Skip to main content

MedCalc MCP Server

A comprehensive medical calculation MCP (Model Context Protocol) server providing 59 clinical tools for healthcare professionals and AI assistants.

Installation

pip install medcalc

Usage

Start the MCP server:

medcalc

Claude Desktop / uvx Integration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "medcalc": {
      "command": "uvx",
      "args": ["medcalc@latest"]
    }
  }
}

Available Tools (59)

Renal Function

Tool Description
egfr_epi eGFR using 2021 CKD-EPI Creatinine equation
egfr_epi_cr_cys eGFR using 2021 CKD-EPI Creatinine-Cystatin C equation
mdrd_gfr GFR using MDRD equation
crcl_cockcroft_gault Creatinine Clearance (Cockcroft-Gault)
fractional_excretion_of_sodium FENa for AKI evaluation
free_water_deficit Free water deficit for hypernatremia

Electrolytes & ABG

Tool Description
corrected_calcium Calcium corrected for albumin
corrected_sodium_katz Corrected sodium (Katz formula)
corrected_sodium_hillier Corrected sodium (Hillier formula)
serum_anion_gap Serum anion gap with delta-delta
serum_osmolarity Serum osmolarity (calculated)
anion_gap_delta_delta Delta-delta ratio for mixed acid-base disorders
aa_gradient A-a gradient
winters_formula Winter's formula for expected pCO2

Anthropometrics & Fluids

Tool Description
bmi_calculator Body Mass Index
bsa_calculator Body Surface Area (Mosteller)
ibw_calculator Ideal Body Weight (Devine)
abw_calculator Adjusted Body Weight
maintenance_fluids IV maintenance fluids (4-2-1 rule)
ventilator_tidal_volume IBW-based tidal volume (6-8 mL/kg)

Cardiovascular Risk

Tool Description
framingham_risk_score 10-year CHD risk (Framingham)
prevent_cvd_risk AHA PREVENT 10-year CVD risk
ascvd_10yr_risk ACC/AHA Pooled Cohort ASCVD risk
revised_cardiac_risk_index RCRI for pre-operative cardiac risk
heart_score HEART score for chest pain evaluation
duke_activity_status_index DASI functional capacity (METs)
gupta_perioperative_mica Gupta perioperative MI/cardiac arrest risk

Cardiac & Vascular

Tool Description
map_calculator Mean Arterial Pressure
qtc_calculator Corrected QT Interval (Bazett, Fridericia, etc.)
chads2_vasc_score CHA₂DS₂-VASc stroke risk
has_bled_score HAS-BLED bleeding risk
grace_acs_score GRACE ACS mortality risk
timi_stemi TIMI score for STEMI
timi_nstemi TIMI score for NSTEMI/UA

Pulmonary & VTE

Tool Description
wells_pe_criteria Wells' criteria for PE
wells_dvt_criteria Wells' criteria for DVT
perc_rule PERC rule for PE exclusion
ariscat_score ARISCAT postoperative pulmonary complications
curb65_score CURB-65 for pneumonia severity
psi_port_score PSI/PORT score for CAP
stop_bang_score STOP-BANG for obstructive sleep apnea

Hepatology

Tool Description
child_pugh_score Child-Pugh cirrhosis classification
meld_3 MELD 3.0 score
fib4_index FIB-4 index for liver fibrosis

Critical Care

Tool Description
sofa_score Sequential Organ Failure Assessment
apache2_score APACHE II ICU severity
sepsis_criteria qSOFA / SIRS / Sepsis-3 criteria
glasgow_coma_scale Glasgow Coma Scale
news2_score National Early Warning Score 2

Neurology & Psychiatry

Tool Description
nihss_score NIH Stroke Scale
phq9_score PHQ-9 depression screening
gad7_score GAD-7 anxiety screening
ciwa_ar_score CIWA-Ar alcohol withdrawal

Pediatrics

Tool Description
bp_children Pediatric blood pressure percentiles
pecarn_pediatric_head_injury PECARN pediatric head CT decision rule

Hematology & Surgery

Tool Description
caprini_score Caprini VTE risk in surgical patients
centor_score_modified Modified Centor (McIsaac) for pharyngitis
ldl_calculated LDL cholesterol (Friedewald)
homa_ir HOMA-IR insulin resistance

Pharmacology

Tool Description
steroid_conversion Corticosteroid dose conversion
calculate_mme Morphine Milligram Equivalents
infusion_rate Universal IV drug infusion rate calculator (mL/h)

Obstetrics

Tool Description
pregnancy_calculator Pregnancy due date calculations

License

MIT

Metadata

Release files for medcalc 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for medcalc 0.4.0
File Size Uploaded Provenance Actions
medcalc-0.4.0.tar.gz 79.9 kB Without provenance Details for medcalc-0.4.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for medcalc 0.4.0
File Interpreter ABI Platform Actions
medcalc-0.4.0-py3-none-any.whl Python 3 none any Details for medcalc-0.4.0-py3-none-any.whl

Total release size: 158.8 kB

Release files / medcalc-0.4.0.tar.gz

Download URL medcalc-0.4.0.tar.gz
Size 79.9 kB
Tags Source
SHA-256 checksum
How to use checksums
669e3f04f316203ae03b4c2304157efcc48251f1755f2720755f6c253cc5d92f
BLAKE2b-256 checksum
How to use checksums
14510a9d18d3e7dcd87fd88be7a336c479ba3ea2b49c8b929091161cf8644384
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.9

Release files / medcalc-0.4.0-py3-none-any.whl

Download URL medcalc-0.4.0-py3-none-any.whl
Size 78.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e9b7ce7396cae168543e884a08a7d9b41c730d68e0028d24ee005485ddd68684
BLAKE2b-256 checksum
How to use checksums
46b6bf48f5a90f9a561f3ed243fb0c37bd81e0a0f2d137b8c56ff5b524a42158
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.9

Security for medcalc 0.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page