# MindPulse

> Global mental health intelligence API — therapy platform matching, burnout recovery, psychiatric medication context, evidence-based coping techniques, sleep disorder guidance, grief support, relationship counseling, workplace mental health, and crisis resource routing (always free). All endpoints require x402 micropayment (USDC on Base mainnet) except /api/mind/crisis which is always free.

## What This Is

MindPulse is a pay-per-query API that synthesizes current mental health research, therapy platform data, and evidence-based clinical frameworks into structured, actionable guidance. Every response is generated by Claude using NIMH research databases, SAMHSA treatment locator data, and Tavily real-time synthesis.

Crisis resources are always free. The API responds in any language via ?lang= parameter.

## Who This Is For

- **AI agents** orchestrating mental health triage and care routing workflows
- **Healthcare apps** needing structured mental health content with affiliate monetization
- **Employee wellness platforms** building burnout and workplace mental health features
- **Consumer apps** providing therapy matching and self-help content

## Payment

All endpoints (except /api/mind/crisis) require x402 micropayment via USDC on Base mainnet (eip155:8453). Price range: $0.00–$0.10 per query.

Payment flow: `GET /endpoint` → `402 Payment Required` → sign USDC payment → retry with `PAYMENT-SIGNATURE` header → `200 OK`.

## Endpoints

| Endpoint | Price | Description |
|----------|-------|-------------|
| `GET /api/mind/match` | $0.10 | Therapy platform matching — BetterHelp, Talkspace, Alma, Open Path |
| `GET /api/mind/assessment` | $0.10 | Mental health self-assessment (PHQ-9/GAD-7 framework) |
| `GET /api/mind/burnout` | $0.10 | Burnout assessment (Maslach framework) + recovery protocol |
| `GET /api/mind/medication` | $0.10 | Psychiatric medication context — mechanism, side effects, prescriber questions |
| `GET /api/mind/technique` | $0.08 | Evidence-based coping technique (CBT, DBT, ACT, mindfulness, somatic) |
| `GET /api/mind/sleep` | $0.08 | Sleep disorder guidance — CBT-I protocol, insomnia, sleep apnea |
| `GET /api/mind/grief` | $0.08 | Grief and loss support — stages, cultural context, complicated grief |
| `GET /api/mind/relationship` | $0.10 | Relationship guidance — attachment theory, Gottman Method, boundaries |
| `GET /api/mind/workplace` | $0.08 | Workplace mental health — ADA accommodations, conflict, toxic environments |
| `GET /api/mind/crisis` | **FREE** | Crisis resources — 988, Samaritans, Lifeline AU, Crisis Services Canada |

## Example Queries

```
GET /api/mind/match?concerns=depression,anxiety&budget=60&modality=CBT
GET /api/mind/assessment?concerns=low+mood,loss+of+interest&duration=3+months
GET /api/mind/burnout?situation=5+years+ICU+nursing&role=nurse
GET /api/mind/medication?drug=sertraline&condition=depression
GET /api/mind/technique?concern=panic+attacks&situation=social+situations
GET /api/mind/sleep?concern=insomnia&severity=unable+to+fall+asleep
GET /api/mind/grief?situation=spouse+died+2+months+ago&type=spousal+loss
GET /api/mind/relationship?situation=communication+breakdown&concern=constant+arguments
GET /api/mind/workplace?situation=micromanaging+boss&jurisdiction=US
GET /api/mind/crisis
```

## Agent Chaining Guide

**Recommended mental health triage flow:**
1. `/api/mind/assessment` → identify severity and type
2. If HIGH severity → `/api/mind/crisis` (immediately, overrides all other routing)
3. If MODERATE → `/api/mind/match` → therapy platform recommendation
4. If MILD → `/api/mind/technique` → self-help coping tools

**Burnout workflow:**
1. `/api/mind/burnout` → assess severity and root cause
2. `/api/mind/match` → route to therapist if clinical intervention needed
3. CareerPulse `/api/career/transition` → if role change is warranted

**Senior mental health:**
- Pair with SeniorPulse `/api/senior/meds` for psychiatric medication safety in elderly (Beers Criteria)
- Pair with SeniorPulse `/api/senior/grief` for spousal loss with estate/benefits dimension

**Veteran mental health:**
- Pair with VetPulse `/api/vet/caregiver` for PTSD caregiver support
- Pair with VetPulse `/api/vet/disability` for service-connected mental health conditions

## Network

MindPulse is part of PulseNetwork — 51+ specialized AI intelligence APIs sharing a common x402 payment layer.

- OpenAPI spec: https://mindpulse-lilac.vercel.app/openapi.json
- Agent discovery: https://mindpulse-lilac.vercel.app/.well-known/agent.json

## Disclaimer

For informational purposes only. Not a substitute for professional mental health care. If you are in crisis, call or text 988 (US) or your local emergency number immediately.