StyleSeat API and MCP server Let your AI agent keep your chair booked and paid.

ToolWhat it doesAccess

• view_calendar Read your StyleSeat calendar for a day, three days or a week. read

  Returns the appointments in that range with client, service, time and price. StyleSeat keeps the same calendar in its app and on its website. Nothing changes, so it runs without asking.

  MCP callstyleseat_read → view_calendar

  REST endpointGET https://cotlet.dev/api/v1/styleseat/calendars/view

  Parameters

  Parameters: view_calendar

  Name	Type	Description
  view string	string	`day`, `3_days` or `week`. Defaults to `day`.
  date string	string	ISO date the view starts on. Defaults to today.

  Example response

  {
    "view": "day",
    "date": "2026-11-18",
    "appointments": [
      {
        "time": "09:30",
        "client": "Example Client A",
        "service": "Silk press",
        "price": 95
      },
      {
        "time": "13:00",
        "client": "Example Client B",
        "service": "Knotless braids",
        "price": 220
      }
    ]
  }

• set_availability Read or change your working hours and time off in Calendar settings. writeAsks first

  These settings sit under When clients can book in Calendar settings and decide which times clients can book online, so every change waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callstyleseat_write → set_availability

  REST endpointPUT https://cotlet.dev/api/v1/styleseat/availability

  Parameters

  Parameters: set_availability

  Name	Type	Description
  action string required	string	One of `get`, `set_hours`, `add_time_off`. `get` only read.
  hours object	object	For `set_hours`: start and end per weekday, for example { "tue": ["09:00", "17:00"] }.
  from string	string	For `add_time_off`: ISO date or date and time.
  to string	string	For `add_time_off`: ISO date or date and time.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "working_hours": {
      "tue": [
        "09:00",
        "17:00"
      ],
      "wed": [
        "09:00",
        "17:00"
      ]
    },
    "time_off": [
      {
        "from": "2026-12-24",
        "to": "2026-12-26"
      }
    ],
    "saved": true
  }

• manage_appointments Book an appointment for a client, cancel one, or move it to another time. writeAsks first

  StyleSeat recommends that clients book themselves; this is the professional's own booking and cancelling from the calendar. A booking made without a card on file cannot be charged on StyleSeat later. Cancelling inside 24 hours asks whether to waive or charge the late fee, which the agent never decides for you. By default you confirm each call; you can switch that off for this tool.

  MCP callstyleseat_write → manage_appointments

  REST endpointPOST https://cotlet.dev/api/v1/styleseat/appointments/manage

  Parameters

  Parameters: manage_appointments

  Name	Type	Description
  action string required	string	One of `book`, `cancel`, `reschedule`. All three write.
  appointment string	string	For `cancel` and `reschedule`: the appointment, by client and date.
  client string	string	For `book`: client name.
  service string	string	For `book`: a service on your menu.
  start string	string	For `book` and `reschedule`: ISO date and time.
  late_fee string	string	For `cancel` within 24 hours under your no-show and late cancellation policy: `waive` or `charge`.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "action": "reschedule",
    "client": "Example Client B",
    "service": "Knotless braids",
    "from": "2026-11-18T13:00",
    "to": "2026-11-19T10:00",
    "saved": true
  }

ToolWhat it doesAccess

• checkout_appointment Check out a finished appointment with the client's card on file or a recorded payment. writeAsks first

  Card payments run through StyleSeat's Stripe processing; StyleSeat lists 2.6% + $0.30 per card-on-file transaction. Payments must be set up with a linked bank account. The agent repeats the client, total and method before it charges. By default you confirm each call; you can switch that off for this tool.

  MCP callstyleseat_write → checkout_appointment

  REST endpointPOST https://cotlet.dev/api/v1/styleseat/appointment/checkout

  Parameters

  Parameters: checkout_appointment

  Name	Type	Description
  appointment string required	string	The appointment, by client and date, as view_calendar returns it.
  method string required	string	`card_on_file`, `check`, `gift_card` or `cash_or_other`. Tap to Pay and the card reader need your phone and stay there.
  tip number	number	Optional tip amount.

  Example input

  {
    "appointment": "appointment",
    "method": "method"
  }

  Example response

  {
    "client": "Example Client A",
    "service": "Silk press",
    "amount": 95,
    "tip": 15,
    "method": "card_on_file",
    "checked_out": true
  }

