# TIMI Score Calculator MCP for AI Agents AI Agent Connect

> TIMI Score Calculator for ACS Risk Stratification calculates TIMI scores and provides guideline-based risk stratification for acute coronary syndrome (ACS) management. It helps clinicians move from raw patient data to actionable treatment plans by automating complex scoring for STEMI and NSTEMI presentations.

## Overview
- **Category:** risk-assessment
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_YQ13hlpfbtcqeOWyoudVialdmLRcqDY38ai4KcFe/ai-agent-connect
- **Tags:** timi-score, acs, stemi, nstemi, acc-aha, risk-stratification

## Description

This Connector calculates TIMI scores and provides risk stratification for acute coronary syndrome (ACS) management. When you're in a high-pressure environment like an ER or a cardiac cath lab, you need to know exactly how to prioritize care based on the latest ACC/AHA guidelines. This tool takes the raw data, such as a patient's age, ECG findings, and history of coronary artery disease, and turns it into a clear risk profile. Instead of manually crunching numbers and looking up tables, you can ask your AI client to run the numbers for you. It handles the specific requirements for both STEMI and NSTEMI presentations, providing a consistent way to categorize risk. By using this Connector through the Vinkius catalog, you get a reliable bridge between patient vitals and evidence-based treatment pathways. It's about getting the right recommendation at the right time so you can focus on the patient rather than the paperwork.

## Tools

### calculate_timi_score
Generates TIMI scores for both STEMI and NSTEMI based on clinical variables like age and ECG findings. This helps establish a consistent baseline for risk assessment.

### derive_adverse_event_risk
Translates a raw TIMI score into a specific 14-day probability of a cardiac adverse event. It maps the score to population-based data for a clearer picture of outcomes.

### recommend_management_strategy
Provides a recommended clinical course of action based on the risk category and MI type. It cites specific management pathways from the ACC/AHA guidelines.

## Prompt Examples

**Prompt:** 
```
A 68-year-old male has ST elevation on his ECG and a history of CAD. What's his TIMI score and what's the next step?
```

**Response:** 
```
### Patient Risk Assessment

**TIMI Scores:**
| Presentation | Score |
| :--- | :--- |
| **STEMI** | 5 |
| **NSTEMI** | 4 |

**Risk Profile:**
* **Category:** High Risk
* **14-Day Adverse Event Probability:** 18%

**Recommended Management Strategy:**
Based on ACC/AHA guidelines for high-risk STEMI, the recommended immediate course of action is **early invasive angiography**.
```

**Prompt:** 
```
What's the 14-day risk for an adult with a TIMI score of 6?
```

**Response:** 
```
For an adult patient with a TIMI score of **6**, the estimated **14-day adverse event probability** is **22%**. 

This puts the patient in the high-risk category, which typically triggers a more aggressive management strategy.
```

**Prompt:** 
```
Patient has NSTEMI, high risk. What do the guidelines say for management?
```

**Response:** 
```
For an **NSTEMI** patient categorized as **High Risk**, the ACC/AHA guidelines recommend the following:

* **Immediate Action:** Early invasive management.
* **Justification:** High-risk NSTEMI patients require rapid intervention to reduce the risk of major adverse cardiac events.
```

## Capabilities

### Calculate separate TIMI scores
Generate specific scores for both STEMI and NSTEMI presentations based on clinical variables.

### Convert scores to risk probabilities
Translate a raw TIMI score into an estimated 14-day adverse cardiac event probability.

### Get guideline-based management
Receive immediate clinical course recommendations based on risk categories and MI types.

### Categorize patient risk
Map clinical data to specific risk groups for better triage and prioritization.

### Identify treatment pathways
Determine the recommended immediate course of action according to ACC/AHA standards.

## Use Cases

### ER Triage
A doctor inputs a patient's age and ECG results to see if they need immediate intervention. The agent uses `calculate_timi_score` to provide a quick risk profile.

### Cath Lab Planning
A cardiologist uses the tool to justify the urgency of a procedure based on a high TIMI score. It uses `derive_adverse_event_risk` to show the 14-day probability.

### Clinical Education
A resident asks for a management strategy for a specific risk category to study guidelines. The agent uses `recommend_management_strategy` to show the standard of care.

### Rapid Intake
A nurse provides basic vitals and CAD history to get a quick risk profile for a new arrival, helping the team prioritize the next bed.

## Benefits

- Get instant TIMI scores for both STEMI and NSTEMI without manual calculation using `calculate_timi_score`.
- Receive 14-day adverse event probabilities based on population data using `derive_adverse_event_risk`.
- Access management strategies that align with ACC/AHA guidelines via `recommend_management_strategy`.
- Reduce the risk of human error during high-pressure clinical scoring in the ER or cath lab.
- Standardize how your team categorizes and prioritizes ACS patients using consistent scoring logic.

## How It Works

The bottom line is that it turns messy clinical inputs into a structured, guideline-compliant treatment plan in seconds.

1. Input the patient's core clinical data, including age, ECG details, and history of coronary artery disease.
2. The Connector processes these variables to generate specific TIMI scores for STEMI and NSTEMI.
3. You receive a 14-day adverse event probability and a recommended management strategy.

## Frequently Asked Questions

**How does the TIMI Score Calculator for ACS Risk Stratification help in the ER?**
It provides a fast way to turn patient vitals and ECG data into a clear risk score. This helps doctors decide immediately who needs the most urgent care.

**Can I use the TIMI Score Calculator for ACS Risk Stratification for NSTEMI patients?**
Yes, the tool calculates separate scores for both STEMI and NSTEMI presentations to ensure accurate risk assessment for both types of ACS.

**Does the TIMI Score Calculator for ACS Risk Stratification follow the latest guidelines?**
Yes, the tool is designed to provide management recommendations that align specifically with ACC/AHA guidelines.

**How does the TIMI Score Calculator for ACS Risk Stratification calculate risk?**
It takes clinical variables like age, ECG findings, and CAD history to generate a TIMI score, then maps that score to a 14-day probability of a cardiac event.

**Can the TIMI Score Calculator for ACS Risk Stratification help with patient triage?**
It is ideal for triage because it quickly categorizes patients into risk groups, allowing for faster prioritization of high-risk cases.

**What kind of data do I need for the TIMI Score Calculator for ACS Risk Stratification?**
You'll need the patient's age, their ECG findings, and whether they have a history of coronary artery disease (CAD).

**What inputs are required to calculate the initial TIMI score?**
The `calculate_timi_score` tool requires patient age, key ECG abnormalities (`ecgFindings`), and whether the patient has a history of Coronary Artery Disease (`priorCADHistory`). Creatinine level is optional.

**Does the calculated score determine the management strategy directly?**
No. First, you use `derive_adverse_event_risk` to get a probability estimate. Then, `recommend_management_strategy` takes that risk category and the MI type (STEMI/NSTEMI) to provide the final guideline recommendation.

**Can I calculate scores for different types of MIs?**
Yes. The `calculate_timi_score` tool is designed to run two separate calculations, providing distinct provisional scores tailored specifically for STEMI and NSTEMI presentations.