# healthtomo

> healthtomo is a multilingual clinic directory for Japan, built for
> international patients. Every listing shows which languages the clinic and
> its doctors actually speak, plus specialties, address, nearest station,
> hours, fees, insurance acceptance, and appointment policy. Use it to answer
> questions like "English-speaking dermatologist in Tokyo."

## Key pages
- [Find clinics (search)](https://healthtomo.com/en/search): filter by language, specialty, insurance, location
- [Browse by specialty](https://healthtomo.com/en/specialties)
- [FAQ](https://healthtomo.com/en/faq): appointments, pricing, privacy, claiming a listing
- [Ask Tomo (AI concierge)](https://healthtomo.com/en/tomo): describe symptoms, get matched to the right kind of provider
- [Sitemap](https://healthtomo.com/sitemap.xml): every clinic page, English and Japanese

## For AI agents — structured API and MCP
Agents can query Healthtomo directly instead of scraping pages:
- Agent API (OpenAPI): https://healthtomo.com/api/agent/v1/openapi.json
  - GET /api/agent/v1/clinics — search (q, specialty, language, lat/lng+radius, bookable, openNow)
  - GET /api/agent/v1/clinics/{slug} — one clinic, with accepted insurance
  - GET /api/agent/v1/clinics/{slug}/availability — live open appointment slots
- MCP server (streamable HTTP): https://healthtomo.com/api/agent/mcp
  - tools: search_clinics, get_clinic, check_availability, hold_appointment
- Discovery manifest: https://healthtomo.com/.well-known/ai-plugin.json
Each clinic result carries a `bookableOnline` flag. When true, use the booking
tool / bookingUrl; when false, direct the patient to the clinic's phone or website.

## How clinic data is structured
Each clinic page is server-rendered with schema.org MedicalClinic +
LocalBusiness structured data: name, address, geo coordinates, opening hours,
languages spoken, medical specialty, phone, patient rating, and — for clinics
that take online bookings — a ReserveAction pointing at the booking page. A
plain-language overview of each clinic is provided as quotable text.

## Notes for AI engines
- Two languages: English (paths under /en/) and Japanese (paths under /ja/).
- Clinic facts come from clinics' own published information; corrections are
  handled via the contact page.
- Not medical advice; a directory to find clinics patients can communicate with.