# MindPulse Addiction & Harm Reduction Guidance

> MindPulse Addiction & Harm Reduction Guidance is a paid API for AI agents from mindpulse-lilac.vercel.app, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-13).

Returns evidence-based addiction support including stage assessment, overdose prevention, treatment landscape, harm-reduction strategies, and country-specific helplines for substances or behavioral addictions

## Facts

- Endpoint: GET https://mindpulse-lilac.vercel.app/api/mind/addiction
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mindpulse-addiction-harm-reduction-guidance-e4f27d47
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_26uXaNjjOIPzEtPJ9___i

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 mindpulse-addiction-harm-reduction-guidance-e4f27d47
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## 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"
    },
    "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mindpulse-addiction-harm-reduction-guidance-e4f27d47/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mindpulse-lilac.vercel.app](https://www.zero.xyz/host/mindpulse-lilac.vercel.app/llms.txt)