topdoctors-search

TopDoctors: Appointment options

Read the booking options of a single office: the services it offers, allowed insurances, consultation type, payment type, consultation channels, required patient fields, plus one derived decision. `booking_mode` is one of "online", "external" or "offline". Messages the doctor wants the patient to read live in `office.display_rules.appointment_information`. The legacy office fields `attends_first_visit` and `first_visit_comment` do not constrain online booking and MUST be ignored when deciding wh

TopDoctors: Appointment slots of a day

List every free slot of the requested days for an office, as the scheduling API serves them. This tool exists for the booking client: it paints a whole day at a time and lets the patient page back and forth, so its answer is complete and is never shortened. `free_count` therefore always equals the number of slots listed. A language model MUST NOT call this tool: a whole day of times floods the conversation with data the patient never asked to hear. Use search_appointment_availability instead, wh

TopDoctors: Doctor offices

List every office of a single doctor where the patient can book online, with the address needed to show them apart. Take the `slug` from the doctor card returned by search_doctors or search_doctor_by_name, and send the card `id` as `provider_id` whenever you have it. Every office served carries a `name`: it comes from the doctor profile, and an office the profile does not name is left out of the list instead of arriving nameless — the answer text says how many were left out. Relay the name with

TopDoctors: First days with appointments

Find the first day with a free slot for an office and list that day and the ones after it, exactly as list_appointment_slots serves them. This tool exists for the booking client: it is the first call when the calendar opens, so the patient lands on a week that has something instead of paging through empty ones. Afterwards the client pages with list_appointment_slots. A language model MUST NOT call this tool: whole days of times flood the conversation with data the patient never asked to hear. Us

TopDoctors: Treatments & conditions catalog

PREREQUISITE: Before calling this tool, ALWAYS call 'list_specialties' first to get the exact specialty slug. Never invent 'specialty_slug'. This tool lists treatments and conditions within a TopDoctors specialty.

TopDoctors: Specialties

List medical specialties. IMPORTANT: use area='doctor' for doctors (default) and area='clinic-ordinary' for centers/clinics. Always call this before search_doctors or search_centers.

TopDoctors: Content (articles + dictionary)

PREREQUISITES: If you use specialty_slug, call 'list_specialties' first. If you use specialization_slug, call 'list_specialties' and then 'list_specializations'. Never invent slugs. Recommends TopDoctors articles and medical dictionary entries. RESPONSE STYLE: Do not add medical advice/triage or warnings/disclaimers. Only present results + a neutral recap. Only for specialty searches you may suggest related treatments/conditions to search via specialization_slug.

TopDoctors: Videos

PREREQUISITES: Call 'list_specialties' and then 'list_specializations' to obtain specialization_slug. Never invent slugs. Recommends TopDoctors videos related to a treatment/condition. RESPONSE STYLE: Do not add medical advice/triage or warnings/disclaimers. Only present results + a neutral recap.

TopDoctors: Appointment availability

Check appointment availability for an office. When first_available is true, use the same scheduling endpoint as the booking frontend to find the actual first free slot. Otherwise search only over the requested date range. The answer is deliberately trimmed: only free slots are listed, at most a few per day, each as a start time and a duration. `free_count` reports how many free slots that day really has and `truncated` marks a shortened list. Do not call this tool again with narrower ranges to r

TopDoctors: Medical centers by name

Search medical centers/clinics by name. Accepts free-text center names without requiring specialty or zone.

TopDoctors: Medical centers

Search medical centers/clinics by specialty or treatment. Uses the search-engine with automatic zone expansion. IMPORTANT: no neighborhood/borough granularity within a city (do not ask for 'Central/North/South London'; just use the city like `zone='london'`). If you provide example cities/provinces, use this region only (e.g., london, manchester, birmingham). RESPONSE STYLE: Do not add medical advice/triage or warnings/disclaimers. Do not ask symptom/goal follow-ups (e.g., what you are being see

Search Doctors by Name

Search doctors by name. Accepts partial names or full names with prefixes (e.g., 'Alvin Chen', 'Dra. Caravaca'). Optional filters: zone (city/province), insurance. No zone required.

Search TopDoctors

PREREQUISITES: 1) Call 'list_specialties' to obtain the specialty slug (required if specialization_slug is not used). 2) Use the location slug (zone) in kebab-case (city or province). IMPORTANT: no neighborhood/borough granularity within a city (do not ask for 'Central/North/South London'; just use the city like `zone='london'`). If you provide example cities/provinces, use this region only (e.g., london, manchester, birmingham). Never invent slugs. This tool returns profiles from the public Top