Salonist MCP server Let your AI agent run the Salonist front desk.

ToolWhat it doesAccess

• list_appointments Appointments for a day or range, by staff member. read

  Returns appointments with client, service, staff member, start time and status, in calendar order, online bookings included.

  MCP callsalonist_read → list_appointments

  REST endpointGET https://cotlet.dev/api/v1/salonist/appointments

  Parameters

  Parameters: list_appointments

  Name	Type	Description
  date_from string required	string	ISO date.
  date_to string	string	ISO date. Default: date_from.
  staff string	string	Staff member name.
  page integer	integer	Page number. Default: 1.

  Example input

  {
    "date_from": "date from"
  }

  Example response

  {
    "appointments": [
      {
        "appointment_id": "AP-55102",
        "client": "Fatima Al Mansoori",
        "service": "Hydrafacial",
        "staff": "Rania",
        "start": "2026-11-12T11:00",
        "status": "Confirmed"
      }
    ],
    "page": 1
  }

• find_free_slots Open times for a service, optionally with one staff member. read

  Reads the calendar, blocked time included, and returns start times where the service fits.

  MCP callsalonist_read → find_free_slots

  REST endpointGET https://cotlet.dev/api/v1/salonist/free-slots/find

  Parameters

  Parameters: find_free_slots

  Name	Type	Description
  service string required	string	Service name as in your menu.
  date string required	string	ISO date.
  staff string	string	Staff member name.

  Example input

  {
    "service": "service",
    "date": "date"
  }

  Example response

  {
    "service": "Gel manicure",
    "slots": [
      {
        "staff": "Joy",
        "start": "2026-11-13T15:00"
      },
      {
        "staff": "Rania",
        "start": "2026-11-13T17:30"
      }
    ]
  }

• book_appointment Books a service for a client with a staff member. writeasks first

  Creates the appointment on the calendar, the way New Booking does. Your Salonist notification settings decide whether the client gets a message. By default you confirm each call; you can switch that off for this tool.

  MCP callsalonist_write → book_appointment

  REST endpointPOST https://cotlet.dev/api/v1/salonist/clients/{client_id}/appointments

  Parameters

  Parameters: book_appointment

  Name	Type	Description
  client_id string required	string	Client ID from list_clients.
  service string required	string	Service name.
  staff string required	string	Staff member name.
  start string required	string	ISO date and time from find_free_slots.
  note string	string	Booking note.

  Example input

  {
    "client_id": "CL-8853",
    "service": "Gel manicure",
    "staff": "Joy",
    "start": "2026-11-13T15:00"
  }

  Example response

  {
    "appointment_id": "AP-55160",
    "client": "Layla Haddad",
    "service": "Gel manicure",
    "staff": "Joy",
    "start": "2026-11-13T15:00",
    "status": "Confirmed"
  }

• reschedule_appointment Moves an appointment to a new time or staff member. writeasks first

  Edits the appointment on the calendar. Your notification settings decide whether the client hears about it. By default you confirm each call; you can switch that off for this tool.

  MCP callsalonist_write → reschedule_appointment

  REST endpointPOST https://cotlet.dev/api/v1/salonist/appointments/{appointment_id}/reschedule

  Parameters

  Parameters: reschedule_appointment

  Name	Type	Description
  appointment_id string required	string	Appointment ID from list_appointments.
  start string required	string	New ISO date and time.
  staff string	string	New staff member. Default: unchanged.

  Example input

  {
    "appointment_id": "appointment_8c41d2",
    "start": "start"
  }

  Example response

  {
    "appointment_id": "AP-55102",
    "start": "2026-11-14T12:00",
    "staff": "Rania",
    "status": "Confirmed"
  }

• block_time Blocks time on a staff calendar. write

  Adds blocked time, for example a break or training, so no one books into it. Reaches no client, so it runs at once.

  MCP callsalonist_write → block_time

  REST endpointPOST https://cotlet.dev/api/v1/salonist/time/block

  Parameters

  Parameters: block_time

  Name	Type	Description
  staff string required	string	Staff member name.
  from string required	string	ISO date and time.
  to string required	string	ISO date and time.
  reason string	string	Reason shown on the calendar.

  Example input

  {
    "staff": "staff",
    "from": "from",
    "to": "to"
  }

  Example response

  {
    "staff": "Joy",
    "from": "2026-11-15T13:00",
    "to": "2026-11-15T14:00",
    "reason": "Training"
  }

