# Framingham Risk MCP

> Framingham Cardiovascular Risk Calculator calculates a patient's estimated 10-year risk of heart attack or stroke and determines their vascular age. This MCP uses established medical formulas, requiring inputs like blood pressure, cholesterol levels, smoking status, and diabetes history to give clinicians standardized health metrics.

## Overview
- **Category:** risk-assessment
- **Price:** Free
- **Tags:** cardiovascular, framingham, risk-score, vascular-age, heart-health

## Description

Knowing a patient’s actual cardiovascular risk means more than just taking vitals. The Framingham model gives doctors a reliable way to predict the probability of major cardiac events over ten years. This MCP helps you quantify that risk using detailed medical data, letting you move past general advice and toward actionable diagnoses. You input standard metrics—age, blood pressure, cholesterol, lifestyle factors—and get two key numbers: your 10-year risk percentage and a measure of arterial wear known as vascular age. All these calculations are housed within the Vinkius catalog, giving you access to standardized medical assessments without needing complex local software. You just connect your preferred AI client and start diagnosing.

## Tools

### calculate_ten_year_risk
Calculates a patient’s estimated 10-year cardiovascular probability using age, sex, cholesterol levels, blood pressure, smoking status, and diabetes status.

### estimate_vascular_age
Determines a patient's apparent arterial age based on total cholesterol, HDL-C, systolic blood pressure, and chronological age.

## Prompt Examples

**Prompt:** 
```
I am a 55-year-old male. My total cholesterol is 240 mg/dL, HDL-C is 45 mg/dL, and SBP is 135 mmHg. I smoke sometimes and have no diabetes. What is my risk?
```

**Response:** 
```
Based on the parameters provided, running `calculate_ten_year_risk` suggests a moderate risk classification for your 10-year outlook. It's important to monitor these numbers.
```

**Prompt:** 
```
Can you estimate my vascular age? I am 45, female, with total cholesterol of 210 and HDL-C of 60. My SBP is 120.
```

**Response:** 
```
Using the `estimate_vascular_age` tool, your estimated vascular age is [X] years. This suggests your arterial system appears to be [Y] years older/younger than your chronological age.
```

**Prompt:** 
```
I need a comprehensive risk assessment for an 68-year-old male. Inputs: Total Chol=270, HDL=35, SBP=160. Smoker and diabetic.
```

**Response:** 
```
I recommend running both `calculate_ten_year_risk` and `estimate_vascular_age`. The risk calculation will provide the 10-year probability, while the vascular age tool provides insight into your current arterial stress levels.
```

## Capabilities

### Calculate 10-Year Cardiovascular Risk
The tool calculates a patient’s probability of a major cardiac event over the next decade using seven key inputs.

### Estimate Vascular Age
It determines how old a person's arterial system appears to be, based on current cholesterol and blood pressure readings.

## Use Cases

### Initial Annual Checkup
A primary care physician needs to know if a 58-year-old patient is high risk. They ask their agent to run both the calculate_ten_year_risk and estimate_vascular_age tools, getting two immediate numbers to guide medication recommendations.

### High-Risk Follow-Up
A nurse needs to assess a patient who smokes and has high cholesterol. They use calculate_ten_year_risk with the latest vitals to see if the risk score increased since last month, signaling an urgent need for intervention.

### Preventative Screening
A health educator uses estimate_vascular_age on a young patient. The results show their vascular age is 10 years higher than expected, prompting the group to focus on diet and blood pressure management immediately.

## Benefits

- Determine 10-Year Probability: Use calculate_ten_year_risk to get a standardized, objective percentage showing a patient's likelihood of major cardiac events over the next decade. No guesswork here.
- Gauge Arterial Health: Run estimate_vascular_age to see if your patient’s blood vessels appear older or younger than they actually are. This is critical for advanced diagnosis.
- Consolidate Inputs: Instead of cross-referencing multiple guidelines, this MCP takes all necessary metrics—smoking status, diabetes, cholesterol—in one place for a full picture.
- Speed Up Consultations: Your agent handles the complex math instantly. You spend time talking to the patient instead of calculating risk scores in an Excel sheet.
- Standardized Metrics: The calculations follow established medical guidelines (Framingham), giving you results that are recognized and repeatable across different care settings.

## How It Works

The bottom line is that you get structured, evidence-based risk metrics instantly, without manually running calculations on separate platforms.

1. You tell your AI client which calculation you need—either the 10-year risk or the vascular age estimate.
2. Your agent prompts you for the required data points, like total cholesterol, systolic blood pressure, and whether the patient smokes or has diabetes.
3. The MCP runs these inputs through the Framingham model and returns a clear percentage risk score or an estimated age in years.

## Frequently Asked Questions

**What does calculate_ten_year_risk require?**
It requires age, sex, total cholesterol, HDL-C, systolic blood pressure, smoking status, and diabetes status. You need all these inputs to get the full 10-year probability score.

**Can I just check my vascular age with estimate_vascular_age?**
Yes, you can run estimate_vascular_age if your main concern is arterial wear. Remember it uses total cholesterol, HDL-C, SBP, and age for that specific calculation.

**Is this MCP better than using a generic calculator?**
Yes. This MCP follows the standardized Framingham model, ensuring your results are based on established medical guidelines, which is more reliable than general online tools.

**Do I need to provide smoking status for calculate_ten_year_risk?**
Yes, providing accurate smoking status is mandatory. The model uses this variable because it significantly affects the calculated 10-year risk percentage.