Skip to main content
Glama

Free appointment slots

pz_free_slots
Read-onlyIdempotent

Finds free appointment start times (Tehran HH:MM) for one service at a center across a date range and returns the next available day when none exist.

Instructions

Free appointment start times (Tehran HH:MM) per day for one service at one center, for a date range.

With no free slot in the range, next_free_day gives the next one.

Input Schema

NameRequiredDescriptionDefault
date_toNoInclusive, default date_from; max 14 days after it.
center_idYescenter_id from pz_doctor or a search card; '5532' = online visit.
date_fromNoGregorian YYYY-MM-DD, default today.
service_idYesservice_id at that center.
user_center_idYesuser_center_id of the same center.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changedv0.5.0
    • changedInput schema / properties / center_id / description
      Previous value: -"center_id from pz_doctor or a search card, e.g. '291c1bfe-e8f3-414a-a82d-d6fe081683fb'; '5532' = online visit."New value: +"center_id from pz_doctor or a search card; '5532' = online visit."
    • changedInput schema / properties / date_from / description
      Previous value: -"First day, Gregorian YYYY-MM-DD (default today), e.g. '2026-10-10'."New value: +"Gregorian YYYY-MM-DD, default today."
    • changedInput schema / properties / date_to / description
      Previous value: -"Last day, inclusive (default date_from); at most 14 days after it."New value: +"Inclusive, default date_from; max 14 days after it."
    • changedInput schema / properties / service_id / description
      Previous value: -"service_id of a service at that center."New value: +"service_id at that center."
    • changedInput schema / properties / user_center_id / description
      Previous value: -"user_center_id of the same center (doctor-at-center id)."New value: +"user_center_id of the same center."
  2. Changed12 schema fields changedv0.3.0
    • changedInput schema / properties / center_id / description
      Previous value: -"center_id from pz_doctor or a pz_search_doctors card, e.g. '291c1bfe-e8f3-414a-a82d-d6fe081683fb'; '5532' = online visit."New value: +"center_id from pz_doctor or a search card, e.g. '291c1bfe-e8f3-414a-a82d-d6fe081683fb'; '5532' = online visit."
    • removedInput schema / properties / center_id / title
      Removed value: -"Center Id"
    • changedInput schema / properties / date_from / description
      Previous value: -"First day, Gregorian YYYY-MM-DD (default today in Iran), e.g. '2026-10-10'."New value: +"First day, Gregorian YYYY-MM-DD (default today), e.g. '2026-10-10'."
    • removedInput schema / properties / date_from / title
      Removed value: -"Date From"
    • changedInput schema / properties / date_to / description
      Previous value: -"Last day, inclusive (default date_from); at most 14 days after date_from."New value: +"Last day, inclusive (default date_from); at most 14 days after it."
    • removedInput schema / properties / date_to / title
      Removed value: -"Date To"
    • changedInput schema / properties / service_id / description
      Previous value: -"service_id of a service at that center, e.g. '1a4a8ec2-fdf9-436e-a32b-8fc4485f609c'."New value: +"service_id of a service at that center."
    • removedInput schema / properties / service_id / title
      Removed value: -"Service Id"
    • changedInput schema / properties / user_center_id / description
      Previous value: -"user_center_id of the same center (the doctor-at-center id), e.g. '09558bad-168d-4df8-b39d-437a260ca6fc'."New value: +"user_center_id of the same center (doctor-at-center id)."
    • removedInput schema / properties / user_center_id / title
      Removed value: -"User Center Id"
    • removedInput schema / title
      Removed value: -"pz_free_slotsArguments"
    • changedOutput schema / (root)
      Previous value: -{
      -  "additionalProperties": true,
      -  "title": "pz_free_slotsDictOutput",
      -  "type": "object"
      -}New value: +null
  3. First observedv0.1.0

TDQS

Score is being calculated.