One Stop: Appointments MCP tools
Service overview · CLI reference · All MCP tools · Data types
Appointments
Appointment slots belong to a prepared draft and can change before booking. Review the returned options and confirm the selected slot. The available tools do not support cancellation or rescheduling.
onestop_list_my_appointments
Read your native upcoming appointment list with appointment numbers, published dates/times and locations. This listing exposes no cancellation/rescheduling controls; no appointment is changed.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
limit |
integer |
No | minimum: 1; maximum: 100; default: 20 |
offset |
integer |
No | minimum: 0; default: 0 |
Output
| Field | Type | Required | Details |
|---|---|---|---|
offset |
integer |
Yes | minimum: 0 |
available_count |
integer |
Yes | minimum: 0 |
total_count |
integer or null |
Yes | minimum: 0 |
complete |
boolean |
Yes | — |
next_offset |
integer or null |
Yes | minimum: 0 |
retrieved_at |
string |
Yes | format: date-time |
source_url |
string |
Yes | — |
cached |
boolean |
Yes | — |
records |
array of PortalRecord |
Yes | — |
Unknown fields are not accepted.
onestop_get_appointment_configuration
Read the native appointment selector's configuration on a local catalog draft: enabled/mandatory flags, duration, booking horizon and weekdays. Use an appointment service's form_item_id to prepare the draft.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
draft_id |
string |
Yes | minimum length: 16; maximum length: 100 |
Output
| Field | Type | Required | Details |
|---|---|---|---|
draft_id |
string |
Yes | — |
item_id |
string |
Yes | — |
enabled |
boolean |
Yes | — |
duration_minutes |
integer or null |
Yes | — |
future_bookable_days |
integer or null |
Yes | — |
bookable_weekdays |
string or null |
Yes | — |
mandatory |
boolean |
Yes | — |
Unknown fields are not accepted.
onestop_get_appointment_slots
Read available appointment windows for one day using the draft's current native location/contact/reason configuration. Returned slot IDs are bound to this draft's latest lookup. No time is reserved or booked; availability can change until submission.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
draft_id |
string |
Yes | minimum length: 16; maximum length: 100 |
date |
string |
Yes | pattern: ^\d{4}-\d{2}-\d{2}$ |
Output
| Field | Type | Required | Details |
|---|---|---|---|
draft_id |
string |
Yes | — |
date |
string |
Yes | — |
timezone |
string or null |
Yes | — |
slots |
array of AppointmentSlot |
Yes | — |
retrieved_at |
string |
Yes | format: date-time |
Unknown fields are not accepted.
onestop_select_appointment_slot
Select a slot from this draft's latest availability lookup using the native appointment event. Updates the local form and validation preview only. Changing draft answers requires another availability lookup and selection.
This tool changes local workflow state.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
draft_id |
string |
Yes | minimum length: 16; maximum length: 100 |
slot_id |
string |
Yes | minimum length: 16; maximum length: 100 |
Output
| Field | Type | Required | Details |
|---|---|---|---|
draft_id |
string |
Yes | — |
item_id |
string |
Yes | — |
title |
string |
Yes | — |
source_url |
string |
Yes | — |
expires_at |
string |
Yes | format: date-time |
state |
"prepared", "submitting", "submitted", "uncertain" |
Yes | — |
ready |
boolean |
Yes | — |
missing_fields |
array of string |
Yes | — |
invalid_fields |
array of string |
Yes | — |
fields |
array of DraftField |
Yes | — |
available_actions |
array of string |
Yes | — |
receipt_id |
string or null |
No | default: null |
Unknown fields are not accepted.
onestop_book_appointment
Book an appointment by optionally selecting a verified slot and submitting the reviewed native catalog draft once. All native mandatory questions must be complete. Reusing a completed draft returns its receipt; uncertain bookings are never auto-retried.
MCP host confirmation is required before this action.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
draft_id |
string |
Yes | minimum length: 16; maximum length: 100 |
slot_id |
string or null |
No | default: null; minimum length: 16; maximum length: 100 |
Output
| Field | Type | Required | Details |
|---|---|---|---|
operation |
string |
Yes | — |
completed_at |
string |
Yes | format: date-time |
source_url |
string |
Yes | — |
resource_id |
string or null |
Yes | — |
outcome |
"completed", "unchanged", "uncertain", "requires_user_action" |
Yes | — |
verified |
boolean |
Yes | — |
message |
string or null |
Yes | — |
references |
array of NamedValue |
Yes | — |
Unknown fields are not accepted.
See the MCP data types for nested object fields.