# Framingham Risk MCP MCP

> The Framingham Cardiovascular Risk Calculator uses standard medical metrics to predict a patient's health outlook. It calculates an estimated 10-year cardiovascular risk percentage and provides a vascular age estimate using established clinical guidelines. This MCP takes core inputs—like blood pressure, cholesterol levels, age, and smoking status—to give clinicians a standardized view of major heart attack or stroke probability.

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

## Description

Understanding true cardiac risk requires more than just looking at current vitals; it demands complex metrics modeled after large population studies. This MCP provides that standard assessment by running the patient's data through established scoring models. You can predict the likelihood of a major cardiovascular event, like a heart attack or stroke, over the next decade. It also gives an estimate of vascular age, which checks how stressed the patient’s arteries are compared to their actual years lived.

Instead of manually running these calculations across different spreadsheets and using varying formulas, your agent handles the entire process in one go. When you run this MCP through Vinkius, all sensitive patient metrics pass through a zero-trust proxy. This means the system uses the data only for the calculation—it never stores or leaves your confidential credentials on disk. You get standardized, clinically relevant risk scores and age estimates without compromising security.

## Tools

### calculate_ten_year_risk
Predicts the percentage chance of a major heart attack or stroke over ten years using age, sex, cholesterol levels, SBP, smoking status, and diabetes status.

### estimate_vascular_age
Calculates an estimate of a patient's 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

### undefined
undefined

### undefined
undefined

### undefined
undefined

## Use Cases

### Initial Patient Intake Assessment
A nurse practitioner enters basic vitals for a new patient. The agent calls `calculate_ten_year_risk` and gets an immediate 10-year risk score, allowing the NP to immediately determine if the patient needs urgent specialist referral or routine follow-up.

### Monitoring High Cholesterol
The primary care physician wants to know how a high cholesterol count affects the patient's arteries. They use `estimate_vascular_age`, instantly seeing if the patient’s vascular age is significantly higher than their actual age, guiding immediate lifestyle recommendations.

### Comprehensive Risk Review
The physician needs a full picture: 68-year-old male, high SBP, smoker. The agent runs both `calculate_ten_year_risk` and `estimate_vascular_age` simultaneously to provide two complementary risk metrics in one output.

### Follow-up Care Documentation
Instead of typing up the results, the agent runs the calculations and then drafts a summary note detailing the 'moderate' or 'low' risk classification derived from `calculate_ten_year_risk`, ready for electronic signing.

## Benefits

- Calculate 10-year probability: Get a clear, standardized percentage for major cardiovascular events by running the `calculate_ten_year_risk` tool. This moves beyond simple vital signs into predictive medicine.
- Assess vascular stress: Use the `estimate_vascular_age` function to see if a patient’s arteries are older than their actual age—a critical metric often missed in routine checks.
- Handle complex inputs: The MCP requires seven distinct data points (including smoking and diabetes status) for accurate calculation, handling complexity far better than manual sheets.
- Improve workflow visibility: If you combine this MCP with a messaging tool, your agent can not only calculate the risk but also draft follow-up notes detailing those findings.
- Maintain compliance: Because credentials pass through Vinkius's zero-trust proxy, you process highly sensitive patient data without ever worrying about storing keys on disk.

## How It Works

The bottom line is that you get structured, quantifiable risk data from complex medical inputs without needing to manually manage the formulas or the calculations.

1. Provide the agent with specific patient data: age, sex, total and HDL cholesterol, systolic blood pressure (SBP), smoking history, and diabetes status.
2. The MCP runs these inputs through two separate clinical models to generate both a 10-year risk score and an estimate of vascular age.
3. You receive the calculated percentages and age differentials, giving you immediate insight into the patient’s cardiac profile.

## Frequently Asked Questions

**What inputs does the risk calculator need?**
The system requires several key metrics, including age, sex, total cholesterol, HDL-C, systolic blood pressure, smoking status, and diabetes diagnosis. The `calculate_ten_year_risk` tool uses all these inputs to generate a comprehensive score.

**Is the calculated risk a definitive diagnosis?**
No. The score is an estimation based on medical formulas and population data. Always consult a healthcare professional. Tools like `calculate_ten_year_risk` provide predictive metrics, not diagnoses.

**What is 'vascular age' and how is it calculated?**
Vascular age estimates the apparent wear and tear on your arteries, independent of chronological age. The `estimate_vascular_age` tool uses cholesterol ratios, blood pressure, and age to calculate this value, giving a deeper picture of your cardiovascular health.

**How is my data protected when running calculate_ten_year_risk?**
Your inputs are processed through a zero-trust proxy. Vinkius only uses credentials in transit; they never sit on disk, keeping your sensitive health metrics secure.

**What should I do if the estimate_vascular_age tool returns an error?**
If you get an error, check that every required field is present and formatted correctly. The system will return a specific code detailing exactly which piece of data caused the failure.

**How can I run both calculate_ten_year_risk and estimate_vascular_age in one workflow?**
You connect your agent once from any MCP-compatible client. Your AI can then chain calls to execute both the risk score calculation and the vascular age estimate sequentially.

**Are there limits when I run many checks with calculate_ten_year_risk?**
The platform includes a financial circuit breaker. You set an explicit budget, and the system prevents any AI agent from overspending regardless of how many tool calls you make.

**If I update my health metrics next year, does calculate_ten_year_risk remember previous data?**
No. The MCP runs against the specific parameters you pass it at that time. For longitudinal tracking, your agent just needs to provide the most current set of metrics for a fresh calculation.