Servers Playground How we check Add a server Log in

Xona Dental Gateway

Working · 1.8 s

com.xonark/dental-gatewayv1.1.0 Domain verified

Find Canadian dentists; send an appointment request or book with a connected practice.

Local Services

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://book.xonark.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

abandon_xona_booking

Release the held time and drop the patient's details when the patient no longer wants it, at any step before it is booked. It never cancels a booked appointment. Calling again returns the same result.

action_idstring, required

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Xona Dental Gateway MCP server | mcptry

Tools (20)

abandon_xona_booking

Argument	Type	Description
action_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "action_id"
  ],
  "properties": {
    "action_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 16
    }
  },
  "additionalProperties": false
}

answer_dental_practice_question

Answer a bounded factual question from the selected practices' evidence. Unknown is returned explicitly; missing data is never inferred as no.

read-only

Argument	Type	Description
topic*	string
practice_slugs*	array

Input schema (JSON)

{
  "type": "object",
  "required": [
    "practice_slugs",
    "topic"
  ],
  "properties": {
    "topic": {
      "enum": [
        "identity",
        "location",
        "hours",
        "services",
        "languages",
        "new_patients",
        "coverage",
        "accessibility",
        "emergency",
        "booking",
        "patient_mentions"
      ],
      "type": "string"
    },
    "practice_slugs": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 140,
        "minLength": 1
      },
      "maxItems": 10,
      "minItems": 1
    }
  },
  "additionalProperties": false
}

change_xona_appointment

Move or cancel one of the patient's appointments. Xona texts the patient a link to a page that shows the exact change. When they press its button (or type the code from the text on book.xonark.com/code) the practice's schedule changes, or, at a practice that confirms changes itself, the practice receives the request. Calling again with the same arguments returns the result, read live from the practice's schedule.

Argument	Type	Description
date	string	For a reschedule: the new time's date exactly as list_xona_reschedule_times returned it
kind*	string
action_id*	string
appointment_ref*	string
slot_fingerprint	string	For a reschedule: the new time's slot_fingerprint from list_xona_reschedule_times

Input schema (JSON)

{
  "type": "object",
  "required": [
    "action_id",
    "appointment_ref",
    "kind"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "description": "For a reschedule: the new time's date exactly as list_xona_reschedule_times returned it"
    },
    "kind": {
      "enum": [
        "cancel",
        "reschedule"
      ],
      "type": "string"
    },
    "action_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 16
    },
    "appointment_ref": {
      "type": "string",
      "maxLength": 64,
      "minLength": 8
    },
    "slot_fingerprint": {
      "type": "string",
      "pattern": "^[0-9a-f]{32}$",
      "description": "For a reschedule: the new time's slot_fingerprint from list_xona_reschedule_times"
    }
  },
  "additionalProperties": false
}

choose_public_booking_time

For a public_provider_booking action: keeps one time from list_public_booking_slots (or a soonest search row's earliest) and returns continue_url, Xona's page where the patient enters their own details and presses Book. Xona then books that time in the clinic's own scheduler. It takes the action and the time (service_id, slot_id, starts_at) only, reads that time again and keeps it only if it is still open; the page collects the patient's details.

Argument	Type	Description
slot_id*	string	The chosen time's id from list_public_booking_slots (slot_id on a soonest row's earliest).
action_id*	string
starts_at*	string	The chosen time's starts_at, exactly as returned.
service_id*	string	The chosen time's service_id.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "action_id",
    "service_id",
    "slot_id",
    "starts_at"
  ],
  "properties": {
    "slot_id": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1,
      "description": "The chosen time's id from list_public_booking_slots (slot_id on a soonest row's earliest)."
    },
    "action_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 16
    },
    "starts_at": {
      "type": "string",
      "format": "date-time",
      "maxLength": 64,
      "description": "The chosen time's starts_at, exactly as returned."
    },
    "service_id": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1,
      "description": "The chosen time's service_id."
    }
  },
  "additionalProperties": false
}

confirm_dental_request

