Squire API and MCP server Let your AI agent run the chair schedule.

ToolWhat it doesAccess

• list_barbers List the barbers on your shop's team. read

  Returns each barber with id and name. Use the ids in the appointment tools. Reads the team as your signed-in account sees it in Commander.

  MCP callsquire_read → list_barbers

  REST endpointGET https://cotlet.dev/api/v1/squire/barbers

  Parameters

  No parameters.

  Example response

  {
    "barbers": [
      {
        "barber_id": "b_1042",
        "name": "Marcus Hill"
      },
      {
        "barber_id": "b_1043",
        "name": "Luis Ortega"
      },
      {
        "barber_id": "b_1044",
        "name": "Dev Patel"
      }
    ]
  }

• list_services List the services on your shop's service menu. read

  Returns each service with id, name, duration in minutes and price as shown in Squire, in menu order. Use the service ids when you book.

  MCP callsquire_read → list_services

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

  Parameters

  Parameters: list_services

  Name	Type	Description
  barber_id string	string	Only services this barber offers.

  Example response

  {
    "services": [
      {
        "service_id": "s_201",
        "name": "Haircut",
        "duration_minutes": 30,
        "price": 35
      },
      {
        "service_id": "s_202",
        "name": "Beard trim",
        "duration_minutes": 15,
        "price": 20
      }
    ]
  }

ToolWhat it doesAccess

• list_appointments List appointments for a day or a date range, optionally for one barber. read

  Returns appointments in time order with client name, barber, services, start and end. Follow next_cursor until it is null. Blocked time is listed with type blocked so you can tell it from a booking.

  MCP callsquire_read → list_appointments

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

  Parameters

  Parameters: list_appointments

  Name	Type	Description
  date_from string required	string	First day, YYYY-MM-DD.
  date_to string	string	Last day, YYYY-MM-DD. Defaults to date_from.
  barber_id string	string	Only this barber. Omit for the whole shop.
  cursor string	string	next_cursor from the previous page.

  Example input

  {
    "date_from": "date from"
  }

  Example response

  {
    "appointments": [
      {
        "appointment_id": "a_90011",
        "type": "booking",
        "start": "2026-10-29T10:00:00",
        "end": "2026-10-29T10:30:00",
        "barber": "Marcus Hill",
        "client": "Jon Reyes",
        "services": [
          "Haircut"
        ]
      },
      {
        "appointment_id": "a_90012",
        "type": "booking",
        "start": "2026-10-29T10:30:00",
        "end": "2026-10-29T11:15:00",
        "barber": "Marcus Hill",
        "client": "Sam Okafor",
        "services": [
          "Haircut",
          "Beard trim"
        ]
      }
    ],
    "next_cursor": null
  }

• create_appointment Book an appointment for a client with a barber. writeasks first

  Books the slot and returns the appointment. It fails with SLOT_TAKEN if the barber is booked or blocked then, and nothing is created. The client is a person who will show up, so it waits for your OK. Payments are not part of this call. By default you confirm each call; you can switch that off for this tool.

  MCP callsquire_write → create_appointment

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

  Parameters

  Parameters: create_appointment

  Name	Type	Description
  client_id string required	string	Client id from list_clients.
  barber_id string required	string	Barber id from list_barbers.
  service_ids array required	array	Service ids from list_services.
  start string required	string	Start time, YYYY-MM-DDTHH:MM:SS in the shop's time zone.

  Example input

  {
    "client_id": "client_8c41d2",
    "barber_id": "barber_8c41d2",
    "service_ids": "service ids",
    "start": "start"
  }

  Example response

  {
    "appointment_id": "a_90031",
    "status": "booked",
    "start": "2026-10-29T14:00:00",
    "end": "2026-10-29T14:30:00",
    "barber": "Dev Patel",
    "client": "Ana Lopez",
    "services": [
      "Haircut"
    ]
  }

• reschedule_appointment Move an appointment to a new time or another barber. writeasks first

  Moves the booking and returns it with the new times. It fails with SLOT_TAKEN when the new slot is not free, and the original stays. The client's plans change, so it waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callsquire_write → reschedule_appointment

  REST endpointPOST https://cotlet.dev/api/v1/squire/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 start time, YYYY-MM-DDTHH:MM:SS.
  barber_id string	string	New barber. Omit to keep the same one.

  Example input

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

  Example response

  {
    "appointment_id": "a_90011",
    "status": "booked",
    "start": "2026-10-29T11:30:00",
    "end": "2026-10-29T12:00:00",
    "barber": "Luis Ortega",
    "client": "Jon Reyes"
  }