• refund_appointment Refund an appointment, a no-show or late-cancellation fee, in full or in part. writeAsks first

  Works up to 14 days after the appointment's start time. Partial refunds, including only the tip, need the Premium plan; no-show and late-cancellation fees and appointments with a deposit refund only in full. The client gets a confirmation, so every refund waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callstyleseat_write → refund_appointment

  REST endpointPOST https://cotlet.dev/api/v1/styleseat/appointment/refund

  Parameters

  Parameters: refund_appointment

  Name	Type	Description
  appointment string required	string	The appointment, by client and date, as view_calendar returns it.
  reason string required	string	One of the reasons StyleSeat offers on the Refund screen.
  amount number	number	Optional part amount, Premium plan only. Leave empty to refund in full.

  Example input

  {
    "appointment": "Example Client C, 2026-11-10",
    "reason": "Service issue"
  }

  Example response

  {
    "client": "Example Client C",
    "service": "Lash fill",
    "refunded": 65,
    "kind": "full",
    "client_notified": true
  }

• respond_to_chargeback List open disputes or submit your evidence for one before its deadline. writeAsks first

  Disputes sit under Earnings, Transactions, Disputes. A missed deadline loses the case, so `list` returns each deadline first. The agent submits only evidence you hand it or name, and shows the package before it goes to the bank. By default you confirm each call; you can switch that off for this tool.

  MCP callstyleseat_write → respond_to_chargeback

  REST endpointPOST https://cotlet.dev/api/v1/styleseat/chargeback/replies

  Parameters

  Parameters: respond_to_chargeback

  Name	Type	Description
  action string required	string	One of `list`, `respond`. `list` only read.
  dispute string	string	For `respond`: the dispute, by client and amount.
  evidence array	array	For `respond`: what to submit, such as the message history, the appointment record and your cancellation policy, as files or text you give the agent.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "disputes": [
      {
        "client": "Example Client D",
        "amount": 120,
        "deadline": "2026-11-25",
        "status": "needs_response"
      }
    ]
  }

• view_payouts Read your StyleSeat payouts and when each one is due in your bank. read

  Reads Earnings, Payouts. StyleSeat pays out Monday to Friday; appointments checked out before 3:30 PM PST usually arrive in 1 to 2 business days, later ones in 2 to 3. Refunds and chargebacks can lower a payout. It changes nothing and does not start an Instant Payout.

  MCP callstyleseat_read → view_payouts

  REST endpointGET https://cotlet.dev/api/v1/styleseat/payouts/view

  Parameters

  Parameters: view_payouts

  Name	Type	Description
  from string	string	ISO date. Defaults to 30 days ago.
  to string	string	ISO date. Defaults to today.

  Example response

  {
    "payouts": [
      {
        "date": "2026-11-17",
        "amount": 410,
        "method": "Next-Day",
        "status": "paid"
      },
      {
        "date": "2026-11-18",
        "amount": 235,
        "method": "Next-Day",
        "status": "pending"
      }
    ]
  }

ToolWhat it doesAccess

• set_deposits Read or change whether clients pay a deposit when they book. writeAsks first

  Deposits need the Premium plan and payments on. They are charged at booking, count toward the service total and carry over when an appointment is rescheduled. Clients see the change on your booking page, so it waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callstyleseat_write → set_deposits

  REST endpointPUT https://cotlet.dev/api/v1/styleseat/deposits

  Parameters

  Parameters: set_deposits

  Name	Type	Description
  action string required	string	One of `get`, `set`. `get` only read.
  enabled boolean	boolean	For `set`: turn deposits on or off.
  amount string	string	For `set`: the deposit, as StyleSeat's deposit settings take it.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "deposits": true,
    "amount": "25%",
    "saved": true
  }

