{"uid":"cap_p7ii2EBS-0B5Y8A_JCA4M","slug":"maggic-heart-failure-risk-score-calculator-e6ce4cb5","name":"MAGGIC Heart Failure Risk Score Calculator","description":"Pocock 2013 MAGGIC integer score from 13 heart-failure predictors (age, EF, NYHA, creatinine, diabetes, not prescribed beta-blocker, SBP, BMI, HF duration >18 months, current smoker, COPD, male sex, not prescribed ACEI/ARB), including the published age×EF and SBP×EF extras. Returns integer score and Table 4 1-year and 3-year death probabilities for scores 0-50. Not a diagnosis, not a treatment order, not a reason to withhold therapy. magent does not examine the patient.","url":"https://api.magentlab.com/api/calc/maggic","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","required":["age","ef_percent","nyha_class","diabetes","beta_blocker","systolic_mm_hg","bmi_kg_m2","hf_duration_gt_18_months","current_smoker","copd","sex","acei_arb"],"properties":{"age":{"type":"integer","description":"Age in years (integer 18-120). Pocock 2013 integer extra depends on EF: <55 scores 0; then 55-59, 60-64, 65-69, 70-74, 75-79, >=80. magent does not examine the patient."},"sex":{"enum":["female","male"],"type":"string","description":"Sex (female or male). Male scores 1 (Figure 2)."},"copd":{"type":"boolean","description":"COPD as assigned by the caller. true scores 2. magent does not diagnose COPD."},"acei_arb":{"type":"boolean","description":"Prescribed an ACE inhibitor or ARB as assigned by the caller. true scores 0; false (not prescribed) scores 1. magent does not prescribe therapy."},"diabetes":{"type":"boolean","description":"Diabetes as assigned by the caller. true scores 3 (Figure 2). magent does not diagnose diabetes."},"bmi_kg_m2":{"type":"number","description":"Caller-supplied body-mass index in kg/m² (10-80). Figure 2: <15 6; 15-19 5; 20-24 3; 25-29 2; >=30 0. magent does not compute BMI from height and weight."},"ef_percent":{"type":"number","description":"Left-ventricular ejection fraction in percent (1-90). Figure 2: <20 scores 7; 20-24 6; 25-29 5; 30-34 3; 35-39 2; >=40 0. Also selects the age and SBP extra rows. magent does not read an echocardiogram."},"nyha_class":{"type":"integer","description":"NYHA class 1-4 as assigned by the caller (Figure 2: I 0, II 2, III 6, IV 8). magent does not assign NYHA class."},"beta_blocker":{"type":"boolean","description":"Prescribed a beta-blocker as assigned by the caller. true scores 0; false (not prescribed) scores 3. magent does not prescribe therapy."},"current_smoker":{"type":"boolean","description":"Current smoker as assigned by the caller. true scores 1. magent does not take a smoking history."},"systolic_mm_hg":{"type":"number","description":"Systolic blood pressure in mm Hg (50-250). Figure 2 extra depends on EF: <110, 110-119, 120-129, 130-139, 140-149, >=150. magent does not measure blood pressure."},"creatinine_mg_dl":{"type":"number","description":"Serum creatinine in mg/dL (0.1-20). Converted as µmol/L = mg/dL × 88.42, then Figure 2 µmol/L bins. Provide this or creatinine_umol_l, not both."},"creatinine_umol_l":{"type":"number","description":"Serum creatinine in µmol/L (9-1768), the Figure 2 unit. Provide this or creatinine_mg_dl, not both. Bins: <90 0; 90-109 1; 110-129 2; 130-149 3; 150-169 4; 170-209 5; 210-249 6; >=250 8. magent does not assay creatinine."},"hf_duration_gt_18_months":{"type":"boolean","description":"Heart-failure duration greater than 18 months as assigned by the caller (Table 2 HF duration >18 months). true scores 2. magent does not date the diagnosis."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1RfjhNphRl2L4U9sCq5w3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes the Pocock 2013 MAGGIC integer risk score from 13 heart-failure predictors and returns 1-year and 3-year mortality probabilities from the published Table 4 lookup.","exampleAgentPrompt":"Calculate the MAGGIC heart failure score for a 68-year-old male with an ejection fraction of 28%, NYHA class III, systolic BP 110 mmHg, BMI 27, creatinine 1.8 mg/dL, has diabetes, is not on a beta-blocker, is on an ACE inhibitor, HF duration over 18 months, non-smoker, no COPD — and give me the 1-year and 3-year mortality probabilities.","exampleUseCases":[{"title":"Pre-discharge HF risk stratification","prompt":"Before we discharge this 72-year-old female heart failure patient, run the MAGGIC score for me: EF 22%, NYHA class II, systolic BP 105 mmHg, BMI 31, she has COPD and diabetes, she's on an ACE inhibitor and a beta-blocker, HF for more than 18 months, non-smoker — what are her 1-year and 3-year mortality risks?"},{"title":"HF clinic follow-up prognostication","prompt":"At today's clinic visit for my 60-year-old male HF patient — EF 35%, NYHA class II, SBP 130 mmHg, BMI 24, current smoker, no diabetes, no COPD, on both beta-blocker and ARB, HF diagnosed less than 18 months ago — can you compute his MAGGIC score and look up the death probabilities?"},{"title":"Quality improvement mortality benchmarking","prompt":"I'm auditing our heart failure cohort. For a 79-year-old male with EF 18%, NYHA class IV, SBP 95 mmHg, BMI 19, diabetes, COPD, no beta-blocker, no ACE inhibitor or ARB, HF over 18 months, non-smoker — what does the MAGGIC model say his 1-year and 3-year mortality probabilities are?"}],"resultDescription":"Returns the computed MAGGIC integer score (0–50 range) and the published Table 4 1-year and 3-year mortality probability values corresponding to that score, based on the Pocock 2013 model including age×EF and SBP×EF interaction terms.","failureModes":["Missing required query parameters returns a validation error","Out-of-range values (e.g. age <18 or >120, EF outside 1-90, BMI outside 10-80, NYHA outside 1-4) return an error","Score outside the 0-50 Table 4 lookup range may return null probabilities","Payment failure or missing x402 payment header results in 402 Payment Required","Invalid enum value for sex (not 'male' or 'female') causes a 400 error"],"whenToPreferThis":"Use this endpoint when you need to compute the validated Pocock 2013 MAGGIC integer score specifically, including the published age×EF and SBP×EF interaction extras, and retrieve the official Table 4 mortality probability lookup — particularly for cardiology clinical decision support, HF risk stratification workflows, or mortality benchmarking where adherence to the published scoring algorithm matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:01:02.270Z","isFirstParty":false}