{"uid":"cap_a6DcmvLuIClRb4MdU3h3P","slug":"magent-aims-score-calculator-224efc10","name":"magent AIMS Score Calculator","description":"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.","url":"https://api.magentlab.com/api/calc/aims","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":["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_perioral":{"enum":[0,1,2,3,4],"type":"integer","description":"Caller-assigned Guy 1976 AIMS item 2 lips and perioral area (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."},"incapacitation":{"enum":[0,1,2,3,4],"type":"integer","description":"Caller-assigned Guy 1976 AIMS item 9 incapacitation due to abnormal movements (integer 0-4): 0 none, 1 minimal, 2 mild, 3 moderate, 4 severe. Recorded only; not added to the dyskinesia total. magent does not examine the patient."},"wears_dentures":{"type":"boolean","description":"Caller-assigned Guy 1976 AIMS item 12 does the patient usually wear dentures (true or false). Recorded only; not added to the dyskinesia total. magent does not examine the patient."},"dental_problems":{"type":"boolean","description":"Caller-assigned Guy 1976 AIMS item 11 current problems with teeth and/or dentures (true or false). Recorded only; not added to the dyskinesia total. magent does not examine the patient."},"overall_severity":{"enum":[0,1,2,3,4],"type":"integer","description":"Caller-assigned Guy 1976 AIMS item 8 overall severity of abnormal movements (integer 0-4): 0 none, 1 minimal may be extreme normal, 2 mild, 3 moderate, 4 severe. Recorded only; not added to the dyskinesia total. magent does not examine the patient."},"facial_expression":{"enum":[0,1,2,3,4],"type":"integer","description":"Caller-assigned Guy 1976 AIMS item 1 muscles of facial expression (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."},"lower_extremities":{"enum":[0,1,2,3,4],"type":"integer","description":"Caller-assigned Guy 1976 AIMS item 6 lower extremities (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."},"upper_extremities":{"enum":[0,1,2,3,4],"type":"integer","description":"Caller-assigned Guy 1976 AIMS item 5 upper extremities (integer 0-4): 0 none, 1 minimal may be extreme normal, 2 mild, 3 moderate, 4 severe. Include choreic and athetoid movements. Do not include tremor. Rate highest severity observed. magent does not examine the patient."}}}},"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_TNBAc-cTAJBVMJF9X3jtT","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 Guy 1976 Abnormal Involuntary Movement Scale (AIMS) total score from 7 movement items, plus returns 5 required non-scored clinical items","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Psychiatric clinic AIMS monitoring","prompt":"My patient on long-term antipsychotics was just assessed. Rate scores are: facial expression 1, lips 2, jaw 1, tongue 3, upper extremities 2, lower extremities 1, trunk 1, overall severity 2, incapacitation 1, awareness 2, dental problems 0, dentures 0. What is their AIMS total?"},{"title":"Automated EHR scoring integration","prompt":"I need to automatically calculate an AIMS total for charting — the clinician entered: facial 0, lips 1, jaw 0, tongue 1, upper extremities 0, lower extremities 0, trunk 0, overall severity 1, incapacitation 0, awareness 0, dental problems 1, dentures 1. Give me the AIMS sum."},{"title":"Research data pipeline scoring","prompt":"For a clinical trial data pipeline, calculate the AIMS score from these item ratings: facial expression 3, lips 3, jaw 2, tongue 3, upper extremities 2, lower extremities 2, trunk 2, overall severity 3, incapacitation 2, awareness 3, dental problems 0, dentures 0."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:21:16.725Z","isFirstParty":false}