{"uid":"cap_MT6Ublgm0ptP0hvrea_1W","slug":"milan-criteria-calculator-for-hcc-mazzaferro-1996-fda68c07","name":"Milan Criteria Calculator for HCC (Mazzaferro 1996)","description":"Mazzaferro 1996 Milan criteria for small HCC in cirrhosis: meets_milan is true iff there is no preoperative vascular invasion, no extrahepatic or lymph-node disease, and either one tumor 5 cm or less or two to three nodules each 3 cm or less. Four or more nodules fail. tumor_count and largest_cm are caller-assigned; magent does not interpret imaging. Not a medical device, not a transplant listing, and not UCSF criteria.","url":"https://api.magentlab.com/api/calc/milan","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":["tumor_count","largest_cm","vascular_invasion","extrahepatic"],"properties":{"largest_cm":{"type":"number","description":"Largest tumor diameter in centimetres (0.1-30). Single tumor meets at 5.0 cm and fails at 5.1. Two or three nodules meet at 3.0 cm and fail 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. A single tumor may be up to 5 cm; two or three nodules must each be 3 cm or less. Four or more nodules fail Milan. magent does not interpret imaging."},"extrahepatic":{"type":"boolean","description":"Evident or suspected extrahepatic or lymph-node disease as assigned by the caller. true fails Milan (Mazzaferro 1996 excluded extrahepatic disease). true or false. magent does not interpret imaging."},"vascular_invasion":{"type":"boolean","description":"Preoperative vascular (vessel) invasion as assigned by the caller. true fails Milan (Mazzaferro 1996 excluded preoperative vessel invasion). true or false. magent does not interpret imaging."}}}},"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_zpCT7CxhWfob737BH-nWK","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":"Evaluates whether a hepatocellular carcinoma patient meets the 1996 Milan criteria for liver transplantation eligibility based on tumor count, largest tumor diameter, vascular invasion, and extrahepatic disease.","exampleAgentPrompt":"Does this HCC patient meet the 1996 Milan criteria? They have 2 tumor nodules, the largest is 2.8 cm, no vascular invasion detected preoperatively, and no extrahepatic or lymph-node disease.","exampleUseCases":[{"title":"Single large tumor transplant eligibility","prompt":"I have a cirrhosis patient with a single hepatocellular carcinoma nodule measuring 4.9 cm, no evidence of vascular invasion, and no extrahepatic disease — do they meet Milan criteria for transplant?"},{"title":"Multi-nodule HCC borderline case","prompt":"Can you check Milan criteria for a patient with 3 HCC nodules, the largest being 3.0 cm exactly, no vascular invasion found preoperatively, and no extrahepatic spread?"},{"title":"Automatic exclusion check for 4-nodule HCC","prompt":"My patient has 4 HCC nodules, the largest is 2.5 cm, no vascular invasion, and no extrahepatic disease — do they still fail Milan criteria because of the nodule count?"}],"resultDescription":"Returns a meets_milan boolean indicating whether the patient satisfies all four Milan criteria: tumor count 1-3, largest tumor diameter within allowed thresholds (≤5 cm for single, ≤3 cm for 2-3 nodules), no preoperative vascular invasion, and no extrahepatic or lymph-node disease. Four or more nodules automatically fail.","failureModes":["Missing required query parameters (tumor_count, largest_cm, vascular_invasion, extrahepatic) results in a 400 error","tumor_count outside integer range 1-20 may be rejected","largest_cm outside numeric range 0.1-30 may be rejected","Passing non-boolean values for vascular_invasion or extrahepatic causes validation failure","Payment failure or missing x402 header results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need a fast, deterministic computation of the 1996 Mazzaferro Milan criteria specifically — not UCSF criteria, not ABIC, not other HCC scoring systems. Ideal when the caller has already interpreted imaging and assigned tumor count and size values, and needs the eligibility boolean for transplant workflow automation or clinical documentation support.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:58:34.377Z","isFirstParty":false}