# Magent Modified Hoehn and Yahr Stage Lookup

> Magent Modified Hoehn and Yahr Stage Lookup 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-15).

Returns the published Goetz 2004 Table 1 description for a caller-assigned modified Hoehn and Yahr Parkinson's disease stage (1.0, 1.5, 2.0, 2.5, 3.0, 4.0, or 5.0).

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/modified_hoehn_yahr
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/magent-modified-hoehn-and-yahr-stage-lookup-f959ae3b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_okEVbQohMZS54Wc5ku-kU

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 magent-modified-hoehn-and-yahr-stage-lookup-f959ae3b
```

Example prompt: Look up the Goetz 2004 modified Hoehn and Yahr stage description for stage 2.5 — I need the published clinical text for that token.

## When to prefer this

Use this endpoint when you need the authoritative Goetz 2004 Table 1 description for a specific modified Hoehn and Yahr stage token (1.0, 1.5, 2.0, 2.5, 3.0, 4.0, 5.0). Prefer it over manual lookup when building clinical documentation tools, annotating research datasets, or validating stage tokens against the published scale. Do not use for the original integer-only 1–5 Hoehn and Yahr scale, UPDRS scoring, diagnosis, or patient examination — this is a text lookup only and not a medical device.

## Known failure modes

- Invalid stage token (e.g. '0', '1', '3' as integer, '0.5', '6.0') — endpoint rejects non-enumerated values
- Stage 0 submitted — not part of the modified scale, will be rejected
- Original Hoehn and Yahr integer scale values (1-5 without decimals) not accepted
- Missing required hy_stage query parameter returns an error
- Network or payment authorization failure (x402 payment required)

## How this service works

Goetz 2004 modified Hoehn and Yahr stage (Table 1). Caller-assigned tokens 1.0, 1.5, 2.0, 2.5, 3.0, 4.0, or 5.0 with the published description. No stage 0. Not the original integer-only 1-5 scale, not UPDRS, not a diagnosis, and not an outcome measure. magent does not examine the patient. Not a medical device.

## Output

The endpoint returns the official Goetz 2004 Table 1 description text corresponding to the submitted modified Hoehn and Yahr stage token, confirming the stage label and its published clinical definition (e.g. 'mild to moderate bilateral with some postural instability, physically independent' for stage 3.0).

## 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": [
      "hy_stage"
     ],
     "properties": {
      "hy_stage": {
       "type": "string",
       "description": "Goetz 2004 Table 1 modified Hoehn and Yahr stage as assigned by the caller: 1.0, 1.5, 2.0, 2.5, 3.0, 4.0, or 5.0 (exact tokens; reject 1, 3, 0, 0.5, 2.5.0). 1.0 unilateral only; 1.5 unilateral and axial; 2.0 bilateral without impairment of balance; 2.5 mild bilateral with recovery on pull test; 3.0 mild to moderate bilateral with some postural instability, physically independent; 4.0 severe disability, still able to walk or stand unassisted; 5.0 wheelchair bound or bedridden unless aided. No stage 0. Not the original integer-only 1-5 scale. Not UPDRS. magent does not examine the patient."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/magent-modified-hoehn-and-yahr-stage-lookup-f959ae3b/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)