{"uid":"cap_wg4m84kvAMFOG6V3p-URV","slug":"magent-framingham-chf-criteria-calculator-a1becf9b","name":"Magent Framingham CHF Criteria Calculator","description":"McKee 1971 Framingham CHF criteria. Definite if two major, or one major plus two minor, are concurrent. Nine major and seven minor caller-assigned flags. Weight loss ≥4.5 kg in 5 days in response to treatment is dual: major if that is definite, else minor if that is definite, else unused. major_count and minor_count are the fixed flags only. Not a medical device, not an echocardiographic diagnosis, and not HFrEF or HFpEF staging.","url":"https://api.magentlab.com/api/calc/framingham_hf","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":["pnd_or_orthopnea","neck_vein_distention","rales","cardiomegaly","acute_pulmonary_edema","s3_gallop","venous_pressure_gt_16","circulation_time_ge_25","hepatojugular_reflux","ankle_edema","night_cough","dyspnea_on_exertion","hepatomegaly","pleural_effusion","vital_capacity_decreased_third","tachycardia_ge_120","weight_loss_45kg_5d_treatment"],"properties":{"rales":{"type":"boolean","description":"Rales (McKee 1971 major). true or false as assigned by the caller. magent does not auscultate the lungs."},"s3_gallop":{"type":"boolean","description":"S3 gallop (McKee 1971 major). true or false as assigned by the caller. magent does not auscultate the heart."},"ankle_edema":{"type":"boolean","description":"Ankle edema (McKee 1971 minor). true or false as assigned by the caller. magent does not examine the ankles."},"night_cough":{"type":"boolean","description":"Night cough (McKee 1971 minor). true or false as assigned by the caller. magent does not take a history."},"cardiomegaly":{"type":"boolean","description":"Cardiomegaly (McKee 1971 major). true or false as assigned by the caller. magent does not interpret a chest radiograph."},"hepatomegaly":{"type":"boolean","description":"Hepatomegaly (McKee 1971 minor). true or false as assigned by the caller. magent does not examine the liver."},"pleural_effusion":{"type":"boolean","description":"Pleural effusion (McKee 1971 minor). true or false as assigned by the caller. magent does not interpret imaging."},"pnd_or_orthopnea":{"type":"boolean","description":"Paroxysmal nocturnal dyspnea or orthopnea (McKee 1971 major). true or false as assigned by the caller. magent does not take a history."},"tachycardia_ge_120":{"type":"boolean","description":"Tachycardia ≥120 per minute (McKee 1971 minor). true or false as assigned by the caller. magent does not measure heart rate."},"dyspnea_on_exertion":{"type":"boolean","description":"Dyspnea on exertion (McKee 1971 minor). true or false as assigned by the caller. magent does not take a history."},"hepatojugular_reflux":{"type":"boolean","description":"Hepatojugular reflux (McKee 1971 major). true or false as assigned by the caller. magent does not examine the patient."},"neck_vein_distention":{"type":"boolean","description":"Neck-vein distention (McKee 1971 major). true or false as assigned by the caller. magent does not examine the neck veins."},"acute_pulmonary_edema":{"type":"boolean","description":"Acute pulmonary edema (McKee 1971 major). true or false as assigned by the caller. magent does not diagnose pulmonary edema."},"venous_pressure_gt_16":{"type":"boolean","description":"Increased venous pressure >16 cm of water (McKee 1971 major). true or false as assigned by the caller. magent does not measure venous pressure."},"circulation_time_ge_25":{"type":"boolean","description":"Circulation time ≥25 seconds (McKee 1971 major). true or false as assigned by the caller. magent does not measure circulation time."},"weight_loss_45kg_5d_treatment":{"type":"boolean","description":"Weight loss ≥4.5 kg in 5 days in response to treatment (McKee 1971 dual major-or-minor). true or false as assigned by the caller. Counted as major if that assignment is definite, else as minor if that assignment is definite, else unused. magent does not weigh the patient."},"vital_capacity_decreased_third":{"type":"boolean","description":"Vital capacity decreased one third from maximum (McKee 1971 minor). true or false as assigned by the caller. magent does not measure vital capacity."}}}},"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_BVTL3he33g_G5hJZTR9lR","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":"Applies McKee 1971 Framingham congestive heart failure criteria to caller-supplied clinical flags to determine definite CHF, possible CHF, or unlikely CHF classification","exampleAgentPrompt":"Use the Framingham CHF criteria to evaluate this patient: they have paroxysmal nocturnal dyspnea, rales, and an S3 gallop (all major criteria positive), plus ankle edema and night cough (minor criteria positive), and no confirmed weight loss response to treatment. Do they meet criteria for definite CHF?","exampleUseCases":[{"title":"ED triage heart failure screening","prompt":"I have a patient in the ED with orthopnea, rales, cardiomegaly on X-ray, and an S3 gallop — all confirmed. They also have ankle edema and dyspnea on exertion. No acute pulmonary edema, no S3, venous pressure not elevated, hepatojugular reflux absent, circulation time normal. Weight loss treatment response is unknown. Can you run the Framingham CHF criteria and tell me if they meet definite CHF?"},{"title":"Cardiology consult documentation support","prompt":"For this consult note I need the Framingham CHF score: major criteria present are acute pulmonary edema and elevated venous pressure above 16 cmH2O; minor criteria are pleural effusion and tachycardia over 120. All other criteria are negative. No treatment weight loss data. What's the classification?"},{"title":"Clinical research CHF cohort validation","prompt":"I'm screening a study cohort and need to classify each patient by McKee 1971 Framingham criteria. For patient 47: PND present, neck vein distention present, S3 gallop present (three majors), plus hepatomegaly and night cough (two minors). All other flags are false. Weight loss after treatment is confirmed at ≥4.5 kg in 5 days. Run the Framingham CHF calculator and return the classification and counts."}],"resultDescription":"Returns a CHF classification (definite, possible, or unlikely) based on the McKee 1971 Framingham criteria, along with counts of major and minor fixed criteria met and the assigned role of the weight-loss treatment-response criterion (major, minor, or unused)","failureModes":["Missing required boolean flags returns a validation error","Ambiguous weight loss treatment status left unresolved causes criterion to be unused rather than counted","Caller misclassification of clinical findings leads to incorrect scoring — the API applies the logic but does not validate clinical accuracy","Network or payment authorization failure returns 402 or 5xx"],"whenToPreferThis":"Use this endpoint when you need a structured, rule-based application of the McKee 1971 Framingham CHF diagnostic criteria to caller-supplied clinical findings. Prefer this over general clinical reasoning or LLM-based scoring when you need deterministic, auditable classification with explicit major/minor criterion accounting. Not appropriate for echocardiographic staging, HFrEF/HFpEF classification, or when clinical findings have not yet been assessed by a clinician.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:11:32.118Z","isFirstParty":false}