# TIMI Score Calculator MCP MCP > The TIMI Score Calculator uses clinical inputs to generate accurate risk profiles for acute coronary syndrome (ACS). It calculates raw scores for STEMI and NSTEMI, estimates 14-day adverse event probability based on age, and provides immediate management recommendations following established guidelines. ## Overview - **Category:** risk-assessment - **Price:** Free - **Tags:** TIMI score, ACS, STEMI, NSTEMI, ACC-AHA, risk stratification ## Description When a patient presents with signs of acute coronary syndrome, the clock is ticking. You need to translate complex clinical data—age, ECG findings, lab results—into an actionable risk score immediately. This MCP guides you through that process by running interconnected calculations. It first generates separate TIMI scores for both STEMI and NSTEMI presentations using core variables. Next, it maps those raw scores against the patient's age to estimate a concrete 14-day probability of adverse cardiac events. Finally, it synthesizes everything into an immediate management recommendation, citing guideline justification. Because this tool handles such high-stakes data, every single input and output is recorded in a cryptographically signed audit trail by Vinkius, ensuring the full history remains tamper-proof for your records. You simply connect once from any compatible client to run this entire diagnostic cascade without leaving your workspace. ## Tools ### calculate_timi_score Calculates TIMI risk scores for STEMI and NSTEMI using core clinical variables like age and ECG findings. ### derive_adverse_event_risk Takes a TIMI score and the patient's age to estimate their specific 14-day probability of an adverse cardiac event. ### recommend_management_strategy Generates an immediate, authoritative course of action based on the final calculated risk category and MI type according to current guidelines. ## Prompt Examples **Prompt:** ``` Calculate the TIMI score. The patient is 65 years old, has ST elevation on ECG, and a prior CAD history of yes. ``` **Response:** ``` First, use `calculate_timi_score` to get both STEMI and NSTEMI scores. Then, if the score is high risk for STEMI, pass that result to `recommend_management_strategy` along with 'STEMI' as the condition type. ``` **Prompt:** ``` What is the 14-day adverse event probability for a patient aged Adult with a TIMI score of 5? ``` **Response:** ``` Use `derive_adverse_event_risk` with 'Adult' as the age group and 5 as the initial score. This will give you the risk category needed for the final strategic recommendation. ``` **Prompt:** ``` We have a patient with an NSTEMI, high risk, and we need to know the next steps per guidelines. The score was 6. ``` **Response:** ``` Call `recommend_management_strategy` using 'High Risk' as the category and 'NSTEMI' as the source condition. This will provide the authoritative guideline-based pathway. ``` ## Capabilities ### undefined undefined ### undefined undefined ### undefined undefined ### undefined undefined ## Use Cases ### Acute STEMI Triage A resident gets a patient in with ST elevation. They call `calculate_timi_score` for the initial score, then feed that result and age into `derive_adverse_event_risk`. Finally, they send both outputs to `recommend_management_strategy` to confirm immediate angiography is the correct next step. ### NSTEMI Follow-up Assessment A physician needs to reassess a stable patient with NSTEMI. They use `calculate_timi_score`, get a score, and then pass that result into `derive_adverse_event_risk` to confirm if the 14-day risk has dropped below acceptable thresholds. ### Protocol Confirmation A clinician is reviewing guidelines for an elderly patient. They use `recommend_management_strategy`, providing a high risk category and NSTEMI type, forcing the MCP to cite the specific guideline justification needed for sign-off. ### Multi-Stage Patient Intake The agent runs a full chain: first `calculate_timi_score`, then uses that score in `derive_adverse_event_risk` to establish risk, and finally feeds the risk into `recommend_management_strategy` for one single, definitive output. ## Benefits - Instead of manually calculating scores, the system runs `calculate_timi_score` to instantly generate both STEMI and NSTEMI risk markers. - You get a quantitative measure of future danger. By using `derive_adverse_event_risk`, you translate raw numbers into a clear 14-day adverse event probability. - It connects the dots for you. The final step, running through `recommend_management_strategy`, ensures your advice aligns with current ACC/AHA guidelines. - The entire process is auditable and secure. Every tool call records its inputs and outputs in a cryptographically signed audit trail. - You don't have to switch systems. Your agent handles the full cascade—from initial score calculation to final recommendation—all from one place. ## How It Works The bottom line is that you feed in raw patient data once and get a comprehensive, guideline-backed treatment pathway back. 1. Input core patient variables: you provide age, ECG findings, and prior CAD history. 2. The system first calculates the initial TIMI scores for both STEMI and NSTEMI using `calculate_timi_score`, then passes that result to estimate the 14-day risk via `derive_adverse_event_risk`. 3. Finally, it uses the resulting high-level risk category and MI type to output a definitive management plan through `recommend_management_strategy`. ## Frequently Asked Questions **How does the TIMI Score Calculator for ACS Risk Stratification work?** It works by creating a three-step workflow: first, it uses `calculate_timi_score` to get baseline numbers; second, it runs those scores through `derive_adverse_event_risk` using age; and finally, it gives you the protocol with `recommend_management_strategy`. **Can I use calculate_timi_score alone?** You can, but you'll only get a raw score. For full clinical value, always follow up by using that output in `derive_adverse_event_risk` and then passing the result to `recommend_management_strategy`. **What is the difference between TIMI score and adverse event risk?** The TIMI score is a baseline marker of severity. The MCP uses `derive_adverse_event_risk` to translate that raw score, adjusting it for age, into a much more practical 14-day probability. **Does the recommendation MCP cite guidelines?** Yes. When you run `recommend_management_strategy`, the output is explicitly tied to current ACC/AHA guidelines, providing immediate justification for the suggested care path. **When I run `calculate_timi_score`, how does Vinkius handle the sensitive patient data?** Your credentials pass through a zero-trust proxy, keeping them safe. They're only used in transit and never stored on disk, ensuring your keys stay private. **What kind of AI client can I connect to use `derive_adverse_event_risk`?** You just need an MCP-compatible client. Whether you're using Claude, Cursor, Windsurf, or VS Code, connecting your agent once gives you access to this tool. **If I provide bad inputs to `recommend_management_strategy`, how does the system handle it?** The MCP validates the data structure first. If something's wrong with your input, you get a clear error message that tells you exactly which field needs fixing. **Does Vinkius optimize token usage when I chain tools starting from `calculate_timi_score`?** Yes. Every MCP call includes native token optimization built in. This cuts down on your token consumption by up to 60% compared to running the same sequence without it.