• configure_smart_pricing Read or change Smart Pricing, which raises prices on your high-demand time slots. writeAsks first

  Under More, Payments and Policies, Smart Pricing. It needs payments on. Clients see the higher price labeled as a high-demand time before they book, so a change waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callstyleseat_write → configure_smart_pricing

  REST endpointPOST https://cotlet.dev/api/v1/styleseat/smart-pricing/configure

  Parameters

  Parameters: configure_smart_pricing

  Name	Type	Description
  action string required	string	One of `get`, `set`. `get` only read.
  enabled boolean	boolean	For `set`: on or off.
  max_increase_percent number	number	For `set`: the most a slot can rise, up to 50.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "smart_pricing": true,
    "max_increase_percent": 30,
    "saved": true
  }

• manage_service_packages List, create, edit or delete packages of prepaid visits for one service. writeAsks first

  Packages need the Premium plan, payments on and $1,000 processed through StyleSeat. StyleSeat names the package itself. Packages clients already bought stay valid after an edit. By default you confirm each call; you can switch that off for this tool.

  MCP callstyleseat_write → manage_service_packages

  REST endpointPOST https://cotlet.dev/api/v1/styleseat/service-packages/manage

  Parameters

  Parameters: manage_service_packages

  Name	Type	Description
  action string required	string	One of `list`, `create`, `update`, `delete`. `list` only read.
  service string	string	The one existing service the package is for.
  visits number	number	Number of visits, 2 to 20.
  discount_percent number	number	Discount, up to 50.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "service": "Silk press",
    "visits": 5,
    "discount_percent": 20,
    "name": "Silk press, 5 visits",
    "saved": true
  }

ToolWhat it doesAccess

• edit_business_info Read or change your business name, address, phone, mobile setting, professions and specialties. writeAsks first

  Under Menu, Business and Profile, Business Info. Changes show on your profile at once. If you are connected to a salon, the address is locked to it. You need at least one profession. By default you confirm each call; you can switch that off for this tool.

  MCP callstyleseat_write → edit_business_info

  REST endpointPATCH https://cotlet.dev/api/v1/styleseat/business-info

  Parameters

  Parameters: edit_business_info

  Name	Type	Description
  action string required	string	One of `get`, `update`. `get` only read.
  fields object	object	For `update`: name, address, phone, mobile_business (true or false), professions, specialties.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "name": "Example Hair Studio",
    "address": "100 Example St, Atlanta",
    "phone": "+1 555 0100",
    "mobile_business": false,
    "professions": [
      "Hair Stylist"
    ],
    "specialties": [
      "Silk press",
      "Braids"
    ]
  }

• manage_reviews Read your reviews, post a public response or pin your best one. writeAsks first

  Only clients with a checked-out appointment can review you. A response is public on your profile, and a pinned review shows under About Me, so both wait for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callstyleseat_write → manage_reviews

  REST endpointPOST https://cotlet.dev/api/v1/styleseat/reviews/manage

  Parameters

  Parameters: manage_reviews

  Name	Type	Description
  action string required	string	One of `list`, `respond`, `pin`. `list` only read.
  review string	string	For `respond` and `pin`: the review, by client and date.
  response string	string	For `respond`: your public reply.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "reviews": [
      {
        "client": "Example Client A",
        "stars": 5,
        "date": "2026-11-12",
        "responded": false
      }
    ]
  }

• get_booking_links Read your booking link, salon link, custom website link and per-service links. read

  Reads Marketing, Tools, Booking links. Share Your Website is your own booking link, the one to send clients. Nothing changes.

  MCP callstyleseat_read → get_booking_links

  REST endpointGET https://cotlet.dev/api/v1/styleseat/booking-links

  Parameters

  Parameters: get_booking_links

  Name	Type	Description
  service string	string	Optional: return only the link for this service.

  Example response

  {
    "your_website": "https://booking.example.com/examplestudio",
    "service_links": [
      {
        "service": "Silk press",
        "url": "https://booking.example.com/examplestudio/silk-press"
      }
    ]
  }

ToolWhat it doesAccess