Report a started request's status. It never sends: waiting_for_patient until the patient presses "Send this request" on Xona's page, then the stored result: sent, delivery unknown or failed, expired, or stopped by the patient. A sent request is never a confirmed booking.

read-only

Argument	Type	Description
action_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "action_id"
  ],
  "properties": {
    "action_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 16
    }
  },
  "additionalProperties": false
}

confirm_xona_booking

Get the result once the patient has tapped the text link and pressed Book this appointment. Until then it returns waiting_for_patient. Xona finds an existing patient itself; when it cannot tell, it returns the practice's booking page instead of guessing. If the booking stopped before it was written, the first call tries it once more. Calling again returns the same outcome.

Argument	Type	Description
action_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "action_id"
  ],
  "properties": {
    "action_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 16
    }
  },
  "additionalProperties": false
}

get_canadian_dental_practice

Get one public dental practice profile, fact evidence, citations, and current public actions.

read-only

Argument	Type	Description
practice_slug*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "practice_slug"
  ],
  "properties": {
    "practice_slug": {
      "type": "string",
      "maxLength": 140,
      "minLength": 1
    }
  },
  "additionalProperties": false
}

get_dental_action_status

Read the exact outcome of an expiring dental action. Handoff, request, and confirmed booking outcomes remain distinct.

read-only

Argument	Type	Description
action_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "action_id"
  ],
  "properties": {
    "action_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 16
    }
  },
  "additionalProperties": false
}

hold_xona_booking_slot

Hold one open time and text the patient a link to it. The page the link opens shows the time and the details above a Book this appointment button. When the patient presses it the appointment is booked, or, at a practice that confirms bookings itself, sent to the practice as a request.

Argument	Type	Description
date*	string	The chosen slot's date exactly as list_xona_booking_slots returned it
note	string
last_name*	string	The patient's last name, as the patient gave it in this conversation
first_name*	string	The patient's first name, as the patient gave it in this conversation
service_id*	string
date_of_birth*	string	The patient's date of birth, as the patient gave it in this conversation
guardian_name	string	Required when the patient is under 16
patient_phone*	string	The patient's own Canadian or US mobile number, as the patient gave it in this conversation; the booking link is texted there

list_dental_practice_actions

List current public booking, request, form, call, and website actions for a dental practice in preference order.

read-only

Argument	Type	Description
practice_slug*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "practice_slug"
  ],
  "properties": {
    "practice_slug": {
      "type": "string",
      "maxLength": 140,
      "minLength": 1
    }
  },
  "additionalProperties": false
}

list_public_booking_services

Read the services a clinic's own online scheduler offers, by practice_slug: a clinic whose search row is live_schedule, or whose action option has reads_times. The answer carries booking_url, the page where the patient books this clinic; a clinic whose scheduler can't be read answers readable false with that booking_url. An answer may be up to 5 minutes old: read_at says when the clinic's scheduler was read and age_seconds how long ago; fresh: true reads this clinic again (twice a minute per clinic; past that the answer says when it next can). Provider locators remain server-owned.

read-only

Argument	Type	Description
fresh	boolean	Read this clinic's scheduler now rather than from a read up to 5 minutes old
practice_slug*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "practice_slug"
  ],
  "properties": {
    "fresh": {
      "type": "boolean",
      "description": "Read this clinic's scheduler now rather than from a read up to 5 minutes old"
    },
    "practice_slug": {
      "type": "string",
      "maxLength": 140,
      "minLength": 1
    }
  },
  "additionalProperties": false
}

list_public_booking_slots

