{"openapi":"3.1.0","info":{"title":"Silver Ally API","version":"0.1.0","description":"Safe, plain-English help for older Americans and the family members who look after them: Medicare navigation, medication safety, scam protection, benefits and local help.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://silver-ally.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/silver-ally/docs"},"termsOfService":"https://connectorbay.com/silver-ally/terms"},"servers":[{"url":"https://silver-ally.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/silver-ally/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/medicare_costs":{"post":{"operationId":"medicare_costs","summary":"2026 Medicare costs in plain English: Part A hospital deductible and daily copays, Part B premium/deductible,","description":"2026 Medicare costs in plain English: Part A hospital deductible and daily copays, Part B premium/deductible,\n    Part D deductible cap, the $2,100 out-of-pocket drug cap and the base premium used for penalties. Pass the person's\n    2024 modified adjusted gross income (and 'single' or 'joint') to compute their exact Part B premium including any\n    income-related surcharge (IRMAA).","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"modified_agi_2024":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Modified Agi 2024"},"tax_filing":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Tax Filing"}},"title":"medicare_costsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/medicare_enrollment_windows":{"post":{"operationId":"medicare_enrollment_windows","summary":"When to sign up for Medicare and what happens if you miss it. Give the birth date (YYYY-MM-DD) and whether the","description":"When to sign up for Medicare and what happens if you miss it. Give the birth date (YYYY-MM-DD) and whether the\n    person (or spouse) still has health insurance from active employment (and the date it ends, if known). Returns the\n    7-month Initial Enrollment Period, Special Enrollment Periods after leaving a job, the yearly Open Enrollment\n    (Oct 15–Dec 7), the Medicare Advantage switch window, the General Enrollment Period, and the Medigap guarantee window.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"birth_date":{"title":"Birth Date","type":"string"},"has_employer_coverage":{"default":false,"title":"Has Employer Coverage","type":"boolean"},"employer_coverage_end":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Employer Coverage End"}},"required":["birth_date"],"title":"medicare_enrollment_windowsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/medicare_penalty_estimate":{"post":{"operationId":"medicare_penalty_estimate","summary":"Estimate the lifetime late-enrollment penalty for Medicare Part B (10% per full year late) or Part D (1% of the","description":"Estimate the lifetime late-enrollment penalty for Medicare Part B (10% per full year late) or Part D (1% of the\n    national base premium per month without creditable drug coverage), in 2026 dollars, and how to get it waived.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"part":{"title":"Part","type":"string"},"months_without_coverage":{"title":"Months Without Coverage","type":"integer"}},"required":["part","months_without_coverage"],"title":"medicare_penalty_estimateArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/find_doctor":{"post":{"operationId":"find_doctor","summary":"Find doctors and other clinicians near a ZIP code who are enrolled in Medicare, from CMS Care Compare. Specialty","description":"Find doctors and other clinicians near a ZIP code who are enrolled in Medicare, from CMS Care Compare. Specialty\n    can be plain English ('heart doctor', 'eye doctor', 'primary care', 'geriatrician', 'physical therapy', 'memory').\n    Results show whether the clinician accepts Medicare assignment (no extra 'excess charges') and offers telehealth.\n    Optionally search by last name to check a specific doctor.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zip_code":{"title":"Zip Code","type":"string"},"specialty":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Specialty"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Last Name"},"telehealth_only":{"default":false,"title":"Telehealth Only","type":"boolean"},"limit":{"default":8,"title":"Limit","type":"integer"}},"required":["zip_code"],"title":"find_doctorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/compare_nursing_homes":{"post":{"operationId":"compare_nursing_homes","summary":"Compare Medicare-certified nursing homes (skilled nursing / rehab facilities) near a ZIP code using CMS 5-star","description":"Compare Medicare-certified nursing homes (skilled nursing / rehab facilities) near a ZIP code using CMS 5-star\n    ratings: overall, health inspections, staffing, quality measures; nurse hours per resident, staff turnover, fines,\n    the abuse icon and Special Focus status. Sorted nearest first. Use for 'rehab after the hospital' or long-term care.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zip_code":{"title":"Zip Code","type":"string"},"radius_miles":{"default":15,"title":"Radius Miles","type":"number"},"limit":{"default":8,"title":"Limit","type":"integer"},"min_overall_stars":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Min Overall Stars"}},"required":["zip_code"],"title":"compare_nursing_homesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/compare_hospitals":{"post":{"operationId":"compare_hospitals","summary":"Hospitals near a ZIP code with CMS overall star ratings (1–5), whether they have an emergency room, ownership,","description":"Hospitals near a ZIP code with CMS overall star ratings (1–5), whether they have an emergency room, ownership,\n    and how many mortality/safety/readmission measures are worse than the national rate.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zip_code":{"title":"Zip Code","type":"string"},"limit":{"default":8,"title":"Limit","type":"integer"},"emergency_only":{"default":false,"title":"Emergency Only","type":"boolean"}},"required":["zip_code"],"title":"compare_hospitalsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/compare_home_health":{"post":{"operationId":"compare_home_health","summary":"Medicare-certified home health agencies serving a ZIP code area, with the CMS quality-of-patient-care star rating,","description":"Medicare-certified home health agencies serving a ZIP code area, with the CMS quality-of-patient-care star rating,\n    services offered (nursing, physical/occupational/speech therapy, aides, social work), how often patients improved\n    at walking and managing medicines, and rehospitalization compared with the national rate.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zip_code":{"title":"Zip Code","type":"string"},"limit":{"default":8,"title":"Limit","type":"integer"}},"required":["zip_code"],"title":"compare_home_healthArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/drug_lookup":{"post":{"operationId":"drug_lookup","summary":"Plain-English information about one medicine (brand or generic name): what it is for, boxed warning, key","description":"Plain-English information about one medicine (brand or generic name): what it is for, boxed warning, key\n    warnings, interactions and common side effects from its FDA label, plus any 'Beers Criteria' cautions specific\n    to adults 65 and older.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"medication":{"title":"Medication","type":"string"}},"required":["medication"],"title":"drug_lookupArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/medication_review":{"post":{"operationId":"medication_review","summary":"Screen a full medication list (brand or generic names, doses optional, include over-the-counter and supplements)","description":"Screen a full medication list (brand or generic names, doses optional, include over-the-counter and supplements)\n    for an older adult: duplicate ingredients, two drugs of the same class, AGS Beers Criteria 'avoid' or 'caution'\n    medicines for adults 65+, well-known dangerous combinations (blood thinners + NSAIDs, opioids + sedatives, high\n    potassium, serotonin syndrome, etc.), anticholinergic and sedative burden, and acetaminophen totals. Returns a\n    priority level and questions to bring to the pharmacist. Not a substitute for a pharmacist review.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"medications":{"items":{"type":"string"},"title":"Medications","type":"array"},"age":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Age"},"include_label_cross_reference":{"default":true,"title":"Include Label Cross Reference","type":"boolean"}},"required":["medications"],"title":"medication_reviewArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/drug_recalls":{"post":{"operationId":"drug_recalls","summary":"Recent FDA drug recalls. Give a medicine name to check it (matches product descriptions and generic/brand","description":"Recent FDA drug recalls. Give a medicine name to check it (matches product descriptions and generic/brand\n    names); leave blank for the most serious (Class I) recalls of the period. Shows lots, reason and seriousness.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"medication":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Medication"},"months":{"default":12,"title":"Months","type":"integer"},"limit":{"default":10,"title":"Limit","type":"integer"}},"title":"drug_recallsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/refill_planner":{"post":{"operationId":"refill_planner","summary":"Work out when a prescription runs out and when to reorder: give the number of pills dispensed, doses per day","description":"Work out when a prescription runs out and when to reorder: give the number of pills dispensed, doses per day\n    (0.5 for every other day), the last fill date (YYYY-MM-DD, default today) and refills left. Returns run-out date,\n    days left, a reminder date and money-saving tips (90-day supply, med sync, mail order).","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"medication":{"title":"Medication","type":"string"},"quantity":{"title":"Quantity","type":"integer"},"doses_per_day":{"title":"Doses Per Day","type":"number"},"last_fill_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Last Fill Date"},"refills_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Refills Remaining"},"reminder_days_before":{"default":7,"title":"Reminder Days Before","type":"integer"}},"required":["medication","quantity","doses_per_day"],"title":"refill_plannerArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/scam_check":{"post":{"operationId":"scam_check","summary":"Analyze a suspicious phone call, voicemail, text, email, letter or visit for the warning signs of elder fraud","description":"Analyze a suspicious phone call, voicemail, text, email, letter or visit for the warning signs of elder fraud\n    (gift-card or wire demands, urgency, threats, secrecy, government or bank impersonation, 'free' Medicare items,\n    grandchild emergencies, tech support, prizes, romance, fake tolls/deliveries). Returns a risk level, the specific\n    red flags found, what to do right now, the real number to call instead, and where to report. Channel: call, text,\n    email, letter, in_person.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"what_they_said":{"title":"What They Said","type":"string"},"channel":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Channel"},"claimed_to_be_from":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Claimed To Be From"}},"required":["what_they_said"],"title":"scam_checkArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/verify_official_number":{"post":{"operationId":"verify_official_number","summary":"Check whether a phone number is one of the real Medicare, Social Security, IRS, FTC, AARP or other official","description":"Check whether a phone number is one of the real Medicare, Social Security, IRS, FTC, AARP or other official\n    lines — and explain why a matching caller ID still proves nothing. Also lists the numbers you can trust.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"phone_number":{"title":"Phone Number","type":"string"}},"required":["phone_number"],"title":"verify_official_numberArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/scam_report_guide":{"post":{"operationId":"scam_report_guide","summary":"Step-by-step recovery and reporting plan after a scam or attempted scam: what to do in the first hour if money","description":"Step-by-step recovery and reporting plan after a scam or attempted scam: what to do in the first hour if money\n    was sent or a Social Security/Medicare/bank number was shared, then exactly where to report (FTC, DOJ Elder Fraud\n    Hotline, IC3, SMP, SSA OIG, USPIS) and local help in the person's state.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"scam_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Scam Type"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"State"},"money_lost":{"default":false,"title":"Money Lost","type":"boolean"},"information_shared":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Information Shared"}},"title":"scam_report_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/benefits_screener":{"post":{"operationId":"benefits_screener","summary":"Screen an older adult for money-saving programs using 2026 federal limits: Extra Help for drug costs, Medicare","description":"Screen an older adult for money-saving programs using 2026 federal limits: Extra Help for drug costs, Medicare\n    Savings Programs (QMB/SLMB/QI pay the $202.90 Part B premium), SNAP food benefits with senior rules, LIHEAP energy\n    help, SSI, Medicaid, VA Aid & Attendance, property-tax relief. Give gross monthly income for the person (or couple)\n    and, if known, countable savings (not the home or one car). Returns likely/possible/unlikely per program with how to apply.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"age":{"title":"Age","type":"integer"},"state":{"title":"State","type":"string"},"monthly_income":{"title":"Monthly Income","type":"number"},"household_size":{"default":1,"title":"Household Size","type":"integer"},"married":{"default":false,"title":"Married","type":"boolean"},"countable_assets":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Countable Assets"},"on_medicare":{"default":true,"title":"On Medicare","type":"boolean"},"monthly_medical_costs":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Monthly Medical Costs"},"monthly_rent_or_mortgage":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Monthly Rent Or Mortgage"},"veteran":{"default":false,"title":"Veteran","type":"boolean"}},"required":["age","state","monthly_income"],"title":"benefits_screenerArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/social_security_estimate":{"post":{"operationId":"social_security_estimate","summary":"Social Security claiming math: full retirement age from birth date, the permanent reduction or delayed credit for","description":"Social Security claiming math: full retirement age from birth date, the permanent reduction or delayed credit for\n    claiming at a given age (62–70), estimated monthly amount if the FRA benefit is known (from ssa.gov/myaccount),\n    a 62 vs FRA vs 70 comparison with break-even age, the 2026 earnings test if still working, and spousal notes.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"birth_date":{"title":"Birth Date","type":"string"},"claim_age_years":{"title":"Claim Age Years","type":"number"},"monthly_benefit_at_full_retirement_age":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Monthly Benefit At Full Retirement Age"},"still_working_annual_income":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Still Working Annual Income"},"spouse_benefit_at_full_retirement_age":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Spouse Benefit At Full Retirement Age"}},"required":["birth_date","claim_age_years"],"title":"social_security_estimateArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/find_local_help":{"post":{"operationId":"find_local_help","summary":"Local, free help for older adults by ZIP or state: the state's SHIP Medicare counselors (verified phone numbers),","description":"Local, free help for older adults by ZIP or state: the state's SHIP Medicare counselors (verified phone numbers),\n    the state aging agency and how to reach the local Area Agency on Aging, Adult Protective Services, the Long-Term\n    Care Ombudsman, legal aid, meals, utility help, rides, dementia and veteran support. need: medicare_counseling,\n    aging_services, caregiver, abuse_or_neglect, nursing_home_complaint, legal, food, housing_utilities, transport,\n    memory, veterans, mental_health, general.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zip_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Zip Code"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"State"},"need":{"default":"general","title":"Need","type":"string"}},"title":"find_local_helpArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/weather_safety":{"post":{"operationId":"weather_safety","summary":"Active National Weather Service alerts and the next few days' forecast for a ZIP code, translated into what an","description":"Active National Weather Service alerts and the next few days' forecast for a ZIP code, translated into what an\n    older adult should do: heat and cold guidance (including which medicines raise heat risk), air-quality, storm and\n    power-outage preparation, and when to call 911.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zip_code":{"title":"Zip Code","type":"string"}},"required":["zip_code"],"title":"weather_safetyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/home_safety_checklist":{"post":{"operationId":"home_safety_checklist","summary":"Room-by-room fall-prevention checklist for an older adult's home (stairs, bathroom, bedroom, kitchen, living","description":"Room-by-room fall-prevention checklist for an older adult's home (stairs, bathroom, bedroom, kitchen, living\n    areas, outside, personal habits), based on the CDC STEADI checklist, with tailored tips for concerns such as\n    'dizzy when standing', 'fell last month', 'uses a walker', 'memory loss', 'poor vision', 'lives alone', 'gets up at night'.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"area":{"default":"all","title":"Area","type":"string"},"concerns":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Concerns"}},"title":"home_safety_checklistArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/important_numbers":{"post":{"operationId":"important_numbers","summary":"The official phone numbers and websites an older adult (or caregiver) should keep by the phone: Medicare, Social","description":"The official phone numbers and websites an older adult (or caregiver) should keep by the phone: Medicare, Social\n    Security, IRS, fraud hotlines (AARP, DOJ Elder Fraud, FTC, Senior Medicare Patrol), SHIP, Eldercare Locator, Poison\n    Control, 988, Alzheimer's helpline, VA, 211. Optional topic filter: scam, medicare, benefits, health, crisis, veterans.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Topic"}},"title":"important_numbersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}