{"uid":"cap_A5UqgT7mgnvVCJEs95IoJ","slug":"magent-psc-revised-risk-score-kim-2000-fdf5c633","name":"magent PSC Revised Risk Score (Kim 2000)","description":"Kim 2000 revised natural history model for primary sclerosing cholangitis (no histologic stage). R = 0.03*age_years + 0.54*ln(bilirubin_mg_dL) + 0.54*ln(AST_U_L) + 1.24*variceal_bleeding - 0.84*albumin_g_dL. Natural log. Returns R only; does not look up unpublished survival percents or invent risk bands. Not a transplant listing, biopsy order, PSC diagnosis, or lab assay. Not the original Mayo PSC biopsy model.","url":"https://api.magentlab.com/api/calc/psc_revised","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":["age_years","bilirubin_mg_dl","ast_u_l","albumin_g_dl","variceal_bleeding"],"properties":{"ast_u_l":{"type":"number","description":"Aspartate aminotransferase in U/L (1-10000, magent clamp). Must be positive. magent does not assay AST."},"age_years":{"type":"integer","description":"Age in whole years (18-120, magent clamp). Kim 2000 uses age in years in the R equation."},"albumin_g_dl":{"type":"number","description":"Serum albumin in g/dL (1.0-6.0, magent clamp). Must be positive. Kim 2000 uses g/dL. magent does not assay albumin."},"bilirubin_mg_dl":{"type":"number","description":"Total bilirubin in mg/dL (0.1-40, magent clamp). Must be positive; natural log is undefined at 0. Kim 2000 uses mg/dL. magent does not assay bilirubin."},"variceal_bleeding":{"type":"boolean","description":"History of variceal bleeding as assigned by the caller (Kim 2000): true (1) or false (0). magent does not diagnose bleeding."}}}},"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_i7JnWZk39heMaWBLJV60L","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 the Kim 2000 revised Mayo natural history R score for primary sclerosing cholangitis (PSC) without requiring histologic staging, using age, bilirubin, AST, albumin, and variceal bleeding history.","exampleAgentPrompt":"Calculate the Kim 2000 revised PSC R score for a 52-year-old patient with total bilirubin 3.2 mg/dL, AST 88 U/L, albumin 3.5 g/dL, and no history of variceal bleeding.","exampleUseCases":[{"title":"PSC disease severity for hepatology consult","prompt":"I need the revised Kim 2000 PSC R score for a 45-year-old with bilirubin 2.1 mg/dL, AST 120 U/L, albumin 3.8 g/dL, and no variceal bleeding history — no biopsy available."},{"title":"Tracking PSC progression over serial labs","prompt":"Run the Kim 2000 revised PSC natural history score for a 60-year-old patient: bilirubin is now 5.4 mg/dL, AST 210 U/L, albumin 2.9 g/dL, and they had a variceal bleed last year — what is the R value?"},{"title":"Pre-transplant evaluation risk quantification","prompt":"What is the revised Mayo PSC R score for a 38-year-old with bilirubin 1.8 mg/dL, AST 74 U/L, albumin 4.1 g/dL, and no variceal bleeding? Need the Kim 2000 no-biopsy version."}],"resultDescription":"Returns a single numeric R value computed as: 0.03×age + 0.54×ln(bilirubin_mg_dL) + 0.54×ln(AST_U_L) + 1.24×variceal_bleeding − 0.84×albumin_g_dL. This is the Kim 2000 revised natural history score for PSC. The endpoint does not return survival probabilities, risk bands, transplant recommendations, or diagnostic conclusions.","failureModes":["Missing any required parameter (age_years, bilirubin_mg_dl, ast_u_l, albumin_g_dl, variceal_bleeding) returns an error","Bilirubin or AST at or near zero would make the natural log undefined; values are clamped (bilirubin 0.1–40, AST 1–10000)","Age outside 18–120 or albumin outside 1.0–6.0 is clamped to range boundaries","Non-numeric or incorrectly typed inputs (e.g. string for age) will fail validation","Payment not provided or insufficient ($0.005 USDC via x402) results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need the Kim 2000 revised (no-biopsy) PSC natural history R score specifically — not the original Mayo PSC model that requires histologic stage. Ideal when liver biopsy data is unavailable and you only have routine labs (bilirubin, AST, albumin), patient age, and variceal bleeding history. Do not use if you need survival probability estimates, risk band classifications, a transplant listing decision, or a PSC diagnosis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:51:31.097Z","isFirstParty":false}