# Heart Score Calculator MCP MCP

> Heart Score Calculator determines a patient's risk of acute myocardial infarction (AMI) by analyzing five key clinical metrics. This MCP takes inputs like history scores, ECG findings, age factors, comorbidities, and troponin levels to generate a total score. It then classifies the resulting risk into Low, Moderate, or High categories, delivering mandatory diagnostic pathways and specific next steps for immediate care.

## Overview
- **Category:** cardiology
- **Price:** Free
- **Tags:** heart score, ami, ecg, troponin, triage

## Description

Assessing chest pain requires synthesizing data from multiple sources—History, ECGs, Age, Risk Factors, and Troponin—to build an actionable risk score. This MCP automates that process. Instead of relying on manual calculation and interpretation against complex AHA/ESC guidelines, your agent runs the full assessment in sequence. First, it aggregates all five clinical components into a single total score. Next, it maps that numerical score to a definitive risk category (Low, Moderate, or High). Finally, it generates mandatory diagnostic pathways specific to that risk level. The result isn't generic advice; it outputs clear next steps—which tests to order and where the patient needs immediate management. Because this entire assessment involves chaining multiple clinical decision points together, running these tools through Vinkius allows you to build reliable automated workflows that span complex medical logic, guaranteeing a traceable audit trail for every single calculation.

## Tools

### calculate_heart_score
Calculates the total HEART score, combining history, ECG, age, risk factors, and troponin levels into a single metric.

### classify_risk_and_triage
Takes the resulting heart score to assign an official risk category (Low/Moderate/High) and determine the required triage level.

### recommend_clinical_conduct
Generates mandatory, evidence-based clinical guidelines, specifying tests and management based on the final risk classification.

## Prompt Examples

**Prompt:** 
```
Patient profile: Age 68, History score 2 (Anginal at rest), ECG score 1 (T-wave inversion), Risk Factor score 2 (Diabetes/Hypertension). Troponin is mildly elevated. Calculate the HEART score and recommend initial conduct.
```

**Response:** 
```
First, I will use `calculate_heart_score` with inputs: historyScore=2, ecgFindingsScore=1, ageFactorScore=2, riskFactorComorbidityScore=2, troponinSeverityScore=1. The total score is 8. Next, using `classify_risk_and_triage(totalScore=8)`, the result is 'High Risk' with Triage Level 3. Finally, I call `recommend_clinical_conduct('High Risk')` which mandates immediate admission and urgent investigation.
```

**Prompt:** 
```
I have a young patient (Age 35) with minimal symptoms. My calculated HEART score is 2. What should the next steps be?
```

**Response:** 
```
The `classify_risk_and_triage` tool confirms a 'Low Risk' status for a total score of 2. Therefore, I run `recommend_clinical_conduct('Low Risk', false)` to get the recommended pathway. The output will guide us toward outpatient follow-up and discharge protocols.
```

**Prompt:** 
```
Run a full assessment for an 85-year-old male presenting in the ER. Scores are: History=1, ECG=0, Age=2, RF=1, Troponin=0.
```

**Response:** 
```
Initial calculation via `calculate_heart_score` yields a total score of 4. Using the `classify_risk_and_triage(totalScore=4, patientAgeGroup='over 80')` tool confirms 'Moderate Risk' with Triage Level 2. I then use `recommend_clinical_conduct('Moderate Risk', true, true)` to get actionable ER guidelines.
```

## Capabilities

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

## Use Cases

### Initial ER Assessment for Chronic Patients
A 68-year-old patient arrives with chest pain. The agent first runs `calculate_heart_score` to get the total score (e.g., 8). It then calls `classify_risk_and_triage('totalScore=8')`, which flags 'High Risk'. Finally, running `recommend_clinical_conduct('High Risk')` mandates immediate admission and urgent investigation.

