# Tokuhashi Score Calculator (Revised 2005)

> Tokuhashi Score Calculator (Revised 2005) is a paid API for AI agents from api.magentlab.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Computes the Revised Tokuhashi 2005 score (0–15) for estimating prognosis in patients with spinal metastases, returning a numeric total and survival band.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/tokuhashi
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokuhashi-score-calculator-revised-2005-e537c321
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_t-xOwmTE_89BMh2F1jdp8

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 tokuhashi-score-calculator-revised-2005-e537c321
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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).

## 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": [
      "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": {
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokuhashi-score-calculator-revised-2005-e537c321/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)