ToolWhat it doesAccess

• list_clients Clients, searchable by name, phone or email. read

  Returns clients with ID, contact details, last visit and outstanding balance.

  MCP callsalonist_read → list_clients

  REST endpointGET https://cotlet.dev/api/v1/salonist/clients

  Parameters

  Parameters: list_clients

  Name	Type	Description
  query string	string	Name, phone or email.
  not_visited_days integer	integer	Only clients with no visit in this many days.
  with_outstanding boolean	boolean	Only clients who owe money.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "clients": [
      {
        "client_id": "CL-8841",
        "name": "Fatima Al Mansoori",
        "phone": "+971 50 555 0142",
        "last_visit": "2026-10-21",
        "outstanding": "0.00"
      }
    ],
    "page": 1
  }

• get_client One client with visits, packages and outstanding payments. read

  Returns the client record: contact details, notes, past services, active packages with sessions left, and what they owe.

  MCP callsalonist_read → get_client

  REST endpointGET https://cotlet.dev/api/v1/salonist/clients/{client_id}

  Parameters

  Parameters: get_client

  Name	Type	Description
  client_id string required	string	Client ID from list_clients.

  Example input

  {
    "client_id": "client_8c41d2"
  }

  Example response

  {
    "client_id": "CL-8841",
    "name": "Fatima Al Mansoori",
    "packages": [
      {
        "name": "Hydrafacial x6",
        "sessions_left": 3
      }
    ],
    "outstanding": "0.00",
    "history": [
      {
        "service": "Hydrafacial",
        "staff": "Rania",
        "date": "2026-10-21"
      }
    ]
  }

• create_client Adds a new client. write

  Creates the client record. Search list_clients first so a returning client does not become a duplicate. Reaches no one, so it runs at once.

  MCP callsalonist_write → create_client

  REST endpointPOST https://cotlet.dev/api/v1/salonist/clients

  Parameters

  Parameters: create_client

  Name	Type	Description
  name string required	string	Full name.
  phone string	string	Mobile number.
  email string	string	Email.

  Example input

  {
    "name": "Jane Doe"
  }

  Example response

  {
    "client_id": "CL-8907",
    "name": "Sara Khan",
    "phone": "+971 55 555 0199"
  }

ToolWhat it doesAccess

• create_bill Raises the bill for a completed appointment. writeasks first

  Generates the invoice for the services done, the way the calendar does after an appointment. Taking the payment stays with your front desk. By default you confirm each call; you can switch that off for this tool.

  MCP callsalonist_write → create_bill

  REST endpointPOST https://cotlet.dev/api/v1/salonist/appointments/{appointment_id}/bills

  Parameters

  Parameters: create_bill

  Name	Type	Description
  appointment_id string required	string	Appointment ID from list_appointments.
  products array	array	Retail products sold with the visit.

  Example input

  {
    "appointment_id": "appointment_8c41d2"
  }

  Example response

  {
    "bill_id": "B-30418",
    "client": "Fatima Al Mansoori",
    "total": "650.00",
    "currency": "AED",
    "status": "Unpaid"
  }

• assign_package Assigns a package to a client. writeasks first

  Adds the package from your package list to the client, ready to bill at the front desk. By default you confirm each call; you can switch that off for this tool.

  MCP callsalonist_write → assign_package

  REST endpointPOST https://cotlet.dev/api/v1/salonist/clients/{client_id}/package/assign

  Parameters

  Parameters: assign_package

  Name	Type	Description
  client_id string required	string	Client ID from list_clients.
  package string required	string	Package name as in your list.

  Example input

  {
    "client_id": "client_8c41d2",
    "package": "package"
  }

  Example response

  {
    "client_id": "CL-8907",
    "package": "Laser hair removal x8",
    "status": "Assigned"
  }

• list_services Your service menu with durations and prices. read

  Returns services by category with duration and price, so the agent books the exact service name.

  MCP callsalonist_read → list_services

  REST endpointGET https://cotlet.dev/api/v1/salonist/services

  Parameters

  Parameters: list_services

  Name	Type	Description
  category string	string	Service category.

  Example response

  {
    "services": [
      {
        "name": "Gel manicure",
        "category": "Nails",
        "duration_min": 45,
        "price": "120.00"
      }
    ]
  }