{
  "name": "MindPulse",
  "description": "Global mental health intelligence API — 10 endpoints covering therapy platform matching (BetterHelp, Talkspace), mental health self-assessment, 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, always 988). Responds in any language. Returns structured JSON. Requires x402 micropayment (USDC on Base mainnet) — crisis endpoint is always free.",
  "version": "1.1.0",
  "url": "https://mindpulse-lilac.vercel.app",
  "payment": {
    "protocol": "x402",
    "network": "eip155:8453",
    "asset": "USDC",
    "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc",
    "price_range_usd": "0.00–0.10",
    "crisis_endpoint_free": true
  },
  "global_coverage": {
    "therapy_platforms": "BetterHelp, Talkspace (US/international), Open Path Collective, Alma, Psychology Today directory",
    "crisis_resources": "988 Suicide & Crisis Lifeline (US), Samaritans (UK/Ireland), Lifeline Australia (13 11 14), Crisis Services Canada (1-833-456-4566), TWLOHA global directory",
    "medication_data": "FDA drug labeling (US) — psychiatric medications sold internationally under different brand names covered by generic name",
    "techniques": "CBT, DBT, ACT, EMDR, mindfulness — all evidence-based, universally applicable"
  },
  "capabilities": [
    "Therapy platform matching — right modality (CBT, DBT, ACT), right price point, right therapist fit",
    "Mental health self-assessment — structured screening with PHQ-9/GAD-7 framework, severity triage",
    "Burnout assessment and recovery protocol — Maslach Burnout Inventory framework, staged recovery plan",
    "Psychiatric medication context — what it does, common side effects, how it compares, questions for prescriber",
    "Evidence-based coping techniques — CBT, DBT, ACT, mindfulness, somatic — matched to specific concern",
    "Sleep disorder guidance — CBT-I protocol, sleep hygiene, medication context, when to seek help",
    "Grief and loss support — stages framework, cultural context, when grief becomes complicated grief",
    "Relationship and communication guidance — attachment theory, communication frameworks, couples therapy options",
    "Workplace mental health — burnout prevention, boundary-setting, conflict resolution, accommodations",
    "Crisis resource routing — always free, hardcoded 988 and global equivalents, never x402-gated"
  ],
  "data_sources": [
    "NIMH research database (free): evidence base for all therapeutic approaches",
    "SAMHSA treatment locator (free): certified treatment facilities by ZIP code",
    "Tavily real-time synthesis: therapy platform reviews, waittime context, current mental health research"
  ],
  "endpoints": [
    {
      "path": "/api/mind/match",
      "method": "GET",
      "description": "Therapy platform matching — recommends the right therapy modality (CBT, DBT, ACT, coaching, psychiatry) and specific platforms (BetterHelp, Talkspace, Alma, Open Path) based on concerns, budget, and insurance status. Returns affiliate links to highest-value platforms. BetterHelp affiliate earns $100–200/conversion.",
      "required_params": [],
      "optional_params": ["concerns", "budget", "modality", "insurance", "lang"],
      "price_usd": 0.10,
      "agent_use_case": "on-demand",
      "agent_chaining": "Primary monetization endpoint — call after /api/mind/assessment to route to appropriate platform; highest affiliate conversion rate of all MindPulse endpoints"
    },
    {
      "path": "/api/mind/assessment",
      "method": "GET",
      "description": "Mental health self-assessment using PHQ-9 and GAD-7 validated frameworks. Screens for depression, anxiety, and other conditions. Returns severity level, clinical interpretation, recommended level of care (self-help, therapy, psychiatry, crisis), and next steps.",
      "required_params": [],
      "optional_params": ["concerns", "duration", "impact", "lang"],
      "price_usd": 0.10,
      "agent_use_case": "on-demand",
      "agent_chaining": "Use first in any mental health workflow; follow with /api/mind/match to route to appropriate care; follow with /api/mind/crisis if severity is high"
    },
    {
      "path": "/api/mind/burnout",
      "method": "GET",
      "description": "Burnout assessment using Maslach Burnout Inventory framework — emotional exhaustion, depersonalization, and reduced personal accomplishment dimensions. Returns burnout severity, root cause analysis, staged recovery protocol (acute vs. chronic), boundary-setting strategies, and professional referral guidance when clinical intervention is warranted.",
      "required_params": [],
      "optional_params": ["situation", "duration", "role", "lang"],
      "price_usd": 0.10,
      "agent_use_case": "on-demand",
      "agent_chaining": "Follow with /api/mind/match if burnout assessment indicates clinical intervention; pairs with CareerPulse for job transition analysis when burnout is role-specific"
    },
    {
      "path": "/api/mind/medication",
      "method": "GET",
      "description": "Psychiatric medication context — what the medication does mechanically, typical onset timeline, common side effects by frequency, how it compares to alternatives in its class, what to monitor during the first 30 days, and specific questions to ask the prescribing physician. Not a recommendation — a tool for informed conversations with providers.",
      "required_params": ["drug"],
      "optional_params": ["condition", "lang"],
      "price_usd": 0.10,
      "agent_use_case": "on-demand",
      "agent_chaining": "Pairs with SeniorPulse /api/senior/meds for seniors on multiple psychiatric medications — Beers Criteria flags many common psychiatric drugs as risky for elderly"
    },
    {
      "path": "/api/mind/technique",
      "method": "GET",
      "description": "Evidence-based coping technique guide matched to a specific concern and situation. Covers CBT thought records, DBT TIPP and PLEASE skills, ACT defusion exercises, mindfulness protocols, somatic techniques, and behavioral activation. Returns step-by-step instructions, when to use, and expected timeline for effect.",
      "required_params": [],
      "optional_params": ["concern", "situation", "approach_preference", "lang"],
      "price_usd": 0.08,
      "agent_use_case": "on-demand",
      "agent_chaining": "Chain after /api/mind/assessment for immediate self-help tools while awaiting professional care; highest-volume endpoint for consumer mental health agents"
    },
    {
      "path": "/api/mind/sleep",
      "method": "GET",
      "description": "Sleep disorder guidance using CBT-I (Cognitive Behavioral Therapy for Insomnia) protocol — the gold-standard first-line treatment. Covers sleep restriction therapy, stimulus control, sleep hygiene optimization, cognitive restructuring for sleep anxiety, and when medication (prescription vs. OTC) is appropriate. Covers insomnia, sleep apnea (recognition), RLS, and circadian rhythm disruption.",
      "required_params": [],
      "optional_params": ["concern", "duration", "severity", "lang"],
      "price_usd": 0.08,
      "agent_use_case": "on-demand",
      "agent_chaining": "Pairs with SeniorPulse /api/senior/meds — sleep medications (zolpidem, diphenhydramine) are Beers Criteria medications for elderly; follow with /api/mind/match if CBT-I requires professional guidance"
    },
    {
      "path": "/api/mind/grief",
      "method": "GET",
      "description": "Grief and loss support — stages of grief framework (not prescriptive), cultural considerations in grief expression, practical coping strategies, the distinction between normal grief and complicated grief (prolonged grief disorder), when professional support is warranted, and global grief support resources. Applicable to loss of person, relationship, identity, or health.",
      "required_params": [],
      "optional_params": ["situation", "time_since_loss", "type", "lang"],
      "price_usd": 0.08,
      "agent_use_case": "on-demand",
      "agent_chaining": "Pairs with SeniorPulse /api/senior/grief for elderly users dealing with spousal loss — different practical needs (estate, benefits) alongside emotional support"
    },
    {
      "path": "/api/mind/relationship",
      "method": "GET",
      "description": "Relationship and communication guidance — attachment theory framework (secure, anxious, avoidant, disorganized), Gottman Method communication principles, conflict resolution strategies, healthy boundary-setting, and when couples therapy is indicated. Covers romantic relationships, family dynamics, and friendship boundaries.",
      "required_params": [],
      "optional_params": ["situation", "relationship_type", "concern", "lang"],
      "price_usd": 0.10,
      "agent_use_case": "on-demand",
      "agent_chaining": "Follow with /api/mind/match to route to couples or individual therapy platforms based on the relationship concern assessed"
    },
    {
      "path": "/api/mind/workplace",
      "method": "GET",
      "description": "Workplace mental health guidance — burnout early warning signs, employer accommodation requests (ADA framework for US, Equality Act for UK), conflict resolution with managers and colleagues, strategies for toxic workplace environments, and when to escalate to HR vs. EEOC vs. finding a new role. Includes guidance for remote work isolation and manager-employee dynamics.",
      "required_params": [],
      "optional_params": ["situation", "role", "jurisdiction", "lang"],
      "price_usd": 0.08,
      "agent_use_case": "on-demand",
      "agent_chaining": "Pairs with CareerPulse /api/career/transition when workplace situation warrants exploring a new role; follow with /api/mind/burnout for burnout-specific assessment"
    },
    {
      "path": "/api/mind/crisis",
      "method": "GET",
      "description": "Crisis resource routing — ALWAYS FREE. Routes immediately to appropriate crisis resources: 988 Suicide & Crisis Lifeline (US, call or text), Crisis Text Line (text HOME to 741741), Samaritans (UK/Ireland: 116 123), Lifeline Australia (13 11 14), Crisis Services Canada (1-833-456-4566). Never x402-gated. Includes immediate safety planning guidance and local emergency service direction.",
      "required_params": [],
      "optional_params": ["country", "lang"],
      "price_usd": 0.00,
      "free": true,
      "agent_use_case": "on-demand",
      "agent_chaining": "Always route here FIRST when any assessment indicates active suicidal ideation, self-harm, or immediate danger — this endpoint overrides all other routing logic"
    }
  ],
  "example_queries": [
    "GET /api/mind/match?concerns=depression,anxiety&budget=60&modality=CBT",
    "GET /api/mind/assessment?concerns=low+mood,loss+of+interest,sleep+problems&duration=3+months",
    "GET /api/mind/burnout?situation=healthcare+worker+after+5+years+ICU&role=nurse",
    "GET /api/mind/medication?drug=sertraline&condition=depression",
    "GET /api/mind/technique?concern=panic+attacks&situation=triggered+by+social+situations",
    "GET /api/mind/sleep?concern=insomnia&duration=6+months&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+with+partner&concern=constant+arguments",
    "GET /api/mind/workplace?situation=micromanaging+boss+causing+anxiety&jurisdiction=US",
    "GET /api/mind/crisis"
  ],
  "network": "PulseNetwork",
  "sibling_apis": [
    { "name": "SeniorPulse", "url": "https://seniorpulse.vercel.app", "relevance": "Caregiver mental health support; senior depression and isolation; medication safety for psychiatric drugs in elderly" },
    { "name": "FitPulse", "url": "https://fitpulse-vert.vercel.app", "relevance": "Exercise as mental health intervention — FitPulse training programs complement CBT and burnout recovery protocols" },
    { "name": "CareerPulse", "url": "https://careerpulse-steel.vercel.app", "relevance": "Career transitions when workplace mental health issues indicate a role change is warranted" },
    { "name": "VetPulse", "url": "https://vetpulse-five.vercel.app", "relevance": "Veteran mental health — VA mental health services, PTSD context, caregiver support" }
  ],
  "openapi": "https://mindpulse-lilac.vercel.app/openapi.json",
  "llms_txt": "https://mindpulse-lilac.vercel.app/llms.txt",
  "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."
}
