# magent R-ISS Calculator

> magent R-ISS 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-10-12).

Computes the Revised International Staging System (R-ISS) stage for multiple myeloma using beta-2 microglobulin, albumin, LDH status, and cytogenetic risk (Palumbo 2015).

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/r_iss?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/magent-r-iss-calculator-8dd18bd8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_72JPrHDwKAK7hMsZeZGEB

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-r-iss-calculator-8dd18bd8
```

Example prompt: Calculate the R-ISS stage for a multiple myeloma patient with a serum beta-2 microglobulin of 3.0 mg/L, albumin of 4.0 g/dL, LDH within normal limits, and no high-risk cytogenetic abnormalities (no del(17p), t(4;14), or t(14;16)).

## When to prefer this

Use this endpoint when you need a deterministic, citation-backed R-ISS stage computation per Palumbo 2015 for a multiple myeloma patient and you already have the serum beta-2 microglobulin, albumin, LDH-vs-ULN status, and iFISH cytogenetic risk classification in hand. Do not use if you need the R2-ISS (2022 revision), Durie-Salmon staging, or if you need laboratory assay of any of the input values — this endpoint only computes the formula, it does not perform any laboratory testing.

## Known failure modes

- Missing required parameters (beta2_microglobulin_mg_l, high_risk_ca, or ldh_gt_uln) returns a validation error
- Beta-2 microglobulin value outside range 0.2–40 mg/L may produce an error or unexpected result
- Providing both albumin_g_l and albumin_g_dl simultaneously is disallowed and returns an error
- Albumin value outside g/dL range 1–6 or g/L range 10–60 may be rejected
- Non-boolean values for high_risk_ca or ldh_gt_uln cause type validation failure

## How this service works

Deterministic published-formula arithmetic plus ICD-10-CM, RxNorm, and LOINC. Pay in USDC on Base via x402.

## Output

Returns a JSON object with the computed ISS stage (1–3) and R-ISS stage (1–3) along with their string labels, the echo of input values, the full formula expression applied, a citation to Palumbo 2015 (DOI and PMID), and a clinical disclaimer noting this is deterministic formula output and not a medical device.

## 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": [
      "beta2_microglobulin_mg_l",
      "high_risk_ca",
      "ldh_gt_uln"
     ],
     "properties": {
      "ldh_gt_uln": {
       "type": "boolean",
       "description": "Serum LDH greater than the upper limit of normal as assigned by the caller (Palumbo 2015: high LDH is > ULN). magent does not assay LDH or assign ULN."
      },
      "albumin_g_l": {
       "type": "number",
       "description": "Serum albumin in g/L (10-60). Converted as g/dL = g/L / 10. Provide this or albumin_g_dl, not both."
      },
      "albumin_g_dl": {
       "type": "number",
       "description": "Serum albumin in g/dL (1-6). Provide this or albumin_g_l, not both. ISS uses g/dL. Stage I requires albumin >= 3.5 when Sβ2M < 3.5. Ignored when Sβ2M >= 5.5."
      },
      "high_risk_ca": {
       "type": "boolean",
       "description": "High-risk cytogenetic abnormalities as assigned by the caller: true iff del(17p) and/or t(4;14) and/or t(14;16) by iFISH (Palumbo 2015). magent does not FISH."
      },
      "beta2_microglobulin_mg_l": {
       "type": "number",
       "description": "Serum beta-2 microglobulin in mg/L (0.2-40). Greipp 2005 / Palumbo 2015 ISS. Stage I requires < 3.5; stage III when >= 5.5. magent does not assay beta-2 microglobulin."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "path": "/api/calc/r_iss",
  "count": 2,
  "items": [
   {
    "formula": "r_iss",
    "citation": {
     "id": "palumbo-2015",
     "doi": "10.1200/JCO.2015.61.2267",
     "pmid": "26240224",
     "title": "Revised International Staging System for Multiple Myeloma: A Report From International Myeloma Working Group",
     "source": "J Clin Oncol. 2015;33(26):2863-2869",
     "authors": "Palumbo A, Avet-Loiseau H, Oliva S, et al."
    },
    "iss_stage": 1,
    "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
    "ldh_gt_uln": false,
    "riss_stage": 1,
    "albumin_g_dl": 4,
    "high_risk_ca": false,
    "iss_stage_label": "I",
    "riss_stage_label": "I",
    "formula_expression": "R-ISS I: ISS I AND high_risk_ca false AND ldh_gt_uln false; R-ISS III: ISS III AND (high_risk_ca OR ldh_gt_uln); R-ISS II: all other combinations. ISS I: beta2_microglobulin_mg_l < 3.5 AND albumin_g_dl >= 3.5; ISS III: beta2_microglobulin_mg_l >= 5.5; ISS II: neither I nor III (Palumbo 2015; ISS as Greipp 2005)",
    "beta2_microglobulin_mg_l": 2
   },
   {
    "formula": "r_iss",
    "citation": {
     "id": "palumbo-2015",
     "doi": "10.1200/JCO.2015.61.2267",
     "pmid": "26240224",
     "title": "Revised International Staging System for Multiple Myeloma: A Report From International Myeloma Working Group",
     "source": "J Clin Oncol. 2015;33(26):2863-2869",
     "authors": "Palumbo A, Avet-Loiseau H, Oliva S, et al."
    },
    "iss_stage": 1,
    "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
    "ldh_gt_uln": false,
    "riss_stage": 1,
    "albumin_g_dl": 4,
    "high_risk_ca": false,
    "iss_stage_label": "I",
    "riss_stage_label": "I",
    "formula_expression": "R-ISS I: ISS I AND high_risk_ca false AND ldh_gt_uln false; R-ISS III: ISS III AND (high_risk_ca OR ldh_gt_uln); R-ISS II: all other combinations. ISS I: beta2_microglobulin_mg_l < 3.5 AND albumin_g_dl >= 3.5; ISS III: beta2_microglobulin_mg_l >= 5.5; ISS II: neither I nor III (Palumbo 2015; ISS as Greipp 2005)",
    "beta2_microglobulin_mg_l": 2
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/magent-r-iss-calculator-8dd18bd8/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)