Cup24.it Availability

[DETAIL TOOL] Search appointment slots/cards. Use directly when clinic is known, or after search_available_clinics_map selection. Params: city (required), medical_service, doctor, clinic, start_day/end_day (YYYY-MM-DD). Date rules: 'tomorrow/domani' is the day after today; 'next week/prossima settimana' means the next calendar Monday-Sunday week, not tomorrow. If no results with doctor/clinic filters, automatically retries without them. Returns slots with booking_url for checkout (supports pre-filled params: &name=&last_name=&email=&phone=&tax_code=).

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name (full or partial, e.g., 'Firenze', 'Milan')"
    },
    "medical_service": {
      "type": "string",
      "description": "Service name or symptom description (full or partial, e.g., 'Rx Braccio', 'blood test', 'back pain')"
    },
    "doctor": {
      "type": "string",
      "description": "Doctor name (full or partial, e.g., 'Mario Rossi')"
    },
    "clinic": {
      "type": "string",
      "description": "Clinic/facility name (full or partial)"
    },
    "start_day": {
      "type": "string",
      "description": "Starting date for availability search (YYYY-MM-DD, default: today)"
    },
    "end_day": {
      "type": "string",
      "description": "Ending date for availability search (YYYY-MM-DD)"
    },
    "detailed": {
      "type": "boolean",
      "description": "Return full slot details (default: false, returns summary)"
    }
  },
  "required": [
    "city"
  ]
}

Search available booking slots.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name (full or partial, e.g., 'Firenze', 'Milan')"
    },
    "medical_service": {
      "type": "string",
      "description": "Service name or symptom description (full or partial, e.g., 'Rx Braccio', 'blood test', 'back pain')"
    },
    "start_day": {
      "type": "string",
      "description": "Starting date for availability search (YYYY-MM-DD, default: today)"
    },
    "end_day": {
      "type": "string",
      "description": "Ending date for availability search (YYYY-MM-DD)"
    }
  },
  "required": [
    "city",
    "medical_service"
  ]
}

[MAP TOOL] Discover clinics with availability and render them on map/sidebar. Params: city (required) + one of medical_service/doctor/clinic, optional date/time range. Date rules: 'tomorrow/domani' is the day after today; 'next week/prossima settimana' means the next calendar Monday-Sunday week, not tomorrow. Then wait for user click in widget; after selection run advanced_search_availability with city + medical_service + selected clinic.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name (full or partial, e.g., 'Firenze', 'Milan')"
    },
    "medical_service": {
      "type": "string",
      "description": "Service name or symptom description (e.g., 'ecografia addome completo')"
    },
    "doctor": {
      "type": "string",
      "description": "Doctor name (optional, narrows clinic search)"
    },
    "clinic": {
      "type": "string",
      "description": "Clinic/facility name (optional, narrows clinic search)"
    },
    "start_day": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD, default: today)"
    },
    "end_day": {
      "type": "string",
      "description": "End date (YYYY-MM-DD)"
    },
    "distance": {
      "type": "number",
      "description": "Max distance in km (default: 15)"
    },
    "start_time": {
      "type": "string",
      "description": "Daily start time HH:mm (e.g., 09:00)"
    },
    "end_time": {
      "type": "string",
      "description": "Daily end time HH:mm (e.g., 18:00)"
    }
  },
  "required": [
    "city"
  ]
}

Find cities by partial name. Use when: User mentions unfamiliar city or you need coordinates. Returns: City names, coordinates, province, region. Follow: Use city name with advanced_search_availability.

{
  "type": "object",
  "properties": {
    "term": {
      "type": "string",
      "description": "Partial city name (e.g., 'milan', 'rome')"
    }
  },
  "required": [
    "term"
  ]
}

Smart service finder (text search + AI combined). Use when: User has vague symptoms/descriptions OR you need to explore service options before booking. Runs parallel search and AI prediction, merges results by relevance. Returns: Service names and IDs. Follow: Use service info with advanced_search_availability.

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "Service name, symptom, or medical need description (e.g., 'blood test', 'back pain', 'x-ray arm')"
    },
    "top_k": {
      "type": "number",
      "description": "Number of results to return (default: 5, max: 10)"
    }
  },
  "required": [
    "text"
  ]
}