{"uid":"cap_t-xOwmTE_89BMh2F1jdp8","slug":"tokuhashi-score-calculator-revised-2005-e537c321","name":"Tokuhashi Score Calculator (Revised 2005)","description":"Revised Tokuhashi 2005 (0-15). KPS poor/moderate/good 0/1/2. Extraspinal ge_3/one_or_two/none 0/1/2. Vertebral ge_3/two/one 0/1/2. Visceral unremovable/removable/none 0/1/2. Primary lung osteosarcoma stomach bladder esophagus pancreas 0; liver gallbladder unidentified 1; others 2; kidney uterus 3; rectum 4; thyroid prostate breast carcinoid 5. Palsy complete/incomplete/none 0/1/2. Bands 0-8/9-11/12-15. Not an operative order. Not 1990. Not SINS. Does not read imaging. Not a medical device.","url":"https://api.magentlab.com/api/calc/tokuhashi","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":["kps","extraspinal","vertebral","visceral","primary","palsy"],"properties":{"kps":{"enum":["poor","moderate","good"],"type":"string","description":"Caller-assigned Karnofsky performance status band (Tokuhashi 2005). poor (KPS 10–40%) scores 0; moderate (50–70%) scores 1; good (80–100%) scores 2. magent does not observe the patient."},"palsy":{"enum":["complete","incomplete","none"],"type":"string","description":"Caller-assigned spinal cord palsy (Tokuhashi 2005). complete (Frankel A/B) scores 0; incomplete (Frankel C/D) scores 1; none (Frankel E) scores 2. magent does not examine the patient."},"primary":{"enum":["lung","osteosarcoma","stomach","bladder","esophagus","pancreas","liver","gallbladder","unidentified","others","kidney","uterus","rectum","thyroid","prostate","breast","carcinoid"],"type":"string","description":"Caller-assigned Tokuhashi 2005 primary site group. lung, osteosarcoma, stomach, bladder, esophagus, pancreas score 0; liver, gallbladder, unidentified score 1; others scores 2; kidney, uterus score 3; rectum scores 4; thyroid, prostate, breast, carcinoid score 5. others is the published catch-all token. magent does not infer histology."},"visceral":{"enum":["unremovable","removable","none"],"type":"string","description":"Caller-assigned metastases to major internal organs (Tokuhashi 2005). unremovable scores 0; removable scores 1; none scores 2. magent does not read imaging."},"vertebral":{"enum":["ge_3","two","one"],"type":"string","description":"Caller-assigned number of vertebral metastases (Tokuhashi 2005). ge_3 (≥3) scores 0; two scores 1; one scores 2. There is no vertebral none token. magent does not read imaging."},"extraspinal":{"enum":["ge_3","one_or_two","none"],"type":"string","description":"Caller-assigned number of extraspinal bone metastases (Tokuhashi 2005). ge_3 (≥3) scores 0; one_or_two scores 1; none scores 2. magent does not read 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_aSEFlt6zk2rC0jZjRjFeL","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 Revised Tokuhashi 2005 score (0–15) for estimating prognosis in patients with spinal metastases, returning a numeric total and survival band.","exampleAgentPrompt":"Calculate the revised Tokuhashi 2005 score for a patient with good KPS, two extraspinal bone metastases, one vertebral metastasis, no visceral metastases, breast cancer as the primary, and no spinal cord palsy.","exampleUseCases":[{"title":"Palliative team prognosis review","prompt":"I'm reviewing a patient with lung cancer who has poor KPS, three or more extraspinal bone mets, two vertebral mets, unremovable visceral mets, and complete spinal cord palsy — can you run the Tokuhashi 2005 score and tell me which survival band they fall into?"},{"title":"Spine oncology clinic pre-consult scoring","prompt":"Before the spine consult, run the Tokuhashi score for our patient: moderate KPS, one vertebral met, no extraspinal bone mets, removable visceral mets, primary is prostate, and no neurological deficit."},{"title":"Surgical decision support for metastatic spine disease","prompt":"We're deciding on surgical versus palliative management for a patient with thyroid cancer spine mets — good KPS, one vertebral lesion, two extraspinal bone mets, no visceral mets, incomplete palsy. What's the Tokuhashi 2005 total and band?"}],"resultDescription":"Returns the Revised Tokuhashi 2005 composite score (integer 0–15), the survival band classification (0–8, 9–11, or 12–15), and the individual subscores for each of the six clinical parameters (KPS, extraspinal mets, vertebral mets, visceral mets, primary site, palsy).","failureModes":["Missing required query parameter (kps, extraspinal, vertebral, visceral, primary, or palsy) returns a 400 error","Invalid enum value for any parameter returns a 400 error","Network timeout or server error returns a 5xx response","Incorrect primary site token (e.g. using a free-text name instead of the defined enum) returns a validation error"],"whenToPreferThis":"Use this endpoint when you need a fast, deterministic computation of the Revised Tokuhashi 2005 score from caller-supplied clinical parameters. Prefer it over manual lookup tables when building clinical decision-support agents, automating oncology documentation, or integrating prognosis scoring into electronic workflows. This endpoint is not a substitute for SINS scoring, imaging interpretation, or the original 1990 Tokuhashi criteria.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T01:12:59.170Z","isFirstParty":false}