{"uid":"cap_26uXaNjjOIPzEtPJ9___i","slug":"mindpulse-addiction-harm-reduction-guidance-e4f27d47","name":"MindPulse Addiction & Harm Reduction Guidance","description":"Addiction support and harm-reduction guidance for mental-health and wellness agents. Honest, stage-matched guidance on alcohol, opioids, stimulants, gambling, and gaming — including MAT/MOUD treatment landscape and country-specific helplines.","url":"https://mindpulse-lilac.vercel.app/api/mind/addiction","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"},"queryParams":{"type":"object","properties":{"lang":{"type":"string","description":"en | es | fr | de | zh | ja | ko | pt | ar | hi"},"stage":{"type":"string","description":"curious | cutting-back | quitting | relapse | supporting-someone"},"country":{"type":"string","description":"US | UK | AU | CA | DE | any ISO country name"},"substance-or-behavior":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"stage_assessed":"quitting","country_helplines":{"country":"United States","helplines":[{"name":"SAMHSA National Helpline","how_to_reach":"Call 1-800-662-4357"}]},"overdose_prevention":{"guidance":"Carry naloxone (Narcan) — free at many pharmacies.","relevant":true},"treatment_landscape":{"mat_moud_note":"Methadone and buprenorphine are the gold-standard, evidence-based treatment for opioid use disorder."},"substance_or_behavior_assessed":"opioids"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iRbdVh1fnfRWayJJfK4Oa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns evidence-based addiction support including stage assessment, overdose prevention, treatment landscape, harm-reduction strategies, and country-specific helplines for substances or behavioral addictions","exampleAgentPrompt":"I'm currently trying to quit opioids and I'm based in the United States — can you give me evidence-based guidance on treatment options like methadone or buprenorphine, overdose prevention, and where I can call for help?","exampleUseCases":[{"title":"Recovery stage assessment with local helplines","prompt":"I've been using alcohol heavily for years and I think I'm ready to quit, but I'm not sure what stage I'm at or what to do first. Can you assess where I am in recovery and find me some helplines and treatment options in Australia?"},{"title":"Harm reduction for stimulant use disorder","prompt":"A friend of mine is struggling with cocaine and isn't ready to quit yet. Can you give me practical harm reduction strategies to help keep them safe, and explain what evidence-based treatments exist if they do decide to seek help?"},{"title":"Behavioral addiction support and resources","prompt":"I think I have a gambling addiction and it's affecting my finances and relationships. What does the treatment landscape look like for gambling disorder, and can you find me some counselors or support groups I can call in Canada?"}],"resultDescription":"A JSON object containing: the assessed stage of recovery (e.g. 'quitting'), the substance or behavior evaluated, overdose prevention guidance with relevance flag, treatment landscape notes (e.g. MAT/MOUD recommendations), and a list of country-specific helplines with names and contact details.","failureModes":["Unsupported substance or behavior type returns generic or empty guidance","Country not recognized returns no helpline data","Missing required parameters (substance/behavior) may yield incomplete stage assessment","API returns HTTP 402 if x402 micropayment is not completed prior to call","Rate limiting or Vercel cold-start may cause latency spikes"],"whenToPreferThis":"Use this endpoint when a user or agent needs structured, clinically grounded addiction support information — including country-specific helplines, overdose prevention, and treatment landscape — for a specific substance or behavioral addiction. Prefer over a general mental health endpoint when the query is specifically about addiction, substance use disorder, or harm reduction. For acute crisis situations, prefer the free /api/mind/crisis endpoint instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:33:05.598Z","isFirstParty":false}