Vitena Directory

Returns the valid filter values currently available in the Vitena provider directory: specialization codes (with human labels), spoken-language codes, and the countries that currently have listed professionals. Call this FIRST when you intend to filter a search by specialization — that argument only matches exact codes from this list, so guessing a specialty name will silently return no results. Note that CITY is NOT in this list and does not need to be: search_providers resolves a free-text city, district or region name against a gazetteer, so pass the name the user actually said.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Searches the public Vitena directory of health and wellness professionals who accept appointments (dietitians, dentists, physiotherapists, psychologists, beauty and aesthetics practitioners, child development specialists). Every filter is optional; with no filters it returns the first page of all publicly listed professionals. When the user names a specific professional or practice, pass that as 'name'. Results are public profile data only. Each result includes a profileUrl that can be given to the user for booking.

{
  "type": "object",
  "properties": {
    "discipline": {
      "type": "string",
      "description": "Profession to filter by. One of: dietitian, psychologist, physiotherapist, beauty, child-development, dentist, doctor, other.",
      "enum": [
        "dietitian",
        "psychologist",
        "physiotherapist",
        "beauty",
        "child-development",
        "dentist",
        "doctor",
        "other"
      ]
    },
    "location": {
      "type": "string",
      "description": "City, district or region name in free text, e.g. 'Istanbul', 'Kadıköy', 'Madrid', 'Andalucía'. Resolved against a place gazetteer, so it does NOT have to match a fixed list and is NOT returned by list_directory_filters — pass the place the user actually named. Choosing a region matches everywhere inside it. An unrecognised place returns an explanatory error rather than silently ignoring the filter."
    },
    "city": {
      "type": "string",
      "description": "Deprecated alias for 'location', kept so agents that learned the older argument name keep working. Prefer 'location'."
    },
    "country": {
      "type": "string",
      "description": "Two-letter ISO country code, e.g. 'TR', 'ES', 'DE'. Narrows an ambiguous place name. Valid values come from 'countries' in list_directory_filters."
    },
    "specialization": {
      "type": "string",
      "description": "Specialization CODE (not label) as returned by list_directory_filters."
    },
    "name": {
      "type": "string",
      "description": "Name of the professional or their practice in free text, e.g. 'Müjde Koyuncu'. Every word must appear in the person's name, the practice name or the profile slug; case and accents are ignored and part of a word is enough ('koyun'). Names that start with the given words come first."
    },
    "language": {
      "type": "string",
      "description": "Two-letter language code the professional consults in, e.g. 'es', 'tr'."
    },
    "workMode": {
      "type": "string",
      "description": "Consultation mode. 'online' for remote, 'in_person' for on-site.",
      "enum": [
        "online",
        "in_person"
      ]
    },
    "page": {
      "type": "integer",
      "description": "1-based page number. Page size is fixed at 20.",
      "minimum": 1
    }
  },
  "additionalProperties": false
}

Returns the full public profile of one professional by their slug (the value returned as 'slug' by search_providers): services offered, specializations, spoken languages, locations, working hours, contact details and whether online booking is available.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Profile slug from search_providers, e.g. 'cristobal-diaz'."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}