• list_clients_due_back List clients who are Due, Late, Overdue or Inactive, most overdue first. read

  StyleSeat sorts clients by how long since their last visit against how often your type of service is booked, and updates the groups once a day. Clients with an upcoming appointment never appear. Read only; send_campaign messages the group.

  MCP callstyleseat_read → list_clients_due_back

  REST endpointGET https://cotlet.dev/api/v1/styleseat/clients-due-backs

  Parameters

  Parameters: list_clients_due_back

  Name	Type	Description
  group string required	string	`due`, `late`, `overdue` or `inactive`.

  Example input

  {
    "group": "group"
  }

  Example response

  {
    "group": "late",
    "clients": [
      {
        "name": "Example Client E",
        "last_visit": "2026-08-30"
      },
      {
        "name": "Example Client F",
        "last_visit": "2026-09-06"
      }
    ],
    "count": 14
  }

• send_campaign Create and send an email or text campaign to a group of your clients. writeAsks first

  Under Menu, Marketing Suite. Sending needs payments connected; an open dispute, a negative balance or a failed subscription payment pauses it. The agent reads the audience and message back to you before Send Now. By default you confirm each call; you can switch that off for this tool.

  MCP callstyleseat_write → send_campaign

  REST endpointPOST https://cotlet.dev/api/v1/styleseat/campaigns

  Parameters

  Parameters: send_campaign

  Name	Type	Description
  channel string required	string	`email` or `text`.
  audience string required	string	`all`, `booked`, `never_booked`, `booked_last_4_weeks`, `booked_last_8_weeks`, `booked_last_12_weeks`, `booked_last_18_weeks`, `due`, `late`, `overdue` or `inactive`.
  subject string	string	For email: subject line.
  message string required	string	The campaign text. A Book Now button can be added.

  Example input

  {
    "channel": "channel",
    "audience": "audience",
    "message": "message"
  }

  Example response

  {
    "channel": "text",
    "audience": "late",
    "recipients": 14,
    "sent": true
  }

• import_clients Import clients from a .csv or .xlsx file. writeAsks first

  StyleSeat skips anyone already in your list, matched on phone, then email, then full name, and shows who it skips before Import. The agent returns that preview first and imports after your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callstyleseat_write → import_clients

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

  Parameters

  Parameters: import_clients

  Name	Type	Description
  file_url string required	string	A link the Cloud Browser can download the file from. Up to 5,000 clients and 20 MB.
  columns object	object	Optional column matches: first_name, last_name, phone, email, birthday, notes. Only a first name is required.

  Example input

  {
    "file_url": "https://example.com"
  }

  Example response

  {
    "imported": 212,
    "already_in_clients": 9,
    "unreadable_rows": 2
  }

• delete_clients Delete up to 100 clients at a time, such as duplicates or contacts who never booked. writeAsks first

  Deleting is permanent and cannot be undone. StyleSeat skips clients with an upcoming or unpaid appointment or a pending charge. Past appointments and payments stay in your history. The agent lists every client before it deletes. By default you confirm each call; you can switch that off for this tool.

  MCP callstyleseat_write → delete_clients

  REST endpointDELETE https://cotlet.dev/api/v1/styleseat/clients

  Parameters

  Parameters: delete_clients

  Name	Type	Description
  clients array	array	Client names to delete, up to 100.
  filter string	string	Or a StyleSeat filter to select from: `never_booked` or `duplicates`.

  Example response

  {
    "deleted": 23,
    "skipped": [
      {
        "name": "Example Client G",
        "reason": "upcoming appointment"
      }
    ]
  }

• view_client_photos Read the photos a client shared for an appointment: look today, inspiration and result. read

  Clients can share a look today photo, up to 4 inspiration photos and a result photo. You see only photos from appointments with you, and they cannot be edited or deleted. Read only.

  MCP callstyleseat_read → view_client_photos

  REST endpointGET https://cotlet.dev/api/v1/styleseat/client-photos/view

  Parameters

  Parameters: view_client_photos

  Name	Type	Description
  client string required	string	Client name.
  appointment string	string	Optional: one appointment, by date.

  Example input

  {
    "client": "client"
  }

  Example response

  {
    "client": "Example Client B",
    "appointment": "2026-11-19",
    "photos": [
      {
        "kind": "look_today"
      },
      {
        "kind": "inspiration"
      },
      {
        "kind": "inspiration"
      }
    ]
  }