{"uid":"cap_OdXQ_pn1AImyAeAbCEdRN","slug":"magent-bclc-stage-calculator-reig-2022-d25f3227","name":"magent BCLC Stage Calculator (Reig 2022)","description":"Reig 2022 BCLC stage 0/A/B/C/D from caller-assigned cancer-related ECOG, preserved liver function, transplant option, vascular invasion, extrahepatic disease, tumor count, and largest diameter. Returns stage and expected median survival only. Not a treatment recommendation. magent does not assign ECOG, compute Child-Pugh, or interpret imaging. Not a medical device. Not Milan or UCSF listing.","url":"https://api.magentlab.com/api/calc/bclc","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":["ecog","preserved_liver_function","transplant_option","vascular_invasion","extrahepatic","tumor_count","largest_cm"],"properties":{"ecog":{"type":"integer","description":"Cancer-related ECOG performance status 0-4 as assigned by the caller (Reig 2022: do not count baseline comorbidity PS). Integer 0-4. magent does not assign ECOG."},"largest_cm":{"type":"number","description":"Largest tumor diameter in centimetres (0.1-30). Stage 0 meets at 2.0 cm and is A at 2.1 when solitary. Two or three nodules meet A at 3.0 cm and are B at 3.1. magent does not interpret imaging."},"tumor_count":{"type":"integer","description":"Number of HCC nodules (integer 1-20) as assigned by the caller. Stage 0 is a single tumor <=2 cm; stage A allows a solitary tumor of any size or 2-3 nodules none >3 cm; four or more nodules are stage B when otherwise 0/A/B-eligible. magent does not interpret imaging."},"extrahepatic":{"type":"boolean","description":"Extrahepatic spread as assigned by the caller. true or false. magent does not interpret imaging."},"transplant_option":{"type":"boolean","description":"Option of liver transplantation when liver function is not preserved, as assigned by the caller (Reig 2022). true or false. magent does not list for transplant."},"vascular_invasion":{"type":"boolean","description":"Vascular (vessel) invasion as assigned by the caller. true or false. magent does not interpret imaging."},"preserved_liver_function":{"type":"boolean","description":"Preserved liver function as assigned by the caller (Reig 2022 abandoned Child-Pugh class for this assignment). true or false. magent does not compute Child-Pugh or ALBI."}}}},"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_XsOvwfhSZ-TIEzZd7D7UY","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 Barcelona Clinic Liver Cancer (BCLC) stage (0/A/B/C/D) and expected median survival from caller-supplied HCC clinical parameters per Reig 2022 criteria.","exampleAgentPrompt":"What BCLC stage and expected median survival does Reig 2022 give for a patient with ECOG 1, preserved liver function, transplant eligible, no vascular invasion, no extrahepatic disease, 2 HCC nodules with the largest being 2.8 cm?","exampleUseCases":[{"title":"Oncology agent HCC staging workflow","prompt":"I need to BCLC-stage an HCC patient: ECOG 0, preserved liver function, not eligible for transplant, no vascular invasion, no extrahepatic spread, single tumor 1.8 cm — what stage and what's the expected median survival?"},{"title":"Prognostic estimate with advanced disease","prompt":"Run a Reig 2022 BCLC calculation for a patient with ECOG 2, impaired liver function, transplant not an option, vascular invasion present, extrahepatic disease present, and 3 tumors with the largest at 6 cm — give me the stage and median survival."},{"title":"Borderline stage A vs B determination","prompt":"Can you check whether this HCC patient is BCLC stage A or B using Reig 2022? ECOG 0, preserved liver function, transplant option available, no vascular invasion, no extrahepatic disease, 3 nodules all under 3 cm with the largest at 2.9 cm."}],"resultDescription":"Returns the computed BCLC stage (0, A, B, C, or D) and the associated expected median survival figure per Reig 2022 criteria. Does not provide treatment recommendations, Milan/UCSF transplant listing eligibility, Child-Pugh computation, or ECOG assignment.","failureModes":["Missing required query parameters (ecog, preserved_liver_function, transplant_option, vascular_invasion, extrahepatic, tumor_count, largest_cm) returns a validation error","ECOG value outside 0-4 range rejected","largest_cm outside 0.1-30 range rejected","tumor_count outside 1-20 range rejected","Non-boolean values for flag fields return errors","Payment failure (x402) blocks the call if USDC payment is not provided"],"whenToPreferThis":"Use this endpoint when an AI agent needs to apply Reig 2022 BCLC staging arithmetic to pre-assembled clinical parameters for hepatocellular carcinoma. Choose this over manual lookup when staging needs to be computed programmatically in an oncology workflow or clinical decision support pipeline. Not appropriate as a substitute for physician assessment, transplant listing, Child-Pugh calculation, or imaging interpretation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:21:16.722Z","isFirstParty":false}