• cancel_appointment Cancel a client's appointment. writeasks first

  Cancels the booking and returns its new status. It cancels someone's booking, so it waits for your OK. Cotlet takes no payment and issues no refund. By default you confirm each call; you can switch that off for this tool.

  MCP callsquire_write → cancel_appointment

  REST endpointPOST https://cotlet.dev/api/v1/squire/appointments/{appointment_id}/cancel

  Parameters

  Parameters: cancel_appointment

  Name	Type	Description
  appointment_id string required	string	Appointment id from list_appointments.
  reason string	string	Short note kept with the cancellation.

  Example input

  {
    "appointment_id": "appointment_8c41d2"
  }

  Example response

  {
    "appointment_id": "a_90012",
    "status": "cancelled",
    "client": "Sam Okafor",
    "start": "2026-10-29T10:30:00"
  }

ToolWhat it doesAccess

• block_time Block a barber's calendar for a time window. write

  Blocks the window so no one can book it and returns the block. It does not touch existing bookings: check list_appointments first. It reaches no client and is undone with remove_block, so it does not wait for your OK.

  MCP callsquire_write → block_time

  REST endpointPOST https://cotlet.dev/api/v1/squire/barbers/{barber_id}/time/block

  Parameters

  Parameters: block_time

  Name	Type	Description
  barber_id string required	string	Barber id from list_barbers.
  start string required	string	Start, YYYY-MM-DDTHH:MM:SS.
  end string required	string	End, YYYY-MM-DDTHH:MM:SS.

  Example input

  {
    "barber_id": "b_1044",
    "start": "2026-11-06T13:00:00",
    "end": "2026-11-06T17:00:00"
  }

  Example response

  {
    "block_id": "k_771",
    "barber": "Dev Patel",
    "start": "2026-11-06T13:00:00",
    "end": "2026-11-06T17:00:00"
  }

• remove_block Remove a blocked time window from a barber's calendar. write

  Reopens the window for booking. It reaches no client and the block can be set again with block_time, so it does not wait for your OK.

  MCP callsquire_write → remove_block

  REST endpointDELETE https://cotlet.dev/api/v1/squire/blocks/{block_id}

  Parameters

  Parameters: remove_block

  Name	Type	Description
  block_id string required	string	Block id from block_time or list_appointments.

  Example input

  {
    "block_id": "block_8c41d2"
  }

  Example response

  {
    "block_id": "k_771",
    "status": "removed"
  }

ToolWhat it doesAccess

• list_waitlist List clients on the shop's waitlist. read

  Returns each waiting client with the barber and the day they asked for, in the order Squire shows them. Squire notifies the waiting client itself when a slot opens. The waitlist needs a Squire plan that includes it; on others the call returns an empty list.

  MCP callsquire_read → list_waitlist

  REST endpointGET https://cotlet.dev/api/v1/squire/waitlists

  Parameters

  Parameters: list_waitlist

  Name	Type	Description
  barber_id string	string	Only clients waiting for this barber.

  Example response

  {
    "waitlist": [
      {
        "waitlist_id": "w_330",
        "client": "Ana Lopez",
        "barber": "Dev Patel",
        "date": "2026-10-29"
      }
    ]
  }

ToolWhat it doesAccess

• list_clients List or search your shop's clients. read

  Returns clients with id, name, phone, email and last visit date, as Squire shows them. Phone and email are personal data: the agent returns them only when you ask for them. Follow next_cursor until it is null.

  MCP callsquire_read → list_clients

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

  Parameters

  Parameters: list_clients

  Name	Type	Description
  query string	string	Name, phone or email to search for.
  cursor string	string	next_cursor from the previous page.

  Example response

  {
    "clients": [
      {
        "client_id": "c_5530",
        "name": "Jon Reyes",
        "phone": "+1 555 0100",
        "email": "jon@example.com",
        "last_visit": "2026-09-02"
      }
    ],
    "next_cursor": null
  }

• get_revenue_report Read revenue and client retention from the Reporting Dashboard for a date range. read

  Returns the totals Squire's reporting shows for the range: revenue and returning clients, and per barber when group_by is barber. Figures are in the shop's currency. It reads the report only and moves no money.

  MCP callsquire_read → get_revenue_report

  REST endpointGET https://cotlet.dev/api/v1/squire/revenue-report

  Parameters

  Parameters: get_revenue_report

  Name	Type	Description
  date_from string required	string	First day, YYYY-MM-DD.
  date_to string required	string	Last day, YYYY-MM-DD.
  group_by string	string	Split by barber. Omit for shop totals.

  Example input

  {
    "date_from": "date from",
    "date_to": "date to"
  }

  Example response

  {
    "range": {
      "from": "2026-10-19",
      "to": "2026-10-25"
    },
    "revenue": 6120,
    "returning_clients": 94,
    "by_barber": [
      {
        "barber": "Marcus Hill",
        "revenue": 2410
      },
      {
        "barber": "Luis Ortega",
        "revenue": 1840
      },
      {
        "barber": "Dev Patel",
        "revenue": 1870
      }
    ]
  }