# magent AIMS Score Calculator

> magent AIMS Score Calculator 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).

Computes the Guy 1976 Abnormal Involuntary Movement Scale (AIMS) total score from 7 movement items, plus returns 5 required non-scored clinical items

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/aims
- 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-aims-score-calculator-224efc10
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_a6DcmvLuIClRb4MdU3h3P

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-aims-score-calculator-224efc10
```

Example prompt: Calculate the AIMS score for a patient with these observer-assigned ratings: facial expression 2, lips/perioral 1, jaw 1, tongue 2, upper extremities 1, lower extremities 0, trunk 1, overall severity 2, incapacitation 1, awareness 1 (aware, no distress), dental problems 0, dentures 0.

## When to prefer this

Use this endpoint when you need to compute a standardized AIMS dyskinesia score from clinician-observed ratings and want a verified implementation of the Guy 1976 scale with correct item weighting (items 8–12 recorded but not summed). Prefer this over manual arithmetic to avoid scoring errors in clinical or research pipelines. Not appropriate for diagnosis, patient examination, or determining whether tardive dyskinesia is present.

## Known failure modes

- Missing any required query parameter returns an error — all 12 parameters are mandatory
- Values outside the 0–4 enum for any item are rejected
- Non-integer values for movement items cause validation failure
- Payment failure (402) if x402 USDC payment is not provided
- Network timeout if api.magentlab.com is unreachable

## How this service works

Guy 1976 Abnormal Involuntary Movement Scale (AIMS): seven 0-4 movement items summed (max 28). Rate highest severity observed. Items 8-12 (overall severity, incapacitation, awareness, dental problems, dentures) are required and returned, not added to the total. No activation subtraction. Not a tardive dyskinesia diagnosis. magent does not examine the patient. Not a medical device.

## Output

Returns the AIMS dyskinesia total score (integer 0–28) computed by summing items 1–7 (facial expression, lips/perioral, jaw, tongue, upper extremities, lower extremities, trunk). Also returns items 8–12 (overall severity, incapacitation, awareness, dental problems, dentures) as recorded values only, not added to the total. No activation procedure subtraction is applied.

## 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": [
      "facial_expression",
      "lips_perioral",
      "jaw",
      "tongue",
      "upper_extremities",
      "lower_extremities",
      "trunk",
      "overall_severity",
      "incapacitation",
      "awareness",
      "dental_problems",
      "wears_dentures"
     ],
     "properties": {
      "jaw": {
       "enum": [
        0,
        1,
        2,
        3,
        4
       ],
       "type": "integer",
       "description": "Caller-assigned Guy 1976 AIMS item 3 jaw (integer 0-4): 0 none, 1 minimal may be extreme normal, 2 mild, 3 moderate, 4 severe. Rate highest severity observed. magent does not examine the patient."
      },
      "trunk": {
       "enum": [
        0,
        1,
        2,
        3,
        4
       ],
       "type": "integer",
       "description": "Caller-assigned Guy 1976 AIMS item 7 neck, shoulders, hips (integer 0-4): 0 none, 1 minimal may be extreme normal, 2 mild, 3 moderate, 4 severe. Rate highest severity observed. magent does not examine the patient."
      },
      "tongue": {
       "enum": [
        0,
        1,
        2,
        3,
        4
       ],
       "type": "integer",
       "description": "Caller-assigned Guy 1976 AIMS item 4 tongue (integer 0-4): 0 none, 1 minimal may be extreme normal, 2 mild, 3 moderate, 4 severe. Rate increase in movement, not inability to sustain. Rate highest severity observed. magent does not examine the patient."
      },
      "awareness": {
       "enum": [
        0,
        1,
        2,
        3,
        4
       ],
       "type": "integer",
       "description": "Caller-assigned Guy 1976 AIMS item 10 patient's awareness of abnormal movements (integer 0-4): 0 no awareness, 1 aware no distress, 2 aware mild distress, 3 aware moderate distress, 4 aware severe distress. Rate only the patient's report. Recorded only; not added to the dyskinesia total. magent does not examine the patient."
      },
      "lips_p
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/magent-aims-score-calculator-224efc10/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)