Read open times from a clinic's own online scheduler, by practice_slug, for one service_id between date_from and date_to (the clinic's dates, both included, at most 14 days). Each time carries starts_at, start_local (the time at the clinic), time_zone and booking_url, the page where the patient books that time (Xona's page on that service and day where Xona books the clinic's scheduler, else the clinic's own booking page); earliest is the first one; preferred_time puts the closest times first. An answer may be up to 5 minutes old: read_at says when the clinic's scheduler was read and age_seconds how long ago; fresh: true reads this clinic again (twice a minute per clinic; past that the answer says when it next can).

read-only

Argument	Type	Description
fresh	boolean	Read this clinic's scheduler now rather than from a read up to 5 minutes old
date_to*	string	Last day to read (inclusive), at most 13 days after date_from
date_from*	string	First day to read, in the clinic's time zone; today or later
service_id*	string	A service_id from list_public_booking_services, or from a soonest search row's services
practice_slug*	string
preferred_time

list_xona_appointments

Read the named patient's upcoming appointments at the practice, live from its schedule, after the patient tapped the text link. Works with the action_id of a booking made in this conversation (for 30 minutes after the tap, and for that appointment until its day) or of start_xona_appointment_access. Before the tap it says it is still waiting.

read-only

Argument	Type	Description
action_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "action_id"
  ],
  "properties": {
    "action_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 16
    }
  },
  "additionalProperties": false
}

list_xona_booking_services

List the services a practice that connected its schedule to Xona books online. Use it where list_dental_practice_actions marks the Xona booking route as completes_in_conversation.

read-only

Argument	Type	Description
practice_slug*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "practice_slug"
  ],
  "properties": {
    "practice_slug": {
      "type": "string",
      "maxLength": 140,
      "minLength": 1
    }
  },
  "additionalProperties": false
}

list_xona_booking_slots

List open times at a connected practice for one service between date_from and date_to (inclusive, at most 8 weeks out). Returns the closest ten to preferred_time (else a balanced spread) plus the earliest open time, with a reason when empty. Each slot has a slot_fingerprint and date for hold_xona_booking_slot.

read-only

Argument	Type	Description
date_to*	string	Last day to search (inclusive); at most 56 days after date_from and 8 weeks from today
date_from*	string	First day to search, in the practice's time zone
doctor_id	string	Restrict to one provider, using a doctor_id a previous slot listing returned
service_id*	string
practice_slug*	string
preferred_time	string	The patient's preferred local start time, 24-hour HH:MM; slots closest to it come first

Input schema (JSON)

{
  "type": "object",
  "required": [
    "practice_slug",
    "service_id",
    "date_from",
    "date_to"
  ],
  "properties": {
    "date_to": {
      "type": "string",
      "format": "date",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "description": "Last day to search (inclusive); at most 56 days after date_from and 8 weeks from today"
    },
    "date_from": {
      "type": "string",
      "format": "date",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "description": "First day to search, in the practice's time zone"
    },
    "doctor_id": {
      "type": "string",
      "maxLength": 160,
      "description": "Restrict to one provider, using a doctor_id a previous slot listing returned"
    },
    "service_id": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1
    },
    "practice_slug": {
      "type": "string",
      "maxLength": 140,
      "minLength": 1
    },
    "preferred_time": {
      "type": "string",
      "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
      "description": "The patient's preferred local start time, 24-hour HH:MM; slots closest to it come first"
    }
  },
  "additionalProperties": false
}

list_xona_reschedule_times

List open times one of the patient's appointments can move to, for its own service and provider, between date_from and date_to. appointment_ref comes from list_xona_appointments.

read-only

Argument	Type	Description
date_to*	string	Last day to search (inclusive); at most 56 days after date_from and 8 weeks from today
action_id*	string
date_from*	string	First day to search, in the practice's time zone
appointment_ref*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "action_id",
    "appointment_ref",
    "date_from",
    "date_to"
  ],
  "properties": {
    "date_to": {
      "type": "string",
      "format": "date",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "description": "Last day to search (inclusive); at most 56 days after date_from and 8 weeks from today"
    },
    "action_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 16
    },
    "date_from": {
      "type": "string",
      "format": "date",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "description": "First day to search, in the practice's time zone"
    },
    "appointment_ref": {
      "type": "string",
      "maxLength": 64,
      "minLength": 8
    }
  },
  "additionalProperties": false
}

prepare_dental_practice_action

