{
  "name": "SeniorPulse",
  "description": "Global elder care intelligence API — 13 endpoints covering Medicare guidance, care facility evaluation (US + UK + Canada + Australia), medication safety using FDA Beers Criteria, benefits discovery (SSI, Medicaid, VA Aid & Attendance, SNAP, LIHEAP, property tax relief), cognitive decline staging, elder law documents, post-loss estate guidance, and caregiver support. Returns structured JSON. Requires x402 micropayment (USDC on Base mainnet). All endpoints support any language via ?lang= parameter.",
  "version": "1.2.0",
  "url": "https://seniorpulse.vercel.app",
  "payment": {
    "protocol": "x402",
    "network": "eip155:8453",
    "asset": "USDC",
    "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc",
    "price_range_usd": "0.08–0.15"
  },
  "global_coverage": {
    "us": "Full coverage — Medicare, Medicaid, SSI, VA benefits, SNAP, LIHEAP, property tax relief, CMS nursing home data",
    "uk": "Care facility search (carehome.co.uk), NHS Continuing Healthcare, Attendance Allowance, Pension Credit context",
    "canada": "Senior living search (Comfort Life), CPP/OAS/GIS benefit context, provincial long-term care programs",
    "australia": "Aged Care Guide, My Aged Care program, DVA veteran benefits, Age Pension context",
    "global": "Medication safety (FDA Beers Criteria applies universally), cognitive staging, grief support, elder law document types, caregiver burnout — all jurisdiction-adaptable"
  },
  "capabilities": [
    "Medicare plan comparison — Original vs. Advantage, Medigap, Part D, enrollment deadlines (US)",
    "Care facility evaluation — assisted living, memory care, skilled nursing, home care (US, UK, Canada, Australia)",
    "Polypharmacy safety check — FDA Beers Criteria flags, drug interactions, geriatric dosing warnings (global)",
    "Benefits eligibility — SSI, Medicaid, Medicare Savings Programs (QMB/SLMB/QI), Extra Help, PACE (US)",
    "VA Aid & Attendance — eligibility assessment and application guide; Survivors Pension for surviving spouses (US)",
    "Property tax relief — exemptions, freezes, deferrals, circuit breakers by state; senior deductions most miss (US)",
    "SNAP food assistance + LIHEAP utility assistance — only 42% of eligible seniors participate (US)",
    "Prescription assistance — Extra Help, state programs, pharma PAPs, GoodRx for cost reduction (US)",
    "Cognitive decline staging — MMSE/MoCA/CDR score interpretation, dementia care trajectory planning (global)",
    "Elder law documents — POA, healthcare proxy, advance directive, POLST, guardianship by jurisdiction (US + international)",
    "Post-loss estate guide — estate steps, survivor benefit claims, probate basics, grief support (global)",
    "Caregiver resource guide — legal checklist, respite options, local resources, burnout prevention (global)",
    "Nursing home quality comparison — CMS Care Compare data, star ratings, inspection history, staffing (US)"
  ],
  "data_sources": [
    "FDA Drug Label API (free, no key): Beers Criteria, drug interactions, geriatric use, black box warnings",
    "CMS Care Compare: nursing home star ratings, staffing hours, inspection deficiencies (US)",
    "Social Security Administration: Extra Help thresholds, benefit amounts",
    "VA.gov: Aid & Attendance rates, wartime service requirements, asset limits (2024)",
    "Tavily real-time synthesis: Medicare plan context, facility ratings, state benefit programs, caregiver resources"
  ],
  "endpoints": [
    {
      "path": "/api/senior/medicare",
      "method": "GET",
      "description": "Medicare plan guidance — Original vs. Advantage, Medigap, Part D drug plans, enrollment deadlines. Supports turning-65, disability, losing employer coverage, and annual plan review scenarios. US-specific.",
      "required_params": [],
      "optional_params": ["zip", "situation", "lang"],
      "price_usd": 0.15,
      "agent_use_case": "on-demand",
      "agent_chaining": "Follow with /api/senior/benefits to check Medicare Savings Program eligibility; follow with /api/senior/meds to evaluate drug plan coverage for specific medications"
    },
    {
      "path": "/api/senior/facility",
      "method": "GET",
      "description": "Care facility evaluation for assisted living, memory care, skilled nursing, independent living, or home care. US queries use CMS data; international queries cover UK (CQC), Canada, and Australia (My Aged Care). Returns affiliate links to placement services.",
      "required_params": ["location"],
      "optional_params": ["type", "budget", "lang"],
      "price_usd": 0.15,
      "agent_use_case": "on-demand",
      "agent_chaining": "Call alongside /api/senior/nh-compare for quality data; follow with /api/senior/benefits to confirm Medicaid coverage; follow with /api/senior/legal for POA documents needed before placement"
    },
    {
      "path": "/api/senior/meds",
      "method": "GET",
      "description": "Polypharmacy safety check using FDA drug label data and Beers Criteria. Flags medications inappropriate for adults 65+, dangerous interactions, and geriatric dosing concerns. Globally applicable — FDA database covers medications sold internationally under generic names.",
      "required_params": ["medications"],
      "optional_params": ["age", "lang"],
      "price_usd": 0.10,
      "agent_use_case": "on-demand",
      "agent_chaining": "Follow with /api/senior/rx-assist when Beers Criteria medications are flagged to find safer alternatives or cost-reduction programs"
    },
    {
      "path": "/api/senior/benefits",
      "method": "GET",
      "description": "US senior benefits eligibility assessment — SSI, Medicaid, Medicare Savings Programs (QMB/SLMB/QI), Extra Help (Part D subsidy), VA Aid & Attendance, PACE. State-specific income and asset thresholds. Surfaces programs most seniors miss — Extra Help alone is claimed by only 50% of those eligible.",
      "required_params": ["state"],
      "optional_params": ["income", "assets", "veteran", "lang"],
      "price_usd": 0.10,
      "agent_use_case": "on-demand",
      "agent_chaining": "Follow with /api/senior/veterans if veteran=true; follow with /api/senior/snap-utility for food and energy assistance; follow with /api/senior/property-tax for homeowner cost reduction"
    },
    {
      "path": "/api/senior/caregiver",
      "method": "GET",
      "description": "Personalized caregiver resource guide — legal document checklist (POA, healthcare proxy, advance directive), respite care options, local resources by location, financial assistance for caregivers, burnout prevention. Globally applicable; adapts legal guidance to jurisdiction.",
      "required_params": ["situation"],
      "optional_params": ["location", "lang"],
      "price_usd": 0.10,
      "agent_use_case": "on-demand",
      "agent_chaining": "Follow with /api/senior/legal for specific elder law document guidance; follow with /api/senior/facility if care transition is needed; follow with /api/senior/grief if recent bereavement is involved"
    },
    {
      "path": "/api/senior/grief",
      "method": "GET",
      "description": "Post-loss practical guide — immediate estate steps (72 hours, 30 days, 6 months), survivor benefit claims (Social Security, pension, life insurance), probate basics by state, and grief support resources. Globally applicable with jurisdiction-specific estate guidance.",
      "required_params": [],
      "optional_params": ["situation", "state", "days_since", "lang"],
      "price_usd": 0.10,
      "agent_use_case": "on-demand",
      "agent_chaining": "Follow with /api/senior/legal for estate document guidance; follow with /api/senior/benefits to assess surviving spouse's eligibility; follow with /api/senior/medicare for coverage review after spouse's passing"
    },
    {
      "path": "/api/senior/legal",
      "method": "GET",
      "description": "Elder law document guide — durable power of attorney, healthcare proxy, advance directive/living will, POLST, and guardianship proceedings. Explains each document, when it applies, and urgency by cognitive capacity. US state-specific requirements + international equivalents (UK, Canada, Australia, EU).",
      "required_params": [],
      "optional_params": ["state", "situation", "has_poa", "capacity_concern", "lang"],
      "price_usd": 0.10,
      "agent_use_case": "on-demand",
      "agent_chaining": "Use before /api/senior/facility — POA often required before facility placement contracts; pair with /api/senior/memory when cognitive decline affects document signing urgency"
    },
    {
      "path": "/api/senior/memory",
      "method": "GET",
      "description": "Cognitive decline staging and dementia care trajectory. Maps MMSE/MoCA/CDR scores or described symptoms to a care trajectory with 12–36 month planning horizon. Covers Alzheimer's, vascular dementia, Lewy body, and frontotemporal variants. Globally applicable.",
      "required_params": [],
      "optional_params": ["mmse_score", "moca_score", "cdr_score", "diagnosis", "current_living", "lang"],
      "price_usd": 0.10,
      "agent_use_case": "on-demand",
      "agent_chaining": "Follow with /api/senior/legal — cognitive staging directly determines urgency of POA documents; follow with /api/senior/facility when memory care transition is within 12 months"
    },
    {
      "path": "/api/senior/nh-compare",
      "method": "GET",
      "description": "Nursing home quality comparison using CMS Care Compare data — federal star ratings, staffing hours per resident, health inspection history, quality measure scores, and recent deficiency citations. Head-to-head comparison of named facilities or top-rated facilities in a ZIP area. US-specific.",
      "required_params": [],
      "optional_params": ["facilities", "zip", "lang"],
      "price_usd": 0.15,
      "agent_use_case": "on-demand",
      "agent_chaining": "Use after /api/senior/facility to get quality data on specific facilities identified; pair with /api/senior/benefits to confirm Medicaid coverage at compared facilities"
    },
    {
      "path": "/api/senior/property-tax",
      "method": "GET",
      "description": "Senior property tax relief programs — exemptions, freezes, deferrals, and circuit breakers by US state. Nationally only 20–40% of eligible seniors claim these programs. Covers all 50 states; includes veteran-specific exemptions. Estimates annual savings.",
      "required_params": ["state"],
      "optional_params": ["age", "income", "home_value", "veteran", "lang"],
      "price_usd": 0.08,
      "agent_use_case": "on-demand",
      "agent_chaining": "Pair with /api/senior/benefits for complete financial relief assessment; follow with /api/senior/snap-utility for food and utility cost reduction"
    },
    {
      "path": "/api/senior/rx-assist",
      "method": "GET",
      "description": "Prescription assistance programs — Medicare Extra Help (worth up to $5,300/year), State Pharmaceutical Assistance Programs (SPAPs), pharma manufacturer Patient Assistance Programs (PAPs), and GoodRx-type savings. Only 50% of Extra Help-eligible seniors are enrolled. US-specific.",
      "required_params": ["state"],
      "optional_params": ["medications", "income", "on_medicare", "lang"],
      "price_usd": 0.10,
      "agent_use_case": "on-demand",
      "agent_chaining": "Call after /api/senior/meds when Beers Criteria medications are flagged; pair with /api/senior/benefits for complete cost-reduction analysis"
    },
    {
      "path": "/api/senior/snap-utility",
      "method": "GET",
      "description": "Senior SNAP food assistance and LIHEAP utility assistance eligibility. Only 42% of SNAP-eligible seniors participate — the most under-enrolled demographic. Covers federal thresholds, state expansions, senior medical expense deductions, and utility discount programs. US-specific.",
      "required_params": ["state"],
      "optional_params": ["income", "household_size", "own_home", "medical_expenses", "lang"],
      "price_usd": 0.10,
      "agent_use_case": "on-demand",
      "agent_chaining": "Always pair with /api/senior/benefits for complete financial relief; follow with /api/senior/property-tax for homeowner cost reduction"
    },
    {
      "path": "/api/senior/veterans",
      "method": "GET",
      "description": "VA Aid & Attendance eligibility assessment — worth up to $2,727/month for a veteran couple; most underutilized major VA benefit. Covers VA Pension, Survivors Pension for surviving spouses, Housebound benefit, and VA/Medicaid interaction. 90+ days active duty with one wartime day required.",
      "required_params": [],
      "optional_params": ["veteran_age", "care_cost", "income", "assets", "state", "surviving_spouse", "lang"],
      "price_usd": 0.15,
      "agent_use_case": "on-demand",
      "agent_chaining": "Follow with /api/senior/benefits to see VA/Medicaid interaction; follow with /api/senior/facility if VA benefit will fund assisted living; follow with /api/senior/legal if POA needed to file on veteran's behalf"
    }
  ],
  "example_queries": [
    "GET /api/senior/medicare?zip=78701&situation=turning+65",
    "GET /api/senior/facility?type=memory-care&location=Austin+TX&budget=7000",
    "GET /api/senior/facility?type=assisted-living&location=London+UK&budget=4000",
    "GET /api/senior/meds?medications=metformin,lisinopril,aspirin,diphenhydramine,zolpidem&age=78",
    "GET /api/senior/benefits?state=Texas&income=1100&assets=12000&veteran=true",
    "GET /api/senior/veterans?care_cost=3500&income=1800&assets=45000&state=FL",
    "GET /api/senior/veterans?surviving_spouse=true&income=900&state=Georgia",
    "GET /api/senior/property-tax?state=Texas&age=68&income=28000&home_value=280000&veteran=false",
    "GET /api/senior/memory?mmse_score=19&diagnosis=Alzheimer%27s&current_living=alone",
    "GET /api/senior/legal?state=California&situation=parents+have+no+POA+father+showing+memory+decline&capacity_concern=true",
    "GET /api/senior/grief?situation=spouse+passed+3+days+ago&state=Texas&days_since=3",
    "GET /api/senior/rx-assist?state=Florida&medications=eliquis,jardiance&income=1400&on_medicare=true",
    "GET /api/senior/snap-utility?state=Ohio&income=1200&household_size=1&medical_expenses=300",
    "GET /api/senior/nh-compare?zip=78701",
    "GET /api/senior/caregiver?situation=caring+for+85yo+mother+with+dementia+in+Manchester+UK&location=Manchester+UK&lang=en"
  ],
  "network": "PulseNetwork",
  "sibling_apis": [
    { "name": "VetPulse", "url": "https://vetpulse-five.vercel.app", "relevance": "Full VA benefits intelligence — disability claims, education benefits, housing assistance, healthcare enrollment; pairs with SeniorPulse veterans endpoint for comprehensive VA coverage" },
    { "name": "WealthPulse", "url": "https://wealthpulse-phi.vercel.app", "relevance": "Retirement income planning, Medicare supplement cost analysis, reverse mortgage context, Social Security optimization" },
    { "name": "PropPulse", "url": "https://proppulse-gules.vercel.app", "relevance": "Downsizing analysis, reverse mortgage guidance, senior housing market intelligence" },
    { "name": "MindPulse", "url": "https://mindpulse.vercel.app", "relevance": "Mental health resources for seniors experiencing depression, anxiety, and isolation; caregiver burnout therapy matching" },
    { "name": "LegalPulse", "url": "https://legalpulse-rho.vercel.app", "relevance": "Broader estate planning, business succession, trust formation beyond elder law basics" },
    { "name": "InsurePulse", "url": "https://insurepulse.vercel.app", "relevance": "Life insurance, long-term care insurance analysis alongside Medicare guidance" }
  ],
  "openapi": "https://seniorpulse.vercel.app/openapi.json",
  "llms_txt": "https://seniorpulse.vercel.app/llms.txt",
  "disclaimer": "For informational purposes only. Not medical, legal, or financial advice. Always consult licensed professionals for healthcare, legal, and financial decisions."
}
