# Heart Score Calculator MCP for AI Agents AI Agent Connect

> Heart Score Calculator helps healthcare providers quickly assess the risk of acute myocardial infarction (AMI) in patients presenting with chest pain. It processes five clinical metrics including History, ECG, Age, Risk Factors, and Troponin levels to provide a standardized score. This tool helps move from subjective observation to objective, guideline-backed triage for faster patient management.

## Overview
- **Category:** cardiology
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_dJKDdPzuxeZhCBjvnTuzBffp6eozLgITt8VNakV6/ai-agent-connect
- **Tags:** heart-score, ami, ecg, troponin, triage

## Description

The Heart Score Calculator MCP connects your AI agent to standardized cardiology logic to assess acute myocardial infarction risk. In a busy emergency department, the pressure to make fast, accurate decisions on chest pain patients is immense. Clinicians often have to synthesize data from multiple sources, including ECG findings, troponin levels, patient history, and age factors. This manual process is prone to human error and can lead to inconsistent triage outcomes. This Connector removes that variability by providing a deterministic way to calculate a HEART score based on established medical guidelines. When you provide the agent with clinical data, it processes these five key metrics to produce a clear risk category. Instead of a general suggestion, the agent gives you a specific triage level and a list of mandatory diagnostic pathways. It tells you exactly which tests to order and where the patient should be managed. This ensures that every patient receives a consistent, evidence-based evaluation that follows AHA and ESC standards. By integrating this into your toolkit on Vinkius, you give your agent the ability to act as a clinical decision support tool. It helps you prioritize high-priority cases immediately while ensuring that lower-risk patients get appropriate follow-up schedules. It turns a complex data synthesis task into a clear, actionable plan.

## Tools

### calculate_heart_score
Calculates a total HEART score from five clinical components like ECG and history. This helps move from subjective observation to objective data.

### classify_risk_and_triage
Converts a raw score into a risk category and a specific triage priority level. It ensures consistent patient categorization.

### recommend_clinical_conduct
Generates a list of diagnostic tests and management steps based on the risk level. It provides actionable next steps for clinicians.

## Prompt Examples

**Prompt:** 
```
I have a 70-year-old male with a history of hypertension. ECG shows some changes, and his troponin is slightly high. Can you calculate his risk?
```

**Response:** 
```
Based on the data provided, I have calculated the HEART score.

**Patient Assessment:**
- History Score: 2
- ECG Score: 1
- Age Factor: 2
- Risk Factor: 2
- Troponin Severity: 1

**Total HEART Score: 8**
**Risk Classification:** High Risk
**Triage Priority:** Level 3 (Immediate)

**Recommended Action:** Immediate admission and urgent investigation required.
```

**Prompt:** 
```
A 30-year-old woman has mild chest pain but a low HEART score. What's the plan?
```

**Response:** 
```
The assessment for this patient shows a **Low Risk** status.

**Recommended Clinical Conduct:**
- **Management:** Outpatient follow-up.
- **Next Steps:** Discharge with scheduled follow-up.
- **Monitoring:** Patient should be instructed to seek immediate care if symptoms worsen.
```

**Prompt:** 
```
ER patient, 82 years old, History=1, ECG=0, Age=2, Risk Factor=1, Troponin=0. Give me the triage.
```

**Response:** 
```
Initial assessment complete.

**Score Breakdown:**
- History: 1
- ECG: 0
- Age: 2
- Risk Factor: 1
- Troponin: 0

**Total HEART Score: 4**
**Risk Category:** Moderate Risk
**Triage Level:** Level 2

**Action Plan:**
- Order standard cardiac enzymes.
- Monitor for changes in ECG.
- Consider admission based on clinical evolution.
```

## Capabilities

### Calculate total HEART scores
Turns clinical metrics into a standardized risk score of 0 to 10.

### Map risk categories
Classifies scores into Low, Moderate, or High risk categories.

### Determine triage priority
Assigns a specific triage level to every patient assessment.

### Generate diagnostic pathways
Lists the specific tests needed based on the risk classification.

### Identify management settings
Provides guidance on where the patient should be managed.

### Provide follow-up schedules
Outlines next steps for low-risk cardiac cases.

## Use Cases

### High Volume ER Triage
A triage nurse has a line of patients; the agent uses the calculator to identify the highest risk cases immediately.

### Outpatient Discharge Planning
A doctor wants to know if a low-score patient can go home; the agent provides specific discharge protocols.

### Complex Multi-Factor Assessment
A patient has multiple risk factors; the agent maps the score to a triage priority to ensure no steps are missed.

### Clinical Audit Compliance
A clinic uses the Connector to ensure all chest pain assessments meet standard guidelines for every patient.

## Benefits

- Remove human variability from initial cardiac risk scores by using deterministic logic.
- Get immediate triage levels for every patient using the calculation engine.
- Receive specific diagnostic pathways instead of generic advice for high-risk cases.
- Ensure every assessment follows AHA and ESC guidelines for consistent patient care.
- Speed up the transition from initial assessment to active management in emergency settings.
- Automate the synthesis of data from multiple sources like ECGs and lab results.

## How It Works

The bottom line is that it turns raw clinical data into a standardized, actionable triage plan.

1. Provide the patient's clinical data like age, ECG findings, and troponin levels to your agent.
2. The agent uses the Connector to calculate the HEART score and triage level.
3. You receive a clear risk classification and a set of evidence-based clinical next steps.

## Frequently Asked Questions

**What is the Heart Score Calculator MCP used for?**
It is used to objectively assess the risk of acute myocardial infarction in patients with chest pain. It turns raw clinical data into a standardized triage plan.

**How does the Heart Score Calculator help in an ER?**
It helps by providing an immediate triage priority level. This allows nurses and doctors to identify high-risk patients faster in a busy environment.

**Can the Heart Score Calculator provide specific test orders?**
Yes, it generates evidence-based clinical recommendations. These include specific diagnostic tests and management directives based on the risk score.

**Does the Heart Score Calculator follow medical guidelines?**
Yes, it follows current AHA and ESC guidelines. This ensures that the risk assessments and triage levels are consistent with standard medical practice.

**How do I use the Heart Score Calculator with my AI agent?**
You simply provide the agent with the patient's clinical metrics, such as age, history, and lab results. The agent then uses the Connector to perform the calculation.

**Can the Heart Score Calculator help with triage priority?**
It maps every calculated score to a specific triage level. This helps healthcare teams prioritize which patients need to be seen first.

**How is the total HEART score calculated?**
The core calculation happens via the `calculate_heart_score` tool. This function aggregates scores from five distinct components: History, ECG findings, Age factor, Risk Factors, and Troponin severity. The total score ranges from 0 to 10.

**Does the tool suggest a triage level?**
Yes. After scoring, the `classify_risk_and_triage` tool interprets the total score (0-10) and assigns a categorical risk level (Low/Moderate/High) along with an immediate numeric triage priority.

**What information does the system provide after determining the risk?**
The `recommend_clinical_conduct` tool takes the assigned risk and generates a comprehensive care plan. This includes mandatory diagnostic tests, initial management directives (e.g., observation vs. discharge), and follow-up schedules based on current guidelines.