# magent HFA-ICOS HER2 Baseline Cardiovascular Risk Calculator

> magent HFA-ICOS HER2 Baseline Cardiovascular Risk Calculator is a paid API for AI agents from api.magentlab.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Classifies baseline cardiovascular risk (Very High / High / Medium 1 / Medium 2 / Low) before HER2-targeted therapy (trastuzumab and related agents) per the Lyon 2020 HFA-ICOS published criteria.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/hfa_icos_her2
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/magent-hfa-icos-her2-baseline-cardiovascular-risk-calculator-978b626d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XwIallc_jJHB2zHsJ9Z0A

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability magent-hfa-icos-her2-baseline-cardiovascular-risk-calculator-978b626d
```

Example prompt: Classify the baseline cardiovascular risk before starting trastuzumab for a 72-year-old patient with LVEF 58%, no heart failure, no prior trastuzumab cardiotoxicity, no MI or CABG, no stable angina, no severe valvular disease, no concurrent anthracycline, no arrhythmia, no elevated troponin or BNP, no prior remote anthracycline, no prior chest radiation, hypertension present, no diabetes, no CKD, no prior sequential anthracycline, non-smoker, and not obese — use the Lyon 2020 HFA-ICOS criteria and tell me the risk category and expected cardiotoxicity rate.

## When to prefer this

Use this endpoint when you need a deterministic, citation-backed cardiovascular risk classification per the Lyon 2020 HFA-ICOS framework specifically for HER2-targeted therapy (trastuzumab and related agents). Prefer it over generic risk calculators when the clinical context is pre-HER2 therapy cardiotoxicity risk stratification, especially when the treating team has already assessed clinical variables and needs a structured tier (Very High / High / Medium 1 / Medium 2 / Low) with an associated cardiotoxicity incidence estimate and literature citation. Not appropriate for LVEF measurement, biomarker assay, treatment ordering, or non-HER2 chemotherapy risk stratification.

## Known failure modes

- Missing required query parameters (age_years, lvef_percent, or any boolean flag) returns a validation error
- Age outside the 18-100 integer range may return an error or unexpected classification
- Caller misassigns clinical variables (e.g. arrhythmia, troponin elevation) — garbage-in garbage-out; endpoint trusts caller-supplied booleans
- Payment failure (x402) returns 402 status with payment instructions rather than a risk classification
- Conflicting flag combinations (e.g. both concurrent and sequential anthracycline) may produce unexpected tier assignments

## How this service works

Lyon 2020 HFA-ICOS baseline cardiovascular risk before HER2-targeted therapy (trastuzumab and related agents). Very high, high, medium, or low from published factors plus Medium 1/2 points; expert-opinion cardiotoxicity guide <2% / 2-9% / 10-19% / >=20%. Concurrent anthracycline is High; sequential anthracycline before HER2 is Medium 1. Deterministic published classification with citation; not a treatment order. magent does not measure LVEF or biomarkers.

## Output

Returns a deterministic cardiovascular risk category (Very High, High, Medium 1, Medium 2, or Low) per Lyon 2020 HFA-ICOS published classification, an estimated cardiotoxicity incidence band (<2%, 2-9%, 10-19%, or >=20%), the specific factors driving the classification, and the published citation. Does not measure LVEF or biomarkers directly — these are caller-supplied.

## Request schema (JSON Schema)

```json
{
 "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_years",
      "lvef_percent",
      "heart_failure_or_cardiomyopathy",
      "prior_trastuzumab_cardiotoxicity",
      "mi_or_cabg",
      "stable_angina",
      "severe_valvular_heart_disease",
      "concurrent_anthracycline_and_her2",
      "arrhythmia",
      "elevated_troponin",
      "elevated_bnp",
      "prior_remote_anthracycline",
      "prior_left_chest_or_mediastinal_rt",
      "hypertension",
      "diabetes",
      "ckd",
      "anthracycline_before_her2",
      "current_or_significant_smoker",
      "obesity"
     ],
     "properties": {
      "ckd": {
       "type": "boolean",
       "description": "Chronic kidney disease as assigned by the caller (Lyon 2020 HER2 table Medium 1). true or false."
      },
      "obesity": {
       "type": "boolean",
       "description": "Obesity as assigned by the caller (Lyon 2020 HER2 table Medium 1). true or false. magent does not compute BMI."
      },
      "diabetes": {
       "type": "boolean",
       "description": "Diabetes mellitus as assigned by the caller (Lyon 2020 HER2 table Medium 1). true or false."
      },
      "age_years": {
       "type": "integer",
       "description": "Age in years (integer 18-100). Lyon 2020 exclusive bands: ≥80 is High; 65-79 is Medium 2 (2 points); younger than 65 does not score. Age 80 is High, not Medium 2."
      },
      "arrhythmia": {
       "type": "boolean",
       "description": "Atrial fibrillation, atrial flutter, VT, or VF as assigned by the caller (Lyon 2020 HER2 table Medium 2). true or false. magent does not interpret the ECG."
      },
      "mi_or_cabg": {
       "type": "boolean",
       "description": "Prior myocardial infarction or CABG as assigned by the caller (Lyon 2020 HER2 table High). true or false."
      },
      "elevated_bnp": {
       "type": "boolean",
       "description": "Elevated BNP or NT-proBNP as assigned by the caller (Lyon 2020 HER2 table Medium 2). 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/magent-hfa-icos-her2-baseline-cardiovascular-risk-calculator-978b626d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.magentlab.com](https://www.zero.xyz/host/api.magentlab.com/llms.txt)