### Follow-up for Low-Risk Discharges
A 35-year-old patient with minimal symptoms has a calculated score of 2. The agent uses `classify_risk_and_triage(totalScore=2)` to confirm 'Low Risk'. Running `recommend_clinical_conduct('Low Risk')` guides the team toward safe outpatient follow-up and discharge protocols.

### Complex, Multi-Variable Cases
Assessing an 85-year-old male in the ER. The workflow must account for advanced age and specific comorbidities. Running `calculate_heart_score` followed by `classify_risk_and_triage(totalScore=4, patientAgeGroup='over 80')` provides a nuanced 'Moderate Risk' classification.

### Protocol Verification
The physician needs to verify the correct protocol for an intermediate-risk patient. The agent runs `calculate_heart_score`, then uses `classify_risk_and_triage` to confirm a 'Moderate Risk' status, and finally calls `recommend_clinical_conduct('Moderate Risk', true, false)` to get specific ER guidelines.

## Benefits

- Moves beyond guesswork. Instead of just generating a score, using `classify_risk_and_triage` immediately maps that number to 'Low', 'Moderate', or 'High' risk status.
- Provides actionable next steps. The final output from `recommend_clinical_conduct` tells you exactly which tests to order and where the patient should be managed.
- Handles complexity automatically. It aggregates five different clinical metrics—H, E, A, R, T—in one go using `calculate_heart_score`, eliminating manual summation errors.
- Maintains compliance. The workflow adheres strictly to current AHA/ESC guidelines, ensuring every recommended action is backed by established medical standards.
- Reduces cognitive load. By chaining the tools sequentially, you eliminate the need to manually interpret a score and then cross-reference it with multiple clinical flow charts.

## How It Works

The bottom line is that you get a complete, guided care pathway—from initial score calculation to specific next steps for the patient.

1. Provide the initial clinical data—including history findings, ECG scores, age factors, risk factor comorbidities, and troponin levels. The agent uses this information to calculate a total HEART score.
2. Feed the resulting numerical score into the triage tool. This step determines if the patient falls into Low, Moderate, or High risk categories and assigns an immediate priority level.
3. The final risk classification is passed to the conduct recommendation tool. It generates mandatory diagnostic pathways, management directives, and follow-up schedules based on established medical standards.

## Frequently Asked Questions

**How does calculate_heart_score handle missing data?**
It handles optional inputs gracefully. If you don't provide a specific score, it defaults to zero for that component, allowing the calculation to proceed without interruption.

**Can classify_risk_and_triage determine if I need an immediate ambulance?**
It determines triage priority based on the total score. The output from `recommend_clinical_conduct` will provide explicit guidance, such as mandatory admission or urgent investigation.

**If I run recommend_clinical_conduct first, what happens?**
The system requires the risk classification to run first. You must pass the 'Low', 'Moderate', or 'High' status from `classify_risk_and_triage` into this tool for accurate recommendations.

**Does Heart Score Calculator require all five clinical metrics?**
No, it doesn't. The tools are designed to accept partial data while still performing a calculated assessment and providing the best possible guidance based on what you provide.

**When using calculate_heart_score, does it account for variations in regional medical guidelines?**
Yes. The tool adheres strictly to established AHA/ESC guidelines. It calculates the total score by aggregating inputs (H, E, A, R, T) according to internationally recognized clinical standards.

**How do I verify that the final recommendations from recommend_clinical_conduct are untampered?**
Every tool call creates a cryptographically signed audit trail. This gives you an immutable record of every input and output used to generate the clinical conduct, guaranteeing data integrity.

**If I provide inputs that result in an unusual score range, how does classify_risk_and_triage handle it?**
The tool validates your input scores against established medical norms. If the total score falls outside expected parameters, it flags a validation error and requires you to correct the data before classification can proceed.

**What is the most accurate workflow when combining calculate_heart_score with other tools?**
Always run `calculate_heart_score` first. This step establishes the foundational total score, which must then be fed directly into `classify_risk_and_triage` to ensure an accurate and consistent assessment chain.