See your salon's free slots, appointments, stylists, services, clients, quotes and payments.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
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.
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.
Id of one appointment, as the appointment list returns it (24 lowercase hex characters)
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.
| Argument | Type | Description |
|---|---|---|
| appointmentId* | string | Id of one appointment, as the appointment list returns it (24 lowercase hex characters) |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| clientId* | string | Id of one client, as the client list returns it (24 lowercase hex characters) |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| salonId* | string | Id of one of the user's salons, as the salon list returns it (24 lowercase hex characters) |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| salonId* | string | Id of one of the user's salons, as the salon list returns it (24 lowercase hex characters) |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of appointments to return (default 20, maximum 100) |
| endTime | string | Only appointments ending before this ISO 8601 time |
| salonId | string | Only appointments at this salon, by an id from the user's salon list; every salon when absent |
| clientId | string | Only appointments of this client, by an id from the client list |
| startTime | string | Only appointments starting at or after this ISO 8601 time |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of calendar events to return (default 20, maximum 100) |
| endTime | string | Only events ending before this ISO 8601 time |
| salonId | string | Only blocks for this salon, by an id from the user's salon list; every salon when absent |
| startTime | string | Only events starting at or after this ISO 8601 time |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of clients to return (default 20, maximum 100) |
| salonId | string | Only clients of this salon, by an id from the user's salon list; every salon when absent |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of payments to return (default 20, maximum 100) |
| endTime | string | Only payments ending before this ISO 8601 time |
| salonId | string | Only payments at this salon, by an id from the user's salon list; every salon when absent |
| clientId | string | Only payments from this client, by an id from the client list |
| startTime | string | Only payments starting at or after this ISO 8601 time |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| salonId* | string | Id of one of the user's salons, as the salon list returns it (24 lowercase hex characters) |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of quotes to return (default 20, maximum 100) |
| status | string | Only quotes with this status: DRAFT, PENDING, REJECTED or APPROVED. Applied within the fetched page of newest quotes |
| endTime | string | Only quotes ending before this ISO 8601 time |
| salonId | string | Only quotes from this salon, by an id from the user's salon list; every salon when absent |
| clientId | string | Only quotes for this client, by an id from the client list |
| startTime | string | Only quotes starting at or after this ISO 8601 time |
{
"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
}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.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of services to return (default 50, maximum 100) |
| salonId | string | Only services of this salon, by an id from the user's salon list; every salon when absent |
{
"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
}Use this when someone wants to open HairDora and browse their salons, upcoming appointment previews, service prices and booking availability in an interactive sidebar. Returns up to 100 salons to start from (no client names, contact details or private notes). Not for booking, cancelling or charging for appointments.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| salonId* | string | Id of one of the user's salons, as the salon list returns it (24 lowercase hex characters) |
{
"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)"
}
}
}