# Brief Addiction Monitor (BAM) BAM Status: LIVE Price: $0.005 USDC `GET /api/calc/bam` HTML: https://magentlab.com/docs/bam Markdown: https://magentlab.com/docs/bam.md Not a medical device. Not a diagnosis, dose, or listing recommendation. ## What it computes Score the three Cacciola 2013 / VA public-domain BAM subscales (Use, Risk, Protective) from caller-assigned Table 1 prior-30-day items. No single total BAM score. ## When to use When an agent already has Cacciola 2013 Table 1 BAM item values and needs the published Use, Risk, and Protective sums. magent does not interview the patient, invent a total BAM score, or issue a level-of-care order. ## When not to use - Not a medical device and not a diagnosis of a substance use disorder. - Not a level-of-care order. magent does not interview the patient. Each item is caller-assigned from Cacciola 2013 Table 1. - Cacciola 2013 and the VA public-domain instrument do not produce a psychometrically refined total BAM score. This tool returns Use, Risk, and Protective only and does not invent named low/high clinical bands. - Table 1 Likert items (physical health, craving, abstinence confidence, religion/spirituality, family arguments, recovery satisfaction) stay on Table 1's 0-4 scale. This tool does not apply the later VA BAM-R 0/8/15/22/30 recode, so Risk is 0-102 and Protective is 0-98 rather than 0-180. - Items 7a-g and 17 are collected and are not included in the three subscale sums. Table 1 notes a 6-category drug checklist without naming the categories; 7a-g follow the VA public-domain slots. ## Formula ``` Use = days_alcohol + days_heavy_alcohol + days_drug (Cacciola 2013 Table 1 items 4+5+6; each 0-30; max 90); Risk = physical_health + days_sleep + days_psychological + craving + days_risky + family_arguments (items 1+2+3+8+11+15; Table 1 Likert 0-4 kept on Table 1's own scale, day-counts 0-30; max 102); Protective = abstinence_confidence + days_self_help + religion_support + days_structured + adequate_income + days_supportive (items 9+10+12+13+14+16; Table 1 Likert 0-4, day-counts 0-30, income No=0 Yes=30; max 98); items 7a-g and 17 collected and not summed. No single total BAM score. magent does not interview the patient. Not a diagnosis or level-of-care order. ``` ## Citation [Development and initial evaluation of the Brief Addiction Monitor (BAM)](https://doi.org/10.1016/j.jsat.2012.07.013) Cacciola JS, Alterman AI, DePhilippis D, et al. J Subst Abuse Treat. 2013;44(5):492-499 DOI: [10.1016/j.jsat.2012.07.013](https://doi.org/10.1016/j.jsat.2012.07.013) ## Worked example ### All day-counts 0, health excellent, income no Given: `abstinence_confidence=0, adequate_income=false, craving=0, days_alcohol=0, days_drug=0, days_heavy_alcohol=0, days_psychological=0, days_risky=0, days_self_help=0, days_sleep=0, days_structured=0, days_supportive=0, drug_cocaine=false, drug_inhalants=false, drug_marijuana=false, drug_opiates=false, drug_other=false, drug_sedatives=false, drug_stimulants=false, family_arguments=0, physical_health=0, recovery_satisfaction=0, religion_support=0` 1. Table 1 healthiest health anchor is 0 (excellent); remaining Likert items 0 (not at all); all day-counts 0; income no (0); 7a-g false; item 17 collected and not summed 2. Use = 0+0+0 = 0 (max 90); Risk = 0+0+0+0+0+0 = 0 (max 102); Protective = 0+0+0+0+0+0 = 0 (max 98) ### Use items at 30 days Given: `abstinence_confidence=0, adequate_income=false, craving=0, days_alcohol=30, days_drug=30, days_heavy_alcohol=30, days_psychological=0, days_risky=0, days_self_help=0, days_sleep=0, days_structured=0, days_supportive=0, drug_cocaine=false, drug_inhalants=false, drug_marijuana=false, drug_opiates=false, drug_other=false, drug_sedatives=false, drug_stimulants=false, family_arguments=0, physical_health=0, recovery_satisfaction=0, religion_support=0` 1. days_alcohol 30 + days_heavy_alcohol 30 + days_drug 30; remaining Table 1 items at the floor example 2. Use = 90 (max 90); Risk 0; Protective 0. Not a diagnosis or level-of-care order. ## Also searched as - Brief Addiction Monitor - BAM-R - BAM Continuous - Cacciola BAM - addiction monitor - BAM subscales - Brief Addiction Monitor Revised ## Parameters - `physical_health` (integer, required): 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. - `days_sleep` (integer, required): 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. - `days_psychological` (integer, required): 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. - `days_alcohol` (integer, required): 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. - `days_heavy_alcohol` (integer, required): 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_drug` (integer, required): 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. - `drug_marijuana` (boolean, required): 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` (boolean, required): Caller-assigned Cacciola 2013 item 7 checklist slot 7b (sedatives/tranquilizers). Collected and not summed. magent does not interview the patient. - `drug_cocaine` (boolean, required): Caller-assigned Cacciola 2013 item 7 checklist slot 7c (cocaine/crack). Collected and not summed. magent does not interview the patient. - `drug_stimulants` (boolean, required): Caller-assigned Cacciola 2013 item 7 checklist slot 7d (other stimulants). Collected and not summed. magent does not interview the patient. - `drug_opiates` (boolean, required): Caller-assigned Cacciola 2013 item 7 checklist slot 7e (opiates). Collected and not summed. magent does not interview the patient. - `drug_inhalants` (boolean, required): Caller-assigned Cacciola 2013 item 7 checklist slot 7f (inhalants). Collected and not summed. magent does not interview the patient. - `drug_other` (boolean, required): Caller-assigned Cacciola 2013 item 7 checklist slot 7g (other drugs). Collected and not summed. magent does not interview the patient. - `craving` (integer, required): 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. - `abstinence_confidence` (integer, required): 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. - `days_self_help` (integer, required): 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. - `days_risky` (integer, required): 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. - `religion_support` (integer, required): 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_structured` (integer, required): 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. - `adequate_income` (boolean, required): 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. - `family_arguments` (integer, required): 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. - `days_supportive` (integer, required): 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. - `recovery_satisfaction` (integer, required): 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. ## Bulk (POST) POST the same path with a JSON items array. The first item is the GET unit; each additional item is $0.002. Invalid items return HTTP 400 before settlement. Method: `POST /api/calc/bam` Max items: 25 Price: unit_amount + extra_item_amount * (n - 1) (unit 5000 atomic, extra 2000 atomic) Status: PREVIEW - 1 to 25 items. Each item uses the same keys as the GET query parameters. - POST of 1 item costs the same as GET. Lists longer than 25: chunk into multiple POSTs. Extra items still execute; do not pad dummy rows. - The first invalid item fails the whole request (index in the 400 JSON). You are not charged. - HTTP 200 is {count, path, items}. Each items[i] is the GET 200 body for that row. - Catalog misses (empty matches, found=false) stay paid 200s inside that slot. - x402 resource URL is this path plus n and body_sha256. Browsers that prefer text/html get the same paywall as GET; Pay retries POST with the same items. Example request: ```json { "items": [ { "abstinence_confidence": "0", "adequate_income": "false", "craving": "0", "days_alcohol": "0", "days_drug": "0", "days_heavy_alcohol": "0", "days_psychological": "0", "days_risky": "0", "days_self_help": "0", "days_sleep": "0", "days_structured": "0", "days_supportive": "0", "drug_cocaine": "false", "drug_inhalants": "false", "drug_marijuana": "false", "drug_opiates": "false", "drug_other": "false", "drug_sedatives": "false", "drug_stimulants": "false", "family_arguments": "0", "physical_health": "0", "recovery_satisfaction": "0", "religion_support": "0" }, { "abstinence_confidence": "0", "adequate_income": "false", "craving": "0", "days_alcohol": "0", "days_drug": "0", "days_heavy_alcohol": "0", "days_psychological": "0", "days_risky": "0", "days_self_help": "0", "days_sleep": "0", "days_structured": "0", "days_supportive": "0", "drug_cocaine": "false", "drug_inhalants": "false", "drug_marijuana": "false", "drug_opiates": "false", "drug_other": "false", "drug_sedatives": "false", "drug_stimulants": "false", "family_arguments": "0", "physical_health": "0", "recovery_satisfaction": "0", "religion_support": "0" } ] } ``` Human paywall (two-item fixture): https://api.magentlab.com/paywall/bulk/bam Example 200: ```json { "count": 2, "path": "/api/calc/bam", "items": [ { "components": [ { "value": 0, "factor": "physical_health", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "days_sleep", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "days_psychological", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "days_alcohol", "points": 0, "present": true, "subscale": "use" }, { "value": 0, "factor": "days_heavy_alcohol", "points": 0, "present": true, "subscale": "use" }, { "value": 0, "factor": "days_drug", "points": 0, "present": true, "subscale": "use" }, { "value": false, "factor": "drug_marijuana", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_sedatives", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_cocaine", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_stimulants", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_opiates", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_inhalants", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_other", "points": 0, "present": false, "subscale": "collected" }, { "value": 0, "factor": "craving", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "abstinence_confidence", "points": 0, "present": true, "subscale": "protective" }, { "value": 0, "factor": "days_self_help", "points": 0, "present": true, "subscale": "protective" }, { "value": 0, "factor": "days_risky", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "religion_support", "points": 0, "present": true, "subscale": "protective" }, { "value": 0, "factor": "days_structured", "points": 0, "present": true, "subscale": "protective" }, { "value": false, "factor": "adequate_income", "points": 0, "present": false, "subscale": "protective" }, { "value": 0, "factor": "family_arguments", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "days_supportive", "points": 0, "present": true, "subscale": "protective" }, { "value": 0, "factor": "recovery_satisfaction", "points": 0, "present": true, "subscale": "collected" } ], "use": 0, "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.", "citation": { "authors": "Cacciola JS, Alterman AI, DePhilippis D, et al.", "doi": "10.1016/j.jsat.2012.07.013", "id": "cacciola-2013", "pmid": "22898042", "source": "J Subst Abuse Treat. 2013;44(5):492-499", "title": "Development and initial evaluation of the Brief Addiction Monitor (BAM)" }, "formula": "bam", "formula_expression": "Use = days_alcohol + days_heavy_alcohol + days_drug (Cacciola 2013 Table 1 items 4+5+6; each 0-30; max 90); Risk = physical_health + days_sleep + days_psychological + craving + days_risky + family_arguments (items 1+2+3+8+11+15; Table 1 Likert 0-4 kept on Table 1's own scale, day-counts 0-30; max 102); Protective = abstinence_confidence + days_self_help + religion_support + days_structured + adequate_income + days_supportive (items 9+10+12+13+14+16; Table 1 Likert 0-4, day-counts 0-30, income No=0 Yes=30; max 98); items 7a-g and 17 collected and not summed. No single total BAM score. magent does not interview the patient. Not a diagnosis or level-of-care order.", "risk": 0, "protective": 0, "protective_max": 98, "risk_max": 102, "use_max": 90 }, { "components": [ { "value": 0, "factor": "physical_health", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "days_sleep", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "days_psychological", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "days_alcohol", "points": 0, "present": true, "subscale": "use" }, { "value": 0, "factor": "days_heavy_alcohol", "points": 0, "present": true, "subscale": "use" }, { "value": 0, "factor": "days_drug", "points": 0, "present": true, "subscale": "use" }, { "value": false, "factor": "drug_marijuana", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_sedatives", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_cocaine", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_stimulants", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_opiates", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_inhalants", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_other", "points": 0, "present": false, "subscale": "collected" }, { "value": 0, "factor": "craving", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "abstinence_confidence", "points": 0, "present": true, "subscale": "protective" }, { "value": 0, "factor": "days_self_help", "points": 0, "present": true, "subscale": "protective" }, { "value": 0, "factor": "days_risky", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "religion_support", "points": 0, "present": true, "subscale": "protective" }, { "value": 0, "factor": "days_structured", "points": 0, "present": true, "subscale": "protective" }, { "value": false, "factor": "adequate_income", "points": 0, "present": false, "subscale": "protective" }, { "value": 0, "factor": "family_arguments", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "days_supportive", "points": 0, "present": true, "subscale": "protective" }, { "value": 0, "factor": "recovery_satisfaction", "points": 0, "present": true, "subscale": "collected" } ], "use": 0, "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.", "citation": { "authors": "Cacciola JS, Alterman AI, DePhilippis D, et al.", "doi": "10.1016/j.jsat.2012.07.013", "id": "cacciola-2013", "pmid": "22898042", "source": "J Subst Abuse Treat. 2013;44(5):492-499", "title": "Development and initial evaluation of the Brief Addiction Monitor (BAM)" }, "formula": "bam", "formula_expression": "Use = days_alcohol + days_heavy_alcohol + days_drug (Cacciola 2013 Table 1 items 4+5+6; each 0-30; max 90); Risk = physical_health + days_sleep + days_psychological + craving + days_risky + family_arguments (items 1+2+3+8+11+15; Table 1 Likert 0-4 kept on Table 1's own scale, day-counts 0-30; max 102); Protective = abstinence_confidence + days_self_help + religion_support + days_structured + adequate_income + days_supportive (items 9+10+12+13+14+16; Table 1 Likert 0-4, day-counts 0-30, income No=0 Yes=30; max 98); items 7a-g and 17 collected and not summed. No single total BAM score. magent does not interview the patient. Not a diagnosis or level-of-care order.", "risk": 0, "protective": 0, "protective_max": 98, "risk_max": 102, "use_max": 90 } ] } ``` ## Response fields - `formula` (string): bam - `formula_expression` (string): Exact expression used - `use` (integer): Cacciola 2013 / VA Use subscale (items 4+5+6), range 0-90 - `use_max` (integer): Always 90 - `risk` (integer): Cacciola 2013 / VA Risk subscale (items 1+2+3+8+11+15). Table 1 Likert 0-4 plus day-counts 0-30; range 0-102. Not the VA BAM-R 0-180 recode. - `risk_max` (integer): Always 102 - `protective` (integer): Cacciola 2013 / VA Protective subscale (items 9+10+12+13+14+16). Table 1 Likert 0-4, day-counts 0-30, income 0/30; range 0-98. Not the VA BAM-R 0-180 recode. - `protective_max` (integer): Always 98 - `components` (array): Per-item caller-assigned points; 7a-g and item 17 contribute 0 - `citation` (object): Cacciola et al. J Subst Abuse Treat 2013 citation - `disclaimer` (string): Not-a-device notice ## Example JSON Frozen fixture. Not a live lookup. ```json { "components": [ { "value": 0, "factor": "physical_health", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "days_sleep", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "days_psychological", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "days_alcohol", "points": 0, "present": true, "subscale": "use" }, { "value": 0, "factor": "days_heavy_alcohol", "points": 0, "present": true, "subscale": "use" }, { "value": 0, "factor": "days_drug", "points": 0, "present": true, "subscale": "use" }, { "value": false, "factor": "drug_marijuana", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_sedatives", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_cocaine", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_stimulants", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_opiates", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_inhalants", "points": 0, "present": false, "subscale": "collected" }, { "value": false, "factor": "drug_other", "points": 0, "present": false, "subscale": "collected" }, { "value": 0, "factor": "craving", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "abstinence_confidence", "points": 0, "present": true, "subscale": "protective" }, { "value": 0, "factor": "days_self_help", "points": 0, "present": true, "subscale": "protective" }, { "value": 0, "factor": "days_risky", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "religion_support", "points": 0, "present": true, "subscale": "protective" }, { "value": 0, "factor": "days_structured", "points": 0, "present": true, "subscale": "protective" }, { "value": false, "factor": "adequate_income", "points": 0, "present": false, "subscale": "protective" }, { "value": 0, "factor": "family_arguments", "points": 0, "present": true, "subscale": "risk" }, { "value": 0, "factor": "days_supportive", "points": 0, "present": true, "subscale": "protective" }, { "value": 0, "factor": "recovery_satisfaction", "points": 0, "present": true, "subscale": "collected" } ], "use": 0, "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.", "citation": { "authors": "Cacciola JS, Alterman AI, DePhilippis D, et al.", "doi": "10.1016/j.jsat.2012.07.013", "id": "cacciola-2013", "pmid": "22898042", "source": "J Subst Abuse Treat. 2013;44(5):492-499", "title": "Development and initial evaluation of the Brief Addiction Monitor (BAM)" }, "formula": "bam", "formula_expression": "Use = days_alcohol + days_heavy_alcohol + days_drug (Cacciola 2013 Table 1 items 4+5+6; each 0-30; max 90); Risk = physical_health + days_sleep + days_psychological + craving + days_risky + family_arguments (items 1+2+3+8+11+15; Table 1 Likert 0-4 kept on Table 1's own scale, day-counts 0-30; max 102); Protective = abstinence_confidence + days_self_help + religion_support + days_structured + adequate_income + days_supportive (items 9+10+12+13+14+16; Table 1 Likert 0-4, day-counts 0-30, income No=0 Yes=30; max 98); items 7a-g and 17 collected and not summed. No single total BAM score. magent does not interview the patient. Not a diagnosis or level-of-care order.", "risk": 0, "protective": 0, "protective_max": 98, "risk_max": 102, "use_max": 90 } ``` ## Errors - HTTP 400 `invalid_bam`: BAM inputs must match Cacciola 2013 Brief Addiction Monitor item ranges from that paper. Returned before settlement; you are not charged. - HTTP 400 `invalid_items`: POST body must be a JSON object with only an items array Returned before settlement; you are not charged. - HTTP 400 `invalid_item_count`: items must be an array of 1 to 25 objects Returned before settlement; you are not charged. - HTTP 400 `invalid_item`: each items entry must be a JSON object Returned before settlement; you are not charged. Shared HTTP 402 and 503: https://magentlab.com/docs/payments ## Related tools - [CAGE](https://magentlab.com/docs/cage) — Sum the four Ewing 1984 CAGE items and return whether two or more answers are affirmative. - [AUDIT-C](https://magentlab.com/docs/audit-c) — Sum three caller-assigned Bush 1998 AUDIT-C integers (0-4) and return this paper's ≥3 and ≥4 screens. - [CIWA-Ar](https://magentlab.com/docs/ciwa-ar) — Sum the ten Sullivan 1989 CIWA-Ar items (nine caller-assigned 0-7 plus orientation 0-4) and return the published total (max 67). ## Payment Unpaid requests return HTTP 402 even if query parameters or POST items are missing or invalid, so CDP and agents can index the path. After a PAYMENT-SIGNATURE, invalid params return HTTP 400 JSON before settlement. magent does not charge. Fix the params, then request a new 402 quote for that complete URL. Catalog misses (empty matches, found=false) are valid paid 200s. - GET the tool with Accept: application/json (do not send Accept: text/html unless you want the human paywall). - HTTP 402 means you have not paid. Decode the base64 PAYMENT-REQUIRED header. HTTP 503 is not a new quote. - Sign accepts[0] (exact, EIP-3009) with validBefore = now + maxTimeoutSeconds (600 seconds), or accepts[1] (batch-settlement deposit/voucher) on product GET. Ping and POST {items} stay exact. Magent retries transient facilitator 429/5xx before answering. - Retry the same URL with PAYMENT-SIGNATURE (base64 JSON of accepted and payload). Magent attaches canonical extensions.bazaar on CDP verify/settle; echoing 402 bazaar is optional. - Success is HTTP 200 JSON plus PAYMENT-RESPONSE. exact settles before the tool. batch-settlement verifies (and deposit-settles) before the tool and commits the charge after HTTP 2xx. HTTP 503: retry the same PAYMENT-SIGNATURE. Mint a new exact nonce only after a new HTTP 402. - offered `exact` on eip155:8453: Fixed-price USDC on Base. The buyer authorizes the advertised amount (EIP-3009). magent settles before the tool runs (paymentFlow upfront). extra.assetTransferMethod=eip3009 extra.paymentFlow=upfront. - offered `batch-settlement` on eip155:8453: Payment-channel vouchers claimed later in batches. Exact stays accepts[0]. Same-path POST {items} is still exact. extra.assetTransferMethod=eip3009 extra.paymentFlow=authorization. - not offered `upto`: Not offered. Usage-based: buyer authorizes a ceiling, seller settles the actual amount after work. Reserved for a future metered tool. Not for current calculators or code search. Same-path POST {items} is still scheme exact: one EIP-3009 authorization for GET unit plus $0.002 per extra item. That is not x402 batch-settlement (payment channels / vouchers). Shared HTTP 402 and 503 table: https://magentlab.com/docs/payments Stdio MCP (one process per host): https://magentlab.com/docs/mcp ## Guarantees - HTTP 402 is unpaid, including a missing query. After PAYMENT-SIGNATURE, invalid parameters return HTTP 400 before settlement. You are not charged. HTTP 402 never includes the tool JSON. - exact: settlement finishes before the tool (paymentFlow upfront). batch-settlement: verify/deposit before the tool; chargedCumulativeAmount commits after HTTP 2xx. Uncertain or failed settlement fails closed (HTTP 503). Retry the same PAYMENT-SIGNATURE. - HTTP 402 is unpaid only. Do not sign a second authorization because of a 503. - Execution is timeout-bounded and concurrency-capped. - Calculator inputs are stored encrypted for allowlisted operators (Magent Console). They are not in public logs, SSH lookups, catalog, or rollups. Request logs store path without query.