MCP Server
HairDora Salon Scheduling
com.hairdora/hairdora
What this MCP does
Reviews tenant-scoped salon clients, appointments, availability, services, quotes, providers, calendar blocks, and payment records without performing payment actions.
Capabilities
Tools
13
tools
get_appointment
Get appointment details
Use this when someone asks what services a specific appointment includes, their prices, or the appointment's status. Returns one appointment's client and salon ids, times, status and up to 50 booked services with prices. Not for finding bookings by date.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['appointmentId'], 'properties': {'appointmentId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': 'Id of one appointment, as the appointment list returns it (24 lowercase hex characters)'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'appointment'], 'properties': {'status': {'enum': ['found', 'not-found'], 'type': 'string'}, 'appointment': {'anyOf': [{'type': 'object', 'required': ['id', 'clientId', 'salonId', 'startTime', 'endTime', 'status', 'serviceCount', 'servicesTruncated', 'services'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, 'status': {'anyOf': [{'enum': ['SCHEDULED', 'CLIENT_ARRIVED', 'NO_SHOW', 'CANCELED'], 'type': 'string'}, {'type': 'null'}]}, 'endTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'salonId': {'anyOf': [{'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, {'type': 'null'}]}, 'clientId': {'anyOf': [{'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, {'type': 'null'}]}, 'services': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'price'], 'properties': {'id': {'anyOf': [{'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, {'type': 'null'}]}, 'name': {'type': 'string', 'maxLength': 200}, 'price': {'type': ['number', 'null']}}, 'additionalProperties': False}, 'maxItems': 50}, 'startTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'serviceCount': {'type': 'integer', 'maximum': 10000, 'minimum': 0}, 'servicesTruncated': {'type': 'boolean'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'One booking with up to 50 booked services and their prices; null when not found. Free-text notes, reminders, contact details, organization data and payment data are excluded.'}}, 'additionalProperties': False}
get_client
Get client details
Use this when someone asks about one salon client, such as their preferred language or which salon they belong to. Returns the client's name, salon, language and last edit time. Not for the client's email, phone or booking history.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['clientId'], 'properties': {'clientId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': 'Id of one client, as the client list returns it (24 lowercase hex characters)'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'client'], 'properties': {'client': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'salonId', 'language', 'lastEditTime'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, 'name': {'type': 'string', 'maxLength': 200}, 'salonId': {'anyOf': [{'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, {'type': 'null'}]}, 'language': {'anyOf': [{'type': 'string', 'maxLength': 16}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'Name, salon, language and edit time only; null when not found. Email, phone, address, operator notes, service and colour history, organization data and other profile fields are excluded.'}, 'status': {'enum': ['found', 'not-found'], 'type': 'string'}}, 'additionalProperties': False}
get_salon
Get salon details and opening hours
Use this when someone asks for one salon's opening hours, address, phone, website, timezone or default appointment length. Returns that salon's business settings with up to 14 opening-hour rows, Monday first. Not for free booking slots.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['salonId'], 'properties': {'salonId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': "Id of one of the user's salons, as the salon list returns it (24 lowercase hex characters)"}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'salon'], 'properties': {'salon': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'currency', 'defaultLocale', 'timezone', 'countryCode', 'firstDayOfTheWeek', 'appointmentDuration', 'phone', 'street', 'city', 'state', 'postalCode', 'website', 'openingHours', 'openingHoursTruncated'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, 'city': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'name': {'type': 'string', 'maxLength': 200}, 'phone': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'state': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'street': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'website': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}]}, 'currency': {'anyOf': [{'type': 'string', 'pattern': '^[A-Z]{3}$'}, {'type': 'null'}]}, 'timezone': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'postalCode': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'countryCode': {'anyOf': [{'type': 'string', 'pattern': '^[A-Z]{2}$'}, {'type': 'null'}]}, 'openingHours': {'type': 'array', 'items': {'type': 'object', 'required': ['day', 'open', 'close'], 'properties': {'day': {'anyOf': [{'enum': ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday'], 'type': 'string'}, {'type': 'null'}]}, 'open': {'anyOf': [{'type': 'string', 'pattern': '^\\d{1,2}:\\d{2}$'}, {'type': 'null'}]}, 'close': {'anyOf': [{'type': 'string', 'pattern': '^\\d{1,2}:\\d{2}$'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 14}, 'defaultLocale': {'anyOf': [{'type': 'string', 'maxLength': 16}, {'type': 'null'}]}, 'firstDayOfTheWeek': {'anyOf': [{'enum': ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday'], 'type': 'string'}, {'type': 'null'}]}, 'appointmentDuration': {'anyOf': [{'type': 'integer', 'maximum': 1440, 'exclusiveMinimum': 0}, {'type': 'null'}], 'description': 'Default appointment length in minutes'}, 'openingHoursTruncated': {'type': 'boolean', 'description': 'True when the salon has more than 14 opening-hour rows'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'Business settings of the salon; null when not found. Organization ids, payment configuration, credentials, integrations, reminders, staff data and internal metadata are excluded.'}, 'status': {'enum': ['found', 'not-found'], 'type': 'string'}}, 'additionalProperties': False}
get_salon_availability
Find free appointment slots
Use this when someone asks when their hair salon has free appointment slots or the next opening. Returns, per day, how many online-booking slots are open plus the first start and last end time, for the next 14 days that have openings (no client or stylist names). Not for making a booking.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['salonId'], 'properties': {'salonId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': "Id of one of the user's salons, as the salon list returns it (24 lowercase hex characters)"}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'days'], 'properties': {'days': {'type': 'array', 'items': {'type': 'object', 'required': ['day', 'slotCount', 'firstSlot', 'lastSlot'], 'properties': {'day': {'anyOf': [{'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, {'type': 'null'}]}, 'lastSlot': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}], 'description': 'End time of the last open slot that day'}, 'firstSlot': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}], 'description': 'Start time of the first open slot that day'}, 'slotCount': {'type': 'integer', 'maximum': 1440, 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 14, 'description': "One row per day with open online-booking slots inside the salon's booking window, in date order. Slot counts and times only; who holds a booked time is never exposed."}, 'status': {'enum': ['found', 'salon-not-found', 'no-availability'], 'type': 'string'}}, 'additionalProperties': False}
list_appointments
List salon appointments
Use this when someone asks how many appointments are booked on a day or in a period, how many were canceled or no-shows, or when a client is booked. Returns appointments across all the user's salons, or just one, with id, client and salon ids, times and status for any date window, latest first, up to 100. Not for the services inside an appointment.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Maximum number of appointments to return (default 20, maximum 100)', 'exclusiveMinimum': 0}, 'endTime': {'type': 'string', 'maxLength': 32, 'description': 'Only appointments ending before this ISO 8601 time'}, 'salonId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': "Only appointments at this salon, by an id from the user's salon list; every salon when absent"}, 'clientId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': 'Only appointments of this client, by an id from the client list'}, 'startTime': {'type': 'string', 'maxLength': 32, 'description': 'Only appointments starting at or after this ISO 8601 time'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['appointments', 'count', 'hasMore'], 'properties': {'count': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'hasMore': {'type': 'boolean'}, 'appointments': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'clientId', 'salonId', 'startTime', 'endTime', 'status'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, 'status': {'anyOf': [{'enum': ['SCHEDULED', 'CLIENT_ARRIVED', 'NO_SHOW', 'CANCELED'], 'type': 'string'}, {'type': 'null'}]}, 'endTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'salonId': {'anyOf': [{'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, {'type': 'null'}]}, 'clientId': {'anyOf': [{'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, {'type': 'null'}]}, 'startTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Bookings, latest start first. Free-text notes, reminders, contact details, organization data and payment details are excluded.'}}, 'additionalProperties': False}
list_calendar_events
List closures, days off and blocked time
Use this when someone asks when their salon is closed or has extra opening hours, or when a stylist or chair is blocked for holidays, vacations, sick days, training or meetings. Returns blocks and extra openings with salon, type, scope, effect, all-day flag and times for all salons unless one is given, earliest first (no titles or notes). Not for client appointments.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Maximum number of calendar events to return (default 20, maximum 100)', 'exclusiveMinimum': 0}, 'endTime': {'type': 'string', 'maxLength': 32, 'description': 'Only events ending before this ISO 8601 time'}, 'salonId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': "Only blocks for this salon, by an id from the user's salon list; every salon when absent"}, 'startTime': {'type': 'string', 'maxLength': 32, 'description': 'Only events starting at or after this ISO 8601 time'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['events', 'count', 'hasMore'], 'properties': {'count': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'salonId', 'type', 'scope', 'effect', 'allDay', 'startTime', 'endTime'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, 'type': {'anyOf': [{'enum': ['COURSE', 'MEETING', 'VACATION', 'SICK', 'HOLIDAY', 'MAINTENANCE', 'OTHER'], 'type': 'string'}, {'type': 'null'}]}, 'scope': {'anyOf': [{'enum': ['CHAIR', 'PROVIDER', 'SALON'], 'type': 'string'}, {'type': 'null'}], 'description': 'SALON: the whole salon; PROVIDER: one or more stylists; CHAIR: one chair'}, 'allDay': {'type': 'boolean'}, 'effect': {'anyOf': [{'enum': ['BLOCK', 'OPEN'], 'type': 'string'}, {'type': 'null'}], 'description': 'BLOCK removes bookable time; OPEN adds hours on a normally closed time'}, 'endTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'salonId': {'anyOf': [{'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, {'type': 'null'}]}, 'startTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Closures, days off and extra openings, earliest first. Free-text titles and notes, chair ids, staff ids, organization data and private reasons are excluded.'}, 'hasMore': {'type': 'boolean'}}, 'additionalProperties': False}
list_clients
Look up salon clients
Use this when someone asks who their clients are, or needs a client id to look up that person's appointments, payments or quotes. Returns up to 100 clients (20 by default) across all the user's salons, or just one, with id, name, salon and last edit time, in no particular order and without a name search. Not for a client's email, phone or notes.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Maximum number of clients to return (default 20, maximum 100)', 'exclusiveMinimum': 0}, 'salonId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': "Only clients of this salon, by an id from the user's salon list; every salon when absent"}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['clients', 'count', 'hasMore'], 'properties': {'count': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'clients': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'salonId', 'lastEditTime'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, 'name': {'type': 'string', 'maxLength': 200}, 'salonId': {'anyOf': [{'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Clients with the ids needed to look up their bookings, payments and quotes. Email, phone, address, operator notes, service and colour history, organization data and other profile fields are excluded.'}, 'hasMore': {'type': 'boolean'}}, 'additionalProperties': False}
list_payments
List salon payments
Use this when someone asks what payments their salon took, whether a client paid, or how much came in over a period. Returns payment records with id, client and salon ids, date, amount, currency and status for any date window and all salons unless one is given, newest first, up to 100 (no card details). Not for charging or refunding a client.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Maximum number of payments to return (default 20, maximum 100)', 'exclusiveMinimum': 0}, 'endTime': {'type': 'string', 'maxLength': 32, 'description': 'Only payments ending before this ISO 8601 time'}, 'salonId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': "Only payments at this salon, by an id from the user's salon list; every salon when absent"}, 'clientId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': 'Only payments from this client, by an id from the client list'}, 'startTime': {'type': 'string', 'maxLength': 32, 'description': 'Only payments starting at or after this ISO 8601 time'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['payments', 'count', 'hasMore'], 'properties': {'count': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'hasMore': {'type': 'boolean'}, 'payments': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'clientId', 'salonId', 'startTime', 'amount', 'currency', 'status'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, 'amount': {'type': ['number', 'null']}, 'status': {'anyOf': [{'enum': ['CANCELED', 'FAILED', 'SUCCEEDED'], 'type': 'string'}, {'type': 'null'}]}, 'salonId': {'anyOf': [{'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, {'type': 'null'}]}, 'clientId': {'anyOf': [{'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, {'type': 'null'}]}, 'currency': {'anyOf': [{'type': 'string', 'pattern': '^[A-Z]{3}$'}, {'type': 'null'}]}, 'startTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Payment records, newest first; this tool cannot charge, refund or move funds. Cardholder data, processor and customer ids, credentials, errors, discounts, staff commission splits, operator notes and organization data are excluded.'}}, 'additionalProperties': False}
list_providers
List stylists who take appointments
Use this when someone asks which stylists or hairdressers work at their salon or can be booked. Returns up to 100 hairdresser display names from the organization that owns the salon (no contact details or schedules). Not for stylists' days off.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['salonId'], 'properties': {'salonId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': "Id of one of the user's salons, as the salon list returns it (24 lowercase hex characters)"}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'providers', 'count', 'hasMore'], 'properties': {'count': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'status': {'enum': ['found', 'salon-not-found'], 'type': 'string'}, 'hasMore': {'type': 'boolean'}, 'providers': {'type': 'array', 'items': {'type': 'object', 'required': ['displayName'], 'properties': {'displayName': {'type': 'string', 'maxLength': 200}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Display names of organization members with the hairdresser role; roles are organization-wide, not per salon. Staff ids, contact details, avatar URLs, role records, schedules and organization data are excluded.'}}, 'additionalProperties': False}
list_quotes
List client quotes
Use this when someone asks about price quotes given to salon clients, such as which are pending, approved or rejected. Returns quotes with id, client and salon ids, status and date for all salons unless one is given, newest first, up to 100; the status filter applies within that page. Not for quote amounts or line items.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Maximum number of quotes to return (default 20, maximum 100)', 'exclusiveMinimum': 0}, 'status': {'enum': ['DRAFT', 'PENDING', 'REJECTED', 'APPROVED'], 'type': 'string', 'description': 'Only quotes with this status: DRAFT, PENDING, REJECTED or APPROVED. Applied within the fetched page of newest quotes'}, 'endTime': {'type': 'string', 'maxLength': 32, 'description': 'Only quotes ending before this ISO 8601 time'}, 'salonId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': "Only quotes from this salon, by an id from the user's salon list; every salon when absent"}, 'clientId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': 'Only quotes for this client, by an id from the client list'}, 'startTime': {'type': 'string', 'maxLength': 32, 'description': 'Only quotes starting at or after this ISO 8601 time'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['quotes', 'count', 'hasMore'], 'properties': {'count': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'quotes': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'clientId', 'salonId', 'status', 'startTime'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, 'status': {'anyOf': [{'enum': ['DRAFT', 'PENDING', 'REJECTED', 'APPROVED'], 'type': 'string'}, {'type': 'null'}]}, 'salonId': {'anyOf': [{'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, {'type': 'null'}]}, 'clientId': {'anyOf': [{'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, {'type': 'null'}]}, 'startTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Quotes, newest first. Free-text notes, quoted line details and amounts, discounts, contact details and organization data are excluded.'}, 'hasMore': {'type': 'boolean'}}, 'additionalProperties': False}
list_salons
List your salons
Use this when someone asks which hair salons they run in HairDora, or a salon's id is needed. Returns up to 100 salons with id, name, currency, default language and last edit time. Not for a salon's address, phone or opening hours.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['salons', 'count', 'hasMore'], 'properties': {'count': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'salons': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'currency', 'defaultLocale', 'lastEditTime'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, 'name': {'type': 'string', 'maxLength': 200}, 'currency': {'anyOf': [{'type': 'string', 'pattern': '^[A-Z]{3}$'}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'defaultLocale': {'anyOf': [{'type': 'string', 'maxLength': 16}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Salons in the signed-in organization. Contact, address, payment, organization and configuration fields are excluded.'}, 'hasMore': {'type': 'boolean', 'description': 'True when the organization has more than 100 salons'}}, 'additionalProperties': False}
list_services
Look up service prices
Use this when someone asks what their salon charges for a cut, colour, blow-dry or other service, or what services it offers. Returns services with id, name, price and salon for all their salons unless one is given, 50 by default and up to 100. Not for what a particular client had done.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Maximum number of services to return (default 50, maximum 100)', 'exclusiveMinimum': 0}, 'salonId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': "Only services of this salon, by an id from the user's salon list; every salon when absent"}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['services', 'count', 'hasMore'], 'properties': {'count': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'hasMore': {'type': 'boolean'}, 'services': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'price', 'salonId'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, 'name': {'type': 'string', 'maxLength': 200}, 'price': {'type': ['number', 'null'], 'description': "Price in the salon's currency"}, 'salonId': {'anyOf': [{'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Services the salon offers, with prices. Internal metadata and organization data are excluded.'}}, 'additionalProperties': False}
show_salon_overview
Show salon overview
Use this when someone wants a quick overview or dashboard of one hair salon. Returns an overview card with the salon's details, a client count, the next 8 upcoming appointments with time, status and number of services, and up to 12 services with prices (no client names or contact details). Not for one specific booking.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['salonId'], 'properties': {'salonId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': "Id of one of the user's salons, as the salon list returns it (24 lowercase hex characters)"}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['salon', 'clientCount', 'clientCountIsLowerBound', 'appointmentCount', 'appointmentCountIsLowerBound', 'serviceCount', 'serviceCountIsLowerBound', 'services', 'appointments'], 'properties': {'salon': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'currency', 'defaultLocale', 'timezone'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, 'name': {'type': 'string', 'maxLength': 200}, 'currency': {'anyOf': [{'type': 'string', 'pattern': '^[A-Z]{3}$'}, {'type': 'null'}]}, 'timezone': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultLocale': {'anyOf': [{'type': 'string', 'maxLength': 16}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'Salon metadata; null when not found. The overview excludes client names, contact details, client and appointment ids, notes, organization data, staff ids, payment data and service history.'}, 'services': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'price'], 'properties': {'name': {'type': 'string', 'maxLength': 200}, 'price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 12}, 'clientCount': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'appointments': {'type': 'array', 'items': {'type': 'object', 'required': ['startTime', 'status', 'serviceCount'], 'properties': {'status': {'anyOf': [{'enum': ['SCHEDULED', 'CLIENT_ARRIVED', 'NO_SHOW', 'CANCELED'], 'type': 'string'}, {'type': 'null'}]}, 'startTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'serviceCount': {'type': 'integer', 'maximum': 10000, 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 8, 'description': 'The next upcoming appointments, earliest first'}, 'serviceCount': {'type': 'integer', 'maximum': 12, 'minimum': 0}, 'appointmentCount': {'type': 'integer', 'maximum': 8, 'minimum': 0}, 'clientCountIsLowerBound': {'type': 'boolean'}, 'serviceCountIsLowerBound': {'type': 'boolean'}, 'appointmentCountIsLowerBound': {'type': 'boolean'}}, 'additionalProperties': False}
History
Recent tool changes
Changed
show_salon_overview
Sept. 29, 2026, 2:48 a.m.
Changed
list_quotes
Sept. 29, 2026, 2:48 a.m.
Changed
list_payments
Sept. 29, 2026, 2:48 a.m.
Changed
list_services
Sept. 29, 2026, 2:48 a.m.
Changed
list_calendar_events
Sept. 29, 2026, 2:48 a.m.
Changed
get_appointment
Sept. 29, 2026, 2:48 a.m.
Changed
list_appointments
Sept. 29, 2026, 2:48 a.m.
Changed
get_client
Sept. 29, 2026, 2:48 a.m.
Changed
list_clients
Sept. 29, 2026, 2:48 a.m.
Changed
list_providers
Sept. 29, 2026, 2:48 a.m.
Changed
get_salon_availability
Sept. 29, 2026, 2:48 a.m.
Changed
get_salon
Sept. 29, 2026, 2:48 a.m.
Changed
list_salons
Sept. 29, 2026, 2:48 a.m.
Added
show_salon_overview
Sept. 27, 2026, 2:40 a.m.
Added
list_quotes
Sept. 27, 2026, 2:40 a.m.
Added
list_payments
Sept. 27, 2026, 2:40 a.m.
Added
list_services
Sept. 27, 2026, 2:40 a.m.
Added
list_calendar_events
Sept. 27, 2026, 2:40 a.m.
Added
get_appointment
Sept. 27, 2026, 2:40 a.m.
Added
list_appointments
Sept. 27, 2026, 2:40 a.m.
Added
get_client
Sept. 27, 2026, 2:40 a.m.
Added
list_clients
Sept. 27, 2026, 2:40 a.m.
Added
list_providers
Sept. 27, 2026, 2:40 a.m.
Added
get_salon_availability
Sept. 27, 2026, 2:40 a.m.
Added
get_salon
Sept. 27, 2026, 2:40 a.m.
Added
list_salons
Sept. 27, 2026, 2:40 a.m.
Discover
Similar MCP servers
AdButler
com.adbutler/mcp-server
Manages AdButler advertisers, campaigns, ad items, audiences, zones, creatives, catalogs, and advertising reports.
Duvo MCP
io.github.duvoai/duvo
Provides governed retail and CPG operations for cases, queues, approvals, automations, process documentation, integrations, and a…
Lovie Company Formation
co.lovie/company-formation
Supports company formation and business administration with bank accounts, cards, invoicing, bookkeeping, accounting periods, and…
freedom-mcp
com.getfreedomos/freedom-mcp
Supports company operations through commitments, teams, agents, customer evidence, leads, content workflows, spreadsheets, commer…
独行录 / opcmenu
io.github.yzlee/opcmenu
Supports founder and company discovery, collaboration goals and tasks, events and signups, networking, messaging, profiles, produ…
Meta Council
com.meta-council/decision-intelligence
Provides governed workflows for consulting, outreach, sales deals, invoices, marketing campaigns, content approvals, accounting a…
synter-ads
io.github.Synter-Media-AI/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
synter-ads
io.github.jshorwitz/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…