Creates a short-lived action for one capability the clinic's action options list (its scheduler page, a Xona request, a request form, a call or its website) and returns the URL of the page for it. A capability the clinic does not list is refused. A connected practice's time from list_xona_booking_slots is held with hold_xona_booking_slot, not through this tool.

Argument	Type	Description
capability*	string
practice_slug*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "practice_slug",
    "capability"
  ],
  "properties": {
    "capability": {
      "enum": [
        "public_provider_booking",
        "public_booking_handoff",
        "xona_email_appointment_request",
        "external_request_form",
        "call_clinic",
        "visit_clinic_website"
      ],
      "type": "string"
    },
    "practice_slug": {
      "type": "string",
      "maxLength": 140,
      "minLength": 1
    }
  },
  "additionalProperties": false
}

search_canadian_dentists

Search evidence-backed public profiles in the Canadian dental directory by name or place, and filter by a service, a language, published weekend or evening hours, a booking route you can use now, and a payment plan the clinic says it accepts (the Canadian Dental Care Plan). Each row says which published fact matched and when it was read. A search with order=soonest, the patient's postal code or city and the service returns live rows that already carry each clinic's earliest time, its services and booking_url, the page where the patient books that time; opening it starts the booking there, with no call in the conversation. A row's read.read_at says when its times were read, at most 5 minutes before. The tool a row's next_step names reads more times. Each earliest is only a first pick: the first service in the clinic's own list whose name holds the need's word, an adult's before a child's. Clinic service names often say more than that word: "New Patient Exam (No Cleaning)", a new-patient bundle of exam, x-rays and cleaning, a service for children only, a fee or insurance note. Read service_name against what the patient needs; when it does not fit, choose the service that does from services and read its times with list_public_booking_slots. No login or clinic membership is required.

read-only

