199-mcp/mcp-phenoage-clock

MCP PhenoAge Clock Server

An MCP (Model Context Protocol) server that calculates biological age using the Morgan Levine PhenoAge clock based on blood biomarkers.

Overview

The PhenoAge clock is a biological aging measure developed by Dr. Morgan Levine and colleagues. It uses 9 blood biomarkers plus chronological age to estimate "phenotypic age" - a measure that captures morbidity and mortality risk better than chronological age alone.

Based on: Levine et al. (2018) "An epigenetic biomarker of aging for lifespan and healthspan" Aging (Albany NY). 2018;10(4):573-591

Installation

Via NPX (Recommended)

npx mcp-phenoage-clock

Via NPM

npm install -g mcp-phenoage-clock
mcp-phenoage-clock

From Source

git clone https://github.com/199-biotechnologies/mcp-phenoage-clock.git
cd mcp-phenoage-clock
npm install
npm run build
npm start

Usage with Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "phenoage-clock": {
      "command": "npx",
      "args": ["mcp-phenoage-clock"]
    }
  }
}

Available Tools

calculate_phenoage

Calculates your biological age using the PhenoAge formula.

Required biomarkers:

• age: Chronological age (years)
• albumin: Albumin (g/dL)
• creatinine: Creatinine (mg/dL)
• glucose: Glucose (mg/dL) - must be fasting
• crp: C-reactive protein (mg/L)
• lymphocytePercent: Lymphocyte percentage (%)
• meanCellVolume: Mean cell volume/MCV (fL)
• redCellDistWidth: Red cell distribution width/RDW (%)
• alkalinePhosphatase: Alkaline phosphatase (U/L)
• whiteBloodCellCount: White blood cell count (1000 cells/μL)

Returns:

• PhenoAge (biological age)
• Age difference (PhenoAge - chronological age)
• Mortality score
• Interpretation

get_biomarker_ranges

Returns reference ranges and optimal values for all biomarkers.

Example Usage in Claude

User: Calculate my PhenoAge with these values:
- Age: 45
- Albumin: 4.2 g/dL
- Creatinine: 0.9 mg/dL
- Glucose: 85 mg/dL
- CRP: 0.5 mg/L
- Lymphocyte %: 30
- MCV: 89 fL
- RDW: 12.5%
- Alkaline phosphatase: 65 U/L
- WBC: 6.2

Claude will use the calculate_phenoage tool and return your biological age.

Understanding Your Results

• PhenoAge < Chronological Age: Your biological age is younger than your actual age, suggesting good health
• PhenoAge ≈ Chronological Age: Normal aging pattern
• PhenoAge > Chronological Age: Your biological age is older than your actual age, suggesting accelerated aging

Important Notes

1. Fasting Glucose: The glucose measurement must be taken after fasting
2. Units Matter: Ensure your lab results match the required units
3. Medical Advice: This tool is for informational purposes only. Always consult healthcare providers for medical decisions
4. Lab Variations: Different labs may use different reference ranges
5. Formula Limitations: In rare cases with certain biomarker combinations, the mortality score may reach mathematical limits, resulting in clamped calculations. This is a limitation of the formula, not necessarily indicative of health status

Formula Details

The PhenoAge calculation uses the following formula:

xb = -19.907 - 0.0336×albumin + 0.0095×creatinine + 0.1953×glucose 
     + 0.0954×ln(CRP) - 0.0120×lymphocyte% + 0.0268×MCV 
     + 0.3306×RDW + 0.00188×alkaline_phosphatase + 0.0554×WBC + 0.0804×age

mortality_score = 1 - exp(-exp(xb) × (exp(120×γ) - 1) / γ)
where γ = 0.0076927

PhenoAge = 141.50225 + ln(-0.00553 × ln(1 - mortality_score)) / 0.090165

Development

# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev

License

MIT

Contributing

Contributions welcome! Please submit PRs to the GitHub repository.

References

• Levine ME, Lu AT, Quach A, et al. An epigenetic biomarker of aging for lifespan and healthspan. Aging (Albany NY). 2018;10(4):573-591.
• Original paper supplementary materials: Table S6 contains the full coefficient values