{"uid":"cap_s6Q31WQOnjLH33Fex3gRg","slug":"magent-bam-brief-addiction-monitor-scorer-c8e2551c","name":"magent BAM (Brief Addiction Monitor) Scorer","description":"Cacciola 2013 Brief Addiction Monitor (BAM; public-domain VA instrument). Three subscales only: Use (items 4+5+6, 0-90), Risk (items 1+2+3+8+11+15, 0-102 on Table 1 0-4 Likert plus 0-30 days), Protective (items 9+10+12+13+14+16, 0-98; income No=0 Yes=30). Items 7a-g and 17 collected, not summed. No total BAM score. magent does not interview the patient. Not a diagnosis, level-of-care order, or medical device.","url":"https://api.magentlab.com/api/calc/bam","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":["physical_health","days_sleep","days_psychological","days_alcohol","days_heavy_alcohol","days_drug","drug_marijuana","drug_sedatives","drug_cocaine","drug_stimulants","drug_opiates","drug_inhalants","drug_other","craving","abstinence_confidence","days_self_help","days_risky","religion_support","days_structured","adequate_income","family_arguments","days_supportive","recovery_satisfaction"],"properties":{"craving":{"type":"integer","description":"Caller-assigned Cacciola 2013 Table 1 item 8 craving rating (integer 0-4; 0 not at all, 4 extremely). Kept on Table 1's 0-4 scale. magent does not interview the patient."},"days_drug":{"type":"integer","description":"Caller-assigned Cacciola 2013 Table 1 item 6 days of drug use in the prior 30 days (integer 0-30). magent does not interview the patient."},"days_risky":{"type":"integer","description":"Caller-assigned Cacciola 2013 Table 1 item 11 days in risky situations in the prior 30 days (integer 0-30). magent does not interview the patient."},"days_sleep":{"type":"integer","description":"Caller-assigned Cacciola 2013 Table 1 item 2 days of trouble sleeping in the prior 30 days (integer 0-30). magent does not interview the patient."},"drug_other":{"type":"boolean","description":"Caller-assigned Cacciola 2013 item 7 checklist slot 7g (other drugs). Collected and not summed. magent does not interview the patient."},"days_alcohol":{"type":"integer","description":"Caller-assigned Cacciola 2013 Table 1 item 4 days of alcohol use in the prior 30 days (integer 0-30). magent does not interview the patient."},"drug_cocaine":{"type":"boolean","description":"Caller-assigned Cacciola 2013 item 7 checklist slot 7c (cocaine/crack). Collected and not summed. magent does not interview the patient."},"drug_opiates":{"type":"boolean","description":"Caller-assigned Cacciola 2013 item 7 checklist slot 7e (opiates). Collected and not summed. magent does not interview the patient."},"days_self_help":{"type":"integer","description":"Caller-assigned Cacciola 2013 Table 1 item 10 days of self-help group attendance in the prior 30 days (integer 0-30). magent does not interview the patient."},"drug_inhalants":{"type":"boolean","description":"Caller-assigned Cacciola 2013 item 7 checklist slot 7f (inhalants). Collected and not summed. magent does not interview the patient."},"drug_marijuana":{"type":"boolean","description":"Caller-assigned Cacciola 2013 item 7 checklist slot 7a (marijuana). Collected and not summed. Table 1 names a 6-category checklist without listing categories; 7a-g follow the VA public-domain slots. magent does not interview the patient."},"drug_sedatives":{"type":"boolean","description":"Caller-assigned Cacciola 2013 item 7 checklist slot 7b (sedatives/tranquilizers). Collected and not summed. magent does not interview the patient."},"adequate_income":{"type":"boolean","description":"Caller-assigned Cacciola 2013 Table 1 item 14 adequate income (true or false). No scores 0; Yes scores 30 (VA public-domain BAM-R item-14 map). magent does not interview the patient."},"days_structured":{"type":"integer","description":"Caller-assigned Cacciola 2013 Table 1 item 13 days of structured activities in the prior 30 days (integer 0-30). magent does not interview the patient."},"days_supportive":{"type":"integer","description":"Caller-assigned Cacciola 2013 Table 1 item 16 days with supportive family/friends in the prior 30 days (integer 0-30). magent does not interview the patient."},"drug_stimulants":{"type":"boolean","description":"Caller-assigned Cacciola 2013 item 7 checklist slot 7d (other stimulants). Collected and not summed. magent does not interview the patient."},"physical_health":{"type":"integer","description":"Caller-assigned Cacciola 2013 Table 1 item 1 physical-health rating (integer 0-4; 0 excellent, 4 poor). Healthiest published anchor is 0. Kept on Table 1's 0-4 scale (not a 0/8/15/22/30 recode). magent does not interview the patient."},"family_arguments":{"type":"integer","description":"Caller-assigned Cacciola 2013 Table 1 item 15 arguments with family/friends rating (integer 0-4; 0 not at all, 4 extremely). Kept on Table 1's 0-4 scale. magent does not interview the patient."},"religion_support":{"type":"integer","description":"Caller-assigned Cacciola 2013 Table 1 item 12 religion/spirituality support rating (integer 0-4; 0 not at all, 4 extremely). Kept on Table 1's 0-4 scale. magent does not interview the patient."},"days_heavy_alcohol":{"type":"integer","description":"Caller-assigned Cacciola 2013 Table 1 item 5 days of heavy alcohol use in the prior 30 days (integer 0-30). Contingent on item 4 in that paper; this tool accepts 0-30 independently. magent does not interview the patient."},"days_psychological":{"type":"integer","description":"Caller-assigned Cacciola 2013 Table 1 item 3 days of psychological problems in the prior 30 days (integer 0-30). magent does not interview the patient."},"abstinence_confidence":{"type":"integer","description":"Caller-assigned Cacciola 2013 Table 1 item 9 abstinence-confidence rating (integer 0-4; 0 not at all, 4 extremely). Kept on Table 1's 0-4 scale. magent does not interview the patient."},"recovery_satisfaction":{"type":"integer","description":"Caller-assigned Cacciola 2013 Table 1 item 17 recovery-satisfaction rating (integer 0-4; 0 not at all, 4 extremely). Collected and not summed. magent does not interview 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_6cuMC-aBESIyECJ4qeGkf","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 Cacciola 2013 Brief Addiction Monitor (BAM) subscale scores — Use, Risk, and Protective — from caller-supplied item values without interviewing the patient.","exampleAgentPrompt":"Calculate the BAM subscale scores for a patient who used alcohol 10 days, heavy alcohol 3 days, drugs 0 days in the last 30 days, craving rated 2, 5 days in risky situations, physical health 1, 4 days trouble sleeping, 2 days psychological distress, 8 days self-help, 6 days structured activity, has adequate income, 1 family argument day, 12 days supportive contact, abstinence confidence 3, recovery satisfaction 3, 15 days risky situations, no marijuana or other drug types checked.","exampleUseCases":[{"title":"Addiction treatment progress tracking","prompt":"Score the BAM for a patient who drank alcohol 15 days, heavy drinking 5 days, no drug use, craving 3, physical health 2, sleep trouble 10 days, psychological distress 8 days, risky situations 7 days, self-help 4 days, structured activity 5 days, no adequate income, family arguments 3 days, supportive contact 6 days, abstinence confidence 2, recovery satisfaction 2 — no marijuana, sedatives, cocaine, stimulants, opiates, inhalants, or other drugs."},{"title":"Intake BAM screening for new SUD patient","prompt":"Run a BAM calculation for a new intake: alcohol 0 days, heavy alcohol 0 days, drug use 20 days, craving 4, physical health 3, sleep trouble 20 days, psychological distress 18 days, risky situations 12 days, self-help 0 days, structured activity 1 day, no income, family arguments 15 days, supportive contact 2 days, abstinence confidence 1, recovery satisfaction 1, marijuana checked, opiates checked, no other drug types."},{"title":"Monthly BAM reassessment for outpatient","prompt":"Compute the BAM subscores for a monthly reassessment: 5 alcohol days, 1 heavy alcohol day, 0 drug days, craving 1, physical health 1, 3 sleep trouble days, 1 psychological distress day, 0 risky situation days, 12 self-help days, 18 structured activity days, has adequate income, 0 family argument days, 22 supportive contact days, abstinence confidence 4, recovery satisfaction 4, no drug types checked."}],"resultDescription":"Returns the three BAM subscale scores: Use (sum of items 4+5+6, range 0-90), Risk (sum of items 1+2+3+8+11+15, range 0-102), and Protective (sum of items 9+10+12+13+14+16, range 0-98), plus the raw collected values for items 7a-g and 17 which are not summed. No total BAM score is produced. This is not a diagnosis, level-of-care order, or medical device output.","failureModes":["Missing required query parameters returns an error indicating which fields are absent","Out-of-range integer values (e.g. days > 30 or Likert > 4) may produce incorrect subscale totals or validation errors","Payment failure via x402 results in a 402 response and no scoring result","Caller misassigning item values (e.g. swapping days-based items with Likert items) produces silently incorrect subscale scores"],"whenToPreferThis":"Use this endpoint when you need to compute validated BAM subscale scores from pre-collected item responses according to the Cacciola 2013 scoring algorithm, particularly in VA or SUD clinical workflows. Prefer this over manual calculation to ensure correct subscale groupings and score ranges. Do not use this endpoint to interview patients, produce diagnoses, or determine level of care.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:58:20.315Z","isFirstParty":false}