Argument	Type	Description
open	string	Published hours: open that day, or closing at/after 18:00 on some day
page	integer	Page of results, from 1; each page holds limit rows
limit	integer
order	string	route (default) orders by booking route; soonest orders one place's practices by when they can be seen, and needs that place: its locality (and province when the name is in more than one), or a postal_code such as M5V or M5V 1B3. Practices whose live schedule Xona reads come first, each page's read now and ordered by their earliest open time for the search's service (cleaning, exam or emergency; cleaning when none is given), then open now, then by when each opens by its own website's hours. Each row then carries when: state (live_schedule, open_now, opens_today, opens_later, unknown), text, time_zone and, for live_schedule, next_step naming the tools that read more times. Every row carries booking_url, the page where the patient books that clinic. A live row the search read also carries earliest (the time, its service_id, start_local, the id that books it and its own booking_url; [] when none in the next 7 days), services (the clinic's own list) and read (outcome time, none or not_read). live_unread counts the live clinics on later pages. Opening hours are not appointment times.

start_dental_request

Start an appointment request for Xona to send to the selected clinic (by email, or through the clinic's own website form). It takes the patient's details and preferred times. Xona emails the patient a link that shows the exact request; the request goes to the clinic only when the patient presses "Send this request" there, or enters the email's code on continue_url. The result carries consent_text and continue_url; confirm_dental_request reports the status. Use it where list_dental_practice_actions marks xona_email_appointment_request as completes_in_conversation.

Argument	Type	Description
note	string
patient_name*	string	The patient's name as they typed it
patient_email*	string	The patient's own email; the link to send the request goes there
patient_phone	string	The patient's phone as they typed it; required when the clinic's website form needs one
practice_slug*	string
preferred_window*	string	When the patient is free, in their words
service_category*	string

start_xona_appointment_access

Text a patient one link to see, move or cancel the appointments they already have at a practice connected to Xona, for a conversation with no booking action_id that still works. If the mobile number, name and date of birth match a patient there, Xona texts them the link; after they tap it and press Show my appointments, list_xona_appointments reads their appointments. The answer is the same whether or not the details match.

Argument	Type	Description
last_name*	string
first_name*	string
date_of_birth*	string
patient_phone*	string	The patient's own Canadian or US mobile number, as the practice has it on file
practice_slug*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "practice_slug",
    "patient_phone",
    "first_name",
    "last_name",
    "date_of_birth"
  ],
  "properties": {
    "last_name": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1
    },
    "first_name": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1
    },
    "date_of_birth": {
      "type": "string",
      "format": "date",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
    },
    "patient_phone": {
      "type": "string",
      "maxLength": 32,
      "minLength": 7,
      "description": "The patient's own Canadian or US mobile number, as the practice has it on file"
    },
    "practice_slug": {
      "type": "string",
      "maxLength": 140,
      "minLength": 1
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "open": {
      "enum": [
        "saturday",
        "sunday",
        "weekend",
        "evening"
      ],
      "type": "string",
      "description": "Published hours: open that day, or closing at/after 18:00 on some day"
    },
    "page": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Page of results, from 1; each page holds limit rows"
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1
    },
    "order": {
      "enum": [
        "route",
        "soonest"
      ],
      "type": "string",
      "description": "route (default) orders by booking route; soonest orders one place's practices by when they can be seen, and needs that place: its locality (and province when the name is in more than one), or a postal_code such as M5V or M5V 1B3. Practices whose live schedule Xona reads come first, each page's read now and ordered by their earliest open time for the search's service (cleaning, exam or emergency; cleaning when none is given), then open now, then by when each opens by its own website's hours. Each row then carries when: state (live_schedule, open_now, opens_today, opens_later, unknown), text, time_zone and, for live_schedule, next_step naming the tools that read more times. Every row carries booking_url, the page where the patient books that clinic. A live row the search read also carries earliest (the time, its service_id, start_local, the id that books it and its own booking_url; [] when none in the next 7 days), services (the clinic's own list) and read (outcome time, none or not_read). live_unread counts the live clinics on later pages. Opening hours are not appointment times."
    },
    "query": {
      "type": "string",
      "maxLength": 160
    },
    "booking": {
      "enum": [
        "online",
        "form",
        "xona_request",
        "call",
        "any"
      ],
      "type": "string",
      "description": "A route the agent can use now: the clinic's online booking page, its request form, an appointment request Xona delivers, a phone number, or any of these"
    },
    "service": {
      "type": "string",
      "maxLength": 60,
      "description": "A service the clinic's own site lists: cleaning, implants, invisalign, emergency, kids, root canal, whitening …"
    },
    "coverage": {
      "enum": [
        "cdcp"
      ],
      "type": "string",
      "description": "A payment plan the clinic says it accepts, on its own website or in a correction its owner made: cdcp is the Canadian Dental Care Plan. Each row quotes the clinic's own words and the day they were read"
    },
    "language": {
      "type": "string",
      "maxLength": 40,
      "description": "A language the clinic's own site lists"
    },
    "locality": {
      "type": "string",
      "maxLength": 100
    },
    "province": {
      "type": "string",
      "maxLength": 40
    },
    "postal_code": {
      "type": "string",
      "maxLength": 12
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "practice_slug",
    "patient_name",
    "patient_email",
    "service_category",
    "preferred_window"
  ],
  "properties": {
    "note": {
      "type": "string",
      "maxLength": 500
    },
    "patient_name": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1,
      "description": "The patient's name as they typed it"
    },
    "patient_email": {
      "type": "string",
      "format": "email",
      "maxLength": 254,
      "minLength": 3,
      "description": "The patient's own email; the link to send the request goes there"
    },
    "patient_phone": {
      "type": "string",
      "maxLength": 32,
      "description": "The patient's phone as they typed it; required when the clinic's website form needs one"
    },
    "practice_slug": {
      "type": "string",
      "maxLength": 140,
      "minLength": 1
    },
    "preferred_window": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1,
      "description": "When the patient is free, in their words"
    },
    "service_category": {
      "enum": [
        "checkup_cleaning",
        "children",
        "cosmetic",
        "implants",
        "new_patient",
        "orthodontics",
        "other",
        "tooth_pain"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}