SalonBridge API and MCP server Let your AI agent run the salon front desk.

SalonBridge keeps its API for a limited number of approved partners and has no MCP server (checked 16 Nov 2026). Cotlet runs a hosted SalonBridge MCP server with 37 tools that ChatGPT and Claude use in your own salon console. Every booking, payment and client message waits for your OK.

  • Free 7-day trial, no card
  • Unofficial, not affiliated with SalonBridge

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by SalonBridge. SalonBridge is a trademark of its owner. If SalonBridge's own integrations cover what you need, use them first.

SalonBridge Cloud Browser

37 tools Read and write

Salon and spa work

What can your AI agent do in SalonBridge? The front desk and the back office of a salon or spa, from booking to cash-up.

  • Book clients into the calendar from their messages

  • Take payments and email client invoices

  • Sell gift cards and treatment courses

  • Load stock orders and run stock takes

  • Schedule SMS campaigns and promo codes

  • Read takings, the P&L and the staff roster

Partner API, no MCP

Does SalonBridge have an MCP server or an API? The official SalonBridge routes, checked 16 November 2026.

SalonBridge publishes REST API documentation, but says it can integrate with only a limited number of partners: you need an integration secret from SalonBridge and an employee's go-ahead before you build. The documented resources cover appointments, clients, services, staff, gift cards, retail stock, orders, loyalty and payments. No SalonBridge MCP server and no official ChatGPT or Claude connector was found.

  • SalonBridge lists Zapier, Jotform and Mailchimp among its own integrations; its Zapier actions create clients, update clients and create retail sales.
  • Card payments run through Yoco Web POS at reception, and Yoco Online Payments, Payfast or PayPal online. SalonBridge records them; the provider moves the money.
  • An active SalonBridge account can generate an API token in the console, and the developer docs still ask for an integration secret from SalonBridge.
SalonBridge's own routes, working by hand and Cotlet compared
What you need SalonBridge APIBy handCotlet
Ask ChatGPT or Claude to do the work No MCP server found Copy and paste Hosted MCP server
Start today with your own login Integration secret from SalonBridge Your login Your login, once
Bookings, clients and payments Documented, for approved partners One account at a time 37 tools, writes after your OK
Stock takes, SMS campaigns, courses and reports Not in the documented resources One screen at a time Same tools, same key
Run from n8n or a script Approved partners only Manual only REST, same key

Checked 16 Nov 2026. Sources: SalonBridge API documentation · Help Centre: The SalonBridge API · SalonBridge integrations · SalonBridge pricing · Help Centre: Differences between the packages · Help Centre: Making your first appointment · Help Centre: How to add a payment · Help Centre: Email a client invoice · Help Centre: Redeem a course session · Help Centre: Load a retail stock order · Help Centre: Send a bulk SMS · Help Centre: Payments report

Set up once

How does the SalonBridge MCP server work? The SalonBridge MCP server by Cotlet: your agent works in your own SalonBridge console.

  1. 1Sign in to SalonBridge

    Once, in a Cloud Browser hosted for you.

  2. 2Connect your AI agent

    Paste one address into its settings.

  3. 3Hand over the front desk

    Bookings and payments wait for your OK.

Your agent works in your own signed-in Cloud Browser. Every write, and anything that reaches a client, waits for your OK. Who can see your session

Any MCP client

How to connect SalonBridge to your AI agent

  1. 1

    Sign in to SalonBridge in a Cloud Browser. Open online.mysalonbridge.com in your Cotlet Cloud Browser and sign in with your own staff email address and password.

  2. 2

    Add the Cotlet address. Paste https://cotlet.dev/mcp/v1 into your agent as the MCP server or connector URL.

  3. 3

    Let the agent in. Chat apps show a Cotlet sign-in page. Editors, n8n and scripts send an API key you create in the console.

SalonBridge shares the address https://cotlet.dev/mcp/v1 with every other app you turn on, so one connector covers them all. Turned SalonBridge on later? Refresh the connector and the 37 SalonBridge tools appear.

ChatGPT
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth
Claude
Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"
Cursor
// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}
Codex
# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
n8n
MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: view_payments_report
7 read, 30 write

All 37 SalonBridge MCP tools

One tool per owner workflow in the SalonBridge Help Centre. A few take an `action`: `list` and `get` only read, the other actions write and ask first.

Calendar and clients6

Bookings in the Calendar, the client list, the messages SalonBridge sent and the forms clients filled in.

  • book_appointments Book a client into the Calendar for a service, staff member and time. writeAsks first

    Opens a block in the Calendar and fills the new appointment window, then Book. SalonBridge sends the client a booking notification as your Client Notifications set it, and reminders need the client's email or mobile number. The help article shows booking only; moving or cancelling is not part of this tool. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → book_appointments

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/appointments

    Parameters

    Parameters: book_appointments
    NameTypeDescription
    client object required object Client name, email address and mobile number. A new client is added on its own.
    service string required string Service from your Services list.
    staff string required string Staff member whose column the booking goes in.
    start string required string ISO date and time.
    duration_minutes number number Overrides the duration from the service settings.
    requested boolean boolean Request Appointment: the client asked for this staff member. Adds the heart icon so reception does not move it.
    repeat string string Repeat frequency, if the client books the same appointment on a schedule.
    notes string string Appointment Notes, kept on this appointment only.

    Example input

    {
      "client": "client",
      "service": "service",
      "staff": "staff",
      "start": "start"
    }

    Example response

    {
      "client": "Example Client",
      "service": "Full highlights",
      "staff": "Lerato",
      "start": "2026-11-20T10:00",
      "duration_minutes": 120,
      "requested": true,
      "booked": true
    }
  • manage_clients List clients from View Clients or add one by hand. writeAsks first

    Clients > View Clients > + Add Client. Clients booked for the first time are added on their own, so the agent searches before it creates one. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → manage_clients

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/clients/manage

    Parameters

    Parameters: manage_clients
    NameTypeDescription
    action string required string One of `list`, `get`, `create`. `list` and `get` only read.
    search string string For `list` and `get`: a name or mobile number.
    fields object object For `create`: the client details in SalonBridge's labels, such as name, email address and mobile number.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "clients": [
        {
          "name": "Example Client",
          "mobile": "+27 82 555 0142",
          "email": "client@example.com"
        },
        {
          "name": "Sample Client",
          "mobile": "+27 83 555 0177",
          "email": "sample@example.com"
        }
      ]
    }
  • import_clients Import a client list from a CSV file, with columns matched to SalonBridge fields. writeAsks first

    Clients > View Clients > Client Options > Import Clients. At most 5000 records per import; a longer list is split into several imports. Without permission to add clients you cannot import either. The agent shows you the column matching first, because every row is added as it is. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → import_clients

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

    Parameters

    Parameters: import_clients
    NameTypeDescription
    file_url string required string Link the Cloud Browser can download the CSV from.
    columns object required object Which CSV column fills which SalonBridge client field.

    Example input

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

    Example response

    {
      "file": "clients.csv",
      "imported": 1240,
      "skipped": 0
    }
  • view_client_messages Read the notifications, reminders and thank you messages SalonBridge sent. read

    Clients > Client Messages for the latest messages, or Reports > Messaging Report > SMS Messages Sent for a date range. It changes nothing and runs without asking.

    MCP callsalonbridge_read → view_client_messages

    REST endpointGET https://cotlet.dev/api/v1/salonbridge/client-messages/view

    Parameters

    Parameters: view_client_messages
    NameTypeDescription
    search string string Client name or mobile number.
    start_date string string For the Messaging Report: ISO start date.
    end_date string string For the Messaging Report: ISO end date.

    Example response

    {
      "messages": [
        {
          "client": "Example Client",
          "type": "Appointment reminder",
          "sent": "2026-11-19T10:00"
        },
        {
          "client": "Sample Client",
          "type": "Thank you",
          "sent": "2026-11-18T17:30"
        }
      ]
    }
  • view_form_responses Read the responses to a form, or the responses linked to one client. read

    My Business > Forms > View Form Responses, or the Form Responses tab on the client. Responses from the link SalonBridge sends in a reminder are linked to the client; the general form link gives an Unlinked response. It changes nothing and runs without asking.

    MCP callsalonbridge_read → view_form_responses

    REST endpointGET https://cotlet.dev/api/v1/salonbridge/form-responses/view

    Parameters

    Parameters: view_form_responses
    NameTypeDescription
    form string string Form name, to read all its responses.
    client string string Client, to read only the responses on their profile.

    Example response

    {
      "form": "Laser consultation",
      "responses": [
        {
          "client": "Example Client",
          "submitted": "2026-11-18"
        },
        {
          "client": "Unlinked response",
          "submitted": "2026-11-17"
        }
      ]
    }
  • view_top_clients Read the clients with the most visits over a period. read

    My Business > Reports > Client Report > Total Visits. Needs the client total visits report permission. It changes nothing and runs without asking.

    MCP callsalonbridge_read → view_top_clients

    REST endpointGET https://cotlet.dev/api/v1/salonbridge/top-clients/view

    Parameters

    Parameters: view_top_clients
    NameTypeDescription
    start_date string required string ISO date, the first day of the report.
    end_date string required string ISO date, the last day of the report.
    format string string `on_screen`, `pdf` or `excel`. Default `on_screen`, returned as rows.

    Example input

    {
      "start_date": "start date",
      "end_date": "end date"
    }

    Example response

    {
      "clients": [
        {
          "client": "Example Client",
          "visits": 9
        },
        {
          "client": "Sample Client",
          "visits": 7
        }
      ]
    }

Accounts, payments and quotes5

The client account at the till: retail added, payment and tip taken, invoice emailed. Expenses go on an expense account.

  • add_payment Capture a payment with an optional tip on a client's account and close it. writeAsks first

    Opens the appointment with Go To Account, then Add Payment. The account lists the appointments, gift cards and retail on it; the payment is recorded and the account closes. Next visit opens a new account. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → add_payment

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/payments

    Parameters

    Parameters: add_payment
    NameTypeDescription
    client string required string Client name or mobile number, as manage_clients returns it.
    amount number required number Amount the client pays.
    method string required string Payment method, such as Cash or Credit Card.
    tip number number Tip amount, if any.
    tip_for string string Staff member the tip is for.

    Example input

    {
      "client": "Example Client",
      "amount": 177,
      "method": "Credit Card",
      "tip": 20,
      "tip_for": "Lerato"
    }

    Example response

    {
      "client": "Example Client",
      "items": [
        {
          "item": "Full highlights",
          "amount": 145
        },
        {
          "item": "Repair shampoo",
          "amount": 32
        }
      ],
      "amount": 177,
      "tip": 20,
      "tip_for": "Lerato",
      "method": "Credit Card",
      "total_paid": 197,
      "account_closed": true
    }
  • create_retail_sale Add retail products to a client's account, at an appointment or as a walk-in sale. writeAsks first

    Add / Delete Retail on the account, or New Retail Sale from the Calendar. The selling staff member counts for the sales and commission reports. Items go onto the client's open account if there is one; payment is add_payment. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → create_retail_sale

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/retail-sales

    Parameters

    Parameters: create_retail_sale
    NameTypeDescription
    client string required string Client name or mobile number, as manage_clients returns it.
    items array required array Each item with the selling staff member, quantity and discount if any.
    appointment string string Appointment to add the items to. Leave out for New Retail Sale.

    Example input

    {
      "client": "client",
      "items": "items"
    }

    Example response

    {
      "client": "Example Client",
      "items": [
        {
          "item": "Repair shampoo",
          "staff": "Lerato",
          "quantity": 1,
          "amount": 32
        }
      ],
      "account_total": 177,
      "saved": true
    }
  • email_invoice Email a client the invoice for an account, with a link to view and pay it. writeAsks first

    Accounts > the account > Email Client Invoice > Send Invoice. The client gets a message with a link to the invoice and, optionally, to pay what is owed. It reaches your client. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → email_invoice

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/invoice/email

    Parameters

    Parameters: email_invoice
    NameTypeDescription
    client string required string Client name or mobile number, as manage_clients returns it.
    date string string ISO date to send only what is owed for that day. Leave out for everything owed.

    Example input

    {
      "client": "client"
    }

    Example response

    {
      "client": "Example Client",
      "date": "2026-11-20",
      "total": 177,
      "paid": 177,
      "sent": true
    }
  • create_quote Create a quote for a client with the items you choose. writeAsks first

    Invoicing > Quotes > Create Quote. SalonBridge says quotes are for the client to review and accept; this tool only creates the quote, it does not send it. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → create_quote

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/quotes

    Parameters

    Parameters: create_quote
    NameTypeDescription
    client string required string Client name or mobile number, as manage_clients returns it.
    items array required array Services and products on the quote.

    Example input

    {
      "client": "client",
      "items": "items"
    }

    Example response

    {
      "client": "Sample Client",
      "quote": "Q-EXAMPLE",
      "items": [
        "Bridal glow",
        "Trial updo"
      ],
      "saved": true
    }
  • record_expense Record a business expense against one of your expense accounts. writeAsks first

    Expenses > + Add Expense. An expense account must exist first. The account is debited with the amount and the expense shows in your reports. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → record_expense

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/expenses

    Parameters

    Parameters: record_expense
    NameTypeDescription
    name string required string Expense name.
    category string required string Expense category.
    vendor string required string Who sold you the item.
    amount number required number Amount.
    account string required string Expense account the money came from.
    note string string Optional note.

    Example input

    {
      "name": "Jane Doe",
      "category": "category",
      "vendor": "vendor",
      "amount": 1,
      "account": "account"
    }

    Example response

    {
      "expense": "Towel laundry",
      "category": "Cleaning",
      "vendor": "Example Laundry",
      "amount": 650,
      "account": "Business account",
      "saved": true
    }

Gift cards, courses and loyalty6

Gift cards and treatment courses sold now and redeemed later, gift card designs, and points that add up per visit or spend.

  • create_gift_card Create a gift card for a client or another recipient and send it by SMS or email. writeAsks first

    Gift Cards > + New Gift Card > Create Gift Card. SalonBridge generates the code and opens the account, where the gift card is paid like any sale. With notifications ticked, the gift card reaches the recipient. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → create_gift_card

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/gift-cards

    Parameters

    Parameters: create_gift_card
    NameTypeDescription
    client string required string Client name or mobile number, as manage_clients returns it.
    value number required number Gift card value.
    expiry_date string required string ISO date.
    recipient object object Recipient name and contact details, when the recipient is someone else.
    notify_by array array `sms`, `email` or none, to keep it from going out.

    Example input

    {
      "client": "client",
      "value": 1,
      "expiry_date": "expiry date"
    }

    Example response

    {
      "client": "Example Client",
      "recipient": "Sample Client",
      "value": 500,
      "expiry_date": "2027-11-30",
      "code": "GC-EXAMPLE",
      "notify_by": [
        "email"
      ],
      "saved": true
    }
  • redeem_gift_card Pay for a client's account with a gift card code. writeAsks first

    Add Payment on the account with payment method Gift Card. SalonBridge lists matching gift cards with their remaining balance; the agent reads it back before it pays. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → redeem_gift_card

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/gift-card/redeem

    Parameters

    Parameters: redeem_gift_card
    NameTypeDescription
    client string required string Client name or mobile number, as manage_clients returns it.
    code string required string Gift card code, or pick from the cards found by client name.
    amount number required number Amount to take from the card.
    tip number number Tip, if any.

    Example input

    {
      "client": "client",
      "code": "code",
      "amount": 1
    }

    Example response

    {
      "client": "Sample Client",
      "code": "GC-EXAMPLE",
      "amount": 280,
      "remaining_balance": 220,
      "paid": true
    }
  • add_gift_card_template Add your own gift card design in a category, for print or e-Gift. writeAsks first

    Settings > General Settings > Gift Card Settings > + Add Gift Card Template. Print at home folds with your image on the front; e-Gift is one image sent by email. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → add_gift_card_template

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/gift-card-templates

    Parameters

    Parameters: add_gift_card_template
    NameTypeDescription
    category string required string Template category. A new name creates the category.
    type string required string `print_at_home` or `e_gift`.
    image_url string required string Link to the image the card uses.

    Example input

    {
      "category": "category",
      "type": "type",
      "image_url": "https://example.com"
    }

    Example response

    {
      "category": "Festive",
      "type": "e_gift",
      "saved": true
    }
  • sell_course Sell one of your courses to a client and open the account for payment. writeAsks first

    New Course Sale from the Calendar, Add Item, then Create Sale. It goes to the client's account, where add_payment takes the money. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → sell_course

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/course/sell

    Parameters

    Parameters: sell_course
    NameTypeDescription
    client string required string Client name or mobile number, as manage_clients returns it.
    course string required string Course to sell.

    Example input

    {
      "client": "client",
      "course": "course"
    }

    Example response

    {
      "client": "Example Client",
      "course": "6x Underarm laser",
      "sessions": 6,
      "saved": true
    }
  • redeem_course_session Pay for a booked treatment with one session of a client's course. writeAsks first

    Add Payment > Redeem Course Session on the account. Works only with sessions left and a course tied to that exact service: a "10x Blowdry (Short)" course does not pay for a Blowdry (Long). An appointment marked paid must be set back to confirmed first. The redemption shows in the payments report. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → redeem_course_session

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/course-session/redeem

    Parameters

    Parameters: redeem_course_session
    NameTypeDescription
    client string required string Client name or mobile number, as manage_clients returns it.
    course string required string The client's course to charge.
    service string required string The booked service the session pays for.

    Example input

    {
      "client": "client",
      "course": "course",
      "service": "service"
    }

    Example response

    {
      "client": "Example Client",
      "course": "6x Underarm laser",
      "service": "Underarm laser",
      "sessions_left": 4,
      "redeemed": true
    }
  • create_loyalty_programme Start a loyalty programme that issues points per visit or per amount spent. writeAsks first

    My Business > Loyalty > Create Loyalty Programme. A programme cannot be backdated. At the end of each day SalonBridge issues points: 1 per visiting client, or the amount spent. You are notified when a client reaches the threshold. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → create_loyalty_programme

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/loyalty-programmes

    Parameters

    Parameters: create_loyalty_programme
    NameTypeDescription
    name string required string Programme name.
    start_date string required string ISO date, today or later.
    basis string required string `visit` or `amount_spent` (treatments, retail or both).
    reward_threshold number required number Points or amount spent before a reward.

    Example input

    {
      "name": "Jane Doe",
      "start_date": "start date",
      "basis": "basis",
      "reward_threshold": 1
    }

    Example response

    {
      "programme": "Glow rewards",
      "basis": "visit",
      "reward_threshold": 10,
      "start_date": "2026-12-01",
      "saved": true
    }

Marketing and events3

Bulk SMS campaigns from tomorrow on, promo codes with limits, and classes with their own booking page.

  • schedule_sms_campaign Schedule a bulk SMS to a group of clients. writeAsks first

    My Business > Marketing > + Add SMS Campaign. Once saved, SalonBridge sends it on its own at that time, so the agent shows you the text and the audience first. It reaches your clients. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → schedule_sms_campaign

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/sms-campaign/schedule

    Parameters

    Parameters: schedule_sms_campaign
    NameTypeDescription
    name string required string Campaign name.
    message string required string SMS text, with your salon name and a way to reach you.
    send_at string required string ISO date and time, tomorrow at the earliest.
    audience string required string `all`, `male`, `female`, `upcoming_birthday` or a client tag.

    Example input

    {
      "name": "Jane Doe",
      "message": "message",
      "send_at": "send at",
      "audience": "audience"
    }

    Example response

    {
      "campaign": "Quiet Tuesday",
      "audience": "tag: Colour",
      "send_at": "2026-11-24T09:00",
      "saved": true
    }
  • create_promo_code Create a promo code with its discount, dates and usage limit. writeAsks first

    My Business > Promo Codes > Create promo code. Fixed amounts and 100% discounts work only for Services; Everything, Retail and Gift Cards take 0.01% to 99.99%. Staff permissions can hide the create button. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → create_promo_code

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/promo-codes

    Parameters

    Parameters: create_promo_code
    NameTypeDescription
    code string required string Up to 20 letters, numbers, hyphens or underscores, no spaces.
    redeemable_for string required string `everything`, `services`, `retail` or `gift_cards`.
    discount object required object Discount type and amount.
    valid_from string required string ISO date.
    valid_until string required string ISO date.
    usage_limit number required number Total times the code may be redeemed.

    Example input

    {
      "code": "code",
      "redeemable_for": "redeemable for",
      "discount": "discount",
      "valid_from": "valid from",
      "valid_until": "valid until",
      "usage_limit": 20
    }

    Example response

    {
      "code": "WINTER15",
      "redeemable_for": "services",
      "discount": {
        "type": "percentage",
        "amount": 15
      },
      "valid_until": "2027-07-31",
      "usage_limit": 100,
      "saved": true
    }
  • create_event_class Create an event or class with its own booking page. writeAsks first

    My Business > Events/Classes > + Add Event / Class. SalonBridge makes a web page where clients book; with Show Online on, anyone you share it with can book. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → create_event_class

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/event-class

    Parameters

    Parameters: create_event_class
    NameTypeDescription
    type string required string `event` or `class`.
    name string required string Name.
    description string required string What attendees can expect.
    price number required number Price.
    size number required number How many people can attend.
    staff string required string Hosting staff member.
    start string required string ISO date and time.
    duration_minutes number required number Duration.
    location object required object Online with link and password, or In Person with the address.
    image_url string string Image, ideally 1600x512 px.

    Example input

    {
      "type": "type",
      "name": "Jane Doe",
      "description": "description",
      "price": 1,
      "size": 1,
      "staff": "staff",
      "start": "start",
      "duration_minutes": 1,
      "location": "location"
    }

    Example response

    {
      "type": "class",
      "name": "Brow shaping masterclass",
      "price": 450,
      "size": 8,
      "start": "2026-12-06T10:00",
      "saved": true
    }

Services, staff and rooms7

The price list, packages, who may do which service, working hours, commission, targets and treatment rooms.

  • manage_services List your services or add one with its duration, price and staff. writeAsks first

    My Business > Services > + Add Service. The description shows to clients on online bookings; Transition Time stays hidden from them. Processing Time leaves a gap before the next service, for example between a root tint and a haircut. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → manage_services

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/services/manage

    Parameters

    Parameters: manage_services
    NameTypeDescription
    action string required string One of `list`, `create`. `list` and `get` only read.
    service object object For `create`: Service Name, Service Category, description, Service Duration, Service Cost Price and Service Price; optional Transition Time, Processing Time, default room or resource, Show Online and Assigned Staff.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "service": "Full manicure",
      "category": "Nails",
      "duration_minutes": 45,
      "price": 280,
      "show_online": true,
      "saved": true
    }
  • create_package Bundle existing services into a package with its own price. writeAsks first

    My Business > Services > Service Options > + Add Package. Only services that already exist can go in. Halving the total price gives each service a 50% discount. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → create_package

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/packages

    Parameters

    Parameters: create_package
    NameTypeDescription
    name string required string Package name.
    category string required string Service category.
    services array required array Services in the package, each with optional duration and processing time.
    total_price number number Package price. SalonBridge spreads the change over the services as a discount.
    description string string Optional description.

    Example input

    {
      "name": "Jane Doe",
      "category": "category",
      "services": "services"
    }

    Example response

    {
      "package": "Bridal glow",
      "services": [
        "Express facial",
        "Full manicure",
        "Blow dry"
      ],
      "total_price": 790,
      "saved": true
    }
  • manage_staff List staff or add a staff member with access level, commission and services. writeAsks first

    My Business > Staff > + Add Staff Member. Access is Individual, Receptionist or Administrator. The login email must be unique. The services you tick decide which staff a client can choose online. With Can Log in on, the new staff member is sent login details. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → manage_staff

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/staff/manage

    Parameters

    Parameters: manage_staff
    NameTypeDescription
    action string required string One of `list`, `get`, `create`. `list` and `get` only read.
    staff object object For `create`: first and last name, login email address, notification email address, mobile phone, service and retail commission, Access, View Client Contact Details, Can Log in and the services they may perform.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "staff": "Naledi",
      "access": "Individual",
      "service_commission": 35,
      "retail_commission": 10,
      "services": [
        "Full manicure",
        "Gel overlay"
      ],
      "saved": true
    }
  • set_staff_hours Set a staff member's working days and hours, in-house and for online bookings. writeAsks first

    My Business > Staff > the staff member > working hours, then Save. Unticking Working removes the day. Online clients see the new hours on the booking page. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → set_staff_hours

    REST endpointPUT https://cotlet.dev/api/v1/salonbridge/staff-hours

    Parameters

    Parameters: set_staff_hours
    NameTypeDescription
    staff string required string Staff member.
    hours array required array Per day: Working true or false, start and end time.
    online_hours array array Online Booking Hours per day, when they differ, for example weekdays only.

    Example input

    {
      "staff": "staff",
      "hours": "hours"
    }

    Example response

    {
      "staff": "Lerato",
      "hours": [
        {
          "day": "Saturday",
          "working": true,
          "start": "08:00",
          "end": "14:00"
        },
        {
          "day": "Monday",
          "working": false
        }
      ],
      "saved": true
    }
  • configure_commission Set a staff member's commission structure for services and retail. writeAsks first

    My Business > Staff > the staff member > Configure Commission, then Save. Tiers set up wrong make the commission report miscalculate, so the agent reads the tiers back to you first. Custom rates ignore tiers. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → configure_commission

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/commission/configure

    Parameters

    Parameters: configure_commission
    NameTypeDescription
    staff string required string Staff member.
    structure string required string `set_percentage`, `tiered_percentage` or `custom`.
    rates object required object One percentage, the tiers by revenue, or a percentage per service and retail item.

    Example input

    {
      "staff": "staff",
      "structure": "structure",
      "rates": "rates"
    }

    Example response

    {
      "staff": "Lerato",
      "structure": "tiered_percentage",
      "rates": [
        {
          "from": 0,
          "percent": 30
        },
        {
          "from": 20000,
          "percent": 35
        }
      ],
      "saved": true
    }
  • create_target Create a sales target for the business or one staff member. writeAsks first

    My Business > Targets > + Set New Target. All sales counts services performed, retail sold and courses sold. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → create_target

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/targets

    Parameters

    Parameters: create_target
    NameTypeDescription
    target_for string required string `business` or a staff member.
    target_type string required string `all_sales`, `services`, `retail` or `courses`.
    start_date string required string ISO date.
    end_date string required string ISO date.
    amount number required number Target amount.

    Example input

    {
      "target_for": "target for",
      "target_type": "target type",
      "start_date": "start date",
      "end_date": "end date",
      "amount": 1
    }

    Example response

    {
      "target_for": "Naledi",
      "target_type": "retail",
      "start_date": "2026-12-01",
      "end_date": "2026-12-31",
      "amount": 6000,
      "saved": true
    }
  • add_room Add a treatment room with its maximum capacity. writeAsks first

    My Business > Rooms & Resources > + Add Room. The capacity stops double booking: a booking into a full room shows a warning. The room appears in the new appointment window. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → add_room

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/rooms

    Parameters

    Parameters: add_room
    NameTypeDescription
    name string required string Room name.
    capacity number required number Maximum capacity.

    Example input

    {
      "name": "Jane Doe",
      "capacity": 1
    }

    Example response

    {
      "room": "Treatment room two",
      "capacity": 1,
      "saved": true
    }

Retail and professional stock6

Shelf products and back-bar stock, counts, deliveries, scheduled price rises and the colour used per client.

  • manage_retail_stock List retail products or add one with stock level and prices. writeAsks first

    My Business > Retail > + Add New Stock. A barcode lets a scanner add the product to a client's account. Show Online puts it in the online shop. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → manage_retail_stock

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/retail-stock/manage

    Parameters

    Parameters: manage_retail_stock
    NameTypeDescription
    action string required string One of `list`, `create`. `list` and `get` only read.
    product object object For `create`: Retail Stock Code, Barcode, name, category, description, Inventory Level, Cost Price and Retail Price (both with tax), Show Online.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "products": [
        {
          "name": "Repair shampoo",
          "category": "Example Supplier",
          "inventory": 7,
          "retail_price": 32
        },
        {
          "name": "Shine serum",
          "category": "Example Supplier",
          "inventory": 2,
          "retail_price": 48
        }
      ]
    }
  • manage_professional_stock List back-bar stock or add an item with its unit and cost price. writeAsks first

    My Business > Professional Stock > + Add Professional Stock. Given a total cost, SalonBridge works out the cost per unit. Service recipes deduct from this stock. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → manage_professional_stock

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/professional-stock/manage

    Parameters

    Parameters: manage_professional_stock
    NameTypeDescription
    action string required string One of `list`, `create`. `list` and `get` only read.
    item object object For `create`: Stock Code, name, category, Inventory Level with unit of measurement, and Cost Price per unit or in total.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "item": "Lightener 500 g",
      "inventory": 1500,
      "unit": "g",
      "cost_per_unit": 0.4,
      "saved": true
    }
  • record_stock_take Enter the counted quantity of each retail product and update stock levels. writeAsks first

    My Business > Retail > Retail Options > Perform Stock Take > Update Retail Stock. Levels are replaced with your counts; SalonBridge logs the old and new values with the staff member. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → record_stock_take

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/stock-takes

    Parameters

    Parameters: record_stock_take
    NameTypeDescription
    counts array required array Product name or barcode with the quantity on hand.

    Example input

    {
      "counts": "counts"
    }

    Example response

    {
      "counted": 42,
      "changed": [
        {
          "item": "Shine serum",
          "before": 4,
          "after": 2
        }
      ],
      "saved": true
    }
  • load_stock_order Add a supplier delivery to stock, optionally captured as an expense. writeAsks first

    My Business > Retail Stock > Retail Options > Load Stock Order > Load Order. Quantities add to what is on hand: 4 plus 3 received makes 7. The Stock Orders Report lists loaded orders. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → load_stock_order

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/stock-order/load

    Parameters

    Parameters: load_stock_order
    NameTypeDescription
    items array required array Products with the quantity received.
    order_number string string Order or invoice number.
    order_total number number Order or invoice total.
    as_expense boolean boolean True to capture the invoice as a business expense too.

    Example input

    {
      "items": "items"
    }

    Example response

    {
      "order_number": "INV-EXAMPLE",
      "items": [
        {
          "item": "Repair shampoo",
          "received": 12,
          "on_hand": 19
        }
      ],
      "order_total": 1440,
      "as_expense": true,
      "saved": true
    }
  • schedule_price_update Schedule new retail cost and selling prices for a future date and time. writeAsks first

    My Business > Retail Stock > Retail Options > Schedule Price Update. Items you leave out keep their prices. Updates for the same time run in the order created, so the agent avoids putting one item in two of them. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → schedule_price_update

    REST endpointPOST https://cotlet.dev/api/v1/salonbridge/price-update/schedule

    Parameters

    Parameters: schedule_price_update
    NameTypeDescription
    name string required string Update name.
    run_at string required string ISO date and time it runs.
    items array array Items with new cost price, selling price and whether they stay in use.
    blanket_percent number number Raise all cost and selling prices by this percentage instead.

    Example input

    {
      "name": "Jane Doe",
      "run_at": "run at"
    }

    Example response

    {
      "update": "March price increase",
      "run_at": "2027-03-01T06:00",
      "blanket_percent": 6,
      "saved": true
    }
  • set_service_recipe Record the professional stock used on one appointment's service. writeAsks first

    The recipe icon next to the service on the appointment, then Save Recipe. It shows only when professional stock is loaded. Stock is deducted at the end of the business day. By default you confirm each call; you can switch that off for this tool.

    MCP callsalonbridge_write → set_service_recipe

    REST endpointPUT https://cotlet.dev/api/v1/salonbridge/service-recipe

    Parameters

    Parameters: set_service_recipe
    NameTypeDescription
    appointment string required string Appointment, by client and time.
    service string required string Service on that appointment.
    items array required array Professional stock items with the amount used.

    Example input

    {
      "appointment": "appointment",
      "service": "service",
      "items": "items"
    }

    Example response

    {
      "appointment": "Example Client, 20 Nov 10:00",
      "service": "Full highlights",
      "items": [
        {
          "item": "Lightener 500 g",
          "amount": 60,
          "unit": "g"
        }
      ],
      "saved": true
    }

Reports4

My Business > Reports. Each report needs its permission on the staff login you signed in with.

  • view_sales_report Read services, retail, gratuity and gift card sales by date for a period. read

    My Business > Reports > Sales / Revenue Report, Standard. Needs the sales and revenue report permission. It changes nothing and runs without asking.

    MCP callsalonbridge_read → view_sales_report

    REST endpointGET https://cotlet.dev/api/v1/salonbridge/sales-reports/view

    Parameters

    Parameters: view_sales_report
    NameTypeDescription
    start_date string required string ISO date, the first day of the report.
    end_date string required string ISO date, the last day of the report.
    format string string `on_screen`, `pdf` or `excel`. Default `on_screen`, returned as rows.

    Example input

    {
      "start_date": "start date",
      "end_date": "end date"
    }

    Example response

    {
      "start_date": "2026-11-09",
      "end_date": "2026-11-15",
      "services": 18450,
      "retail": 2310,
      "gratuity": 860,
      "gift_cards": 1500
    }
  • view_payments_report Read payments for a period, grouped by payment type with subtotals. read

    My Business > Reports > Payments Report: Cash, Credit Card, Gift Card and the other types. Usually the report for your accountant. Needs the payments report permission. It changes nothing and runs without asking.

    MCP callsalonbridge_read → view_payments_report

    REST endpointGET https://cotlet.dev/api/v1/salonbridge/payments-reports/view

    Parameters

    Parameters: view_payments_report
    NameTypeDescription
    start_date string required string ISO date, the first day of the report.
    end_date string required string ISO date, the last day of the report.
    format string string `on_screen`, `pdf` or `excel`. Default `on_screen`, returned as rows.

    Example input

    {
      "start_date": "start date",
      "end_date": "end date"
    }

    Example response

    {
      "start_date": "2026-11-09",
      "end_date": "2026-11-15",
      "by_type": [
        {
          "type": "Credit Card",
          "payments": 61,
          "subtotal": 4860
        },
        {
          "type": "Cash",
          "payments": 17,
          "subtotal": 1240
        },
        {
          "type": "Gift Card",
          "payments": 3,
          "subtotal": 380
        }
      ]
    }
  • view_profit_and_loss Read total income, total expenses and net profit for a period. read

    My Business > Reports > Profit and Loss Report. On screen it adds a graph of income and expenses over the period. It changes nothing and runs without asking.

    MCP callsalonbridge_read → view_profit_and_loss

    REST endpointGET https://cotlet.dev/api/v1/salonbridge/profit-and-loss/view

    Parameters

    Parameters: view_profit_and_loss
    NameTypeDescription
    start_date string required string ISO date, the first day of the report.
    end_date string required string ISO date, the last day of the report.
    format string string `on_screen`, `pdf` or `excel`. Default `on_screen`, returned as rows.

    Example input

    {
      "start_date": "start date",
      "end_date": "end date"
    }

    Example response

    {
      "start_date": "2026-10-01",
      "end_date": "2026-10-31",
      "income": 84200,
      "expenses": 31650,
      "net_profit": 52550
    }
  • view_staff_roster Read who works when over a date range, with close outs and breaks. read

    My Business > Reports > Staff Report > Working Roster. Core hours, booked leave (close outs) and scheduling; days off show as Off. It changes nothing and runs without asking.

    MCP callsalonbridge_read → view_staff_roster

    REST endpointGET https://cotlet.dev/api/v1/salonbridge/staff-rosters/view

    Parameters

    Parameters: view_staff_roster
    NameTypeDescription
    start_date string required string ISO date, the first day of the report.
    end_date string required string ISO date, the last day of the report.
    format string string `on_screen`, `pdf` or `excel`. Default `on_screen`, returned as rows.

    Example input

    {
      "start_date": "start date",
      "end_date": "end date"
    }

    Example response

    {
      "roster": [
        {
          "staff": "Lerato",
          "date": "2026-11-21",
          "hours": "08:00 to 14:00"
        },
        {
          "staff": "Naledi",
          "date": "2026-11-21",
          "hours": "Off"
        }
      ]
    }
Encrypted, revocable

Who can see my SalonBridge session, and how do I revoke it?

  • What we store

    Your signed-in SalonBridge browser profile, AES-256-GCM encrypted, in Finland. Never your password.

  • What your agent gets

    The 37 SalonBridge tools. The session cookie never leaves the Cloud Browser.

  • What the session sees

    The calendar, clients, accounts and reports your staff access level and package open, nothing beyond.

  • What no tool touches

    Your login details, client notification and online booking settings, Yoco, Payfast and PayPal setup, and your subscription.

  • If SalonBridge signs you out

    You sign in again yourself in the same Cloud Browser. The one-time PIN of two-factor sign-in stays on your phone.

  • How to cut access

    Turn SalonBridge off for agents, reset the browser, or change your SalonBridge password.

Cotlet never sees or stores your password: you type it into SalonBridge yourself, and the agent works only in the session that sign-in creates. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).

30 tools ask first

Approvals, undo and mistakes Nothing reaches a client, and no money is recorded, until you say so.

  1. 01 Add the retail item create_retail_sale puts the shampoo on the open account.
  2. 02 Show the total $177 and the $20 tip, shown to you first.
  3. 03 Record after your OK add_payment takes it and closes the account.
  4. 04 Email when you say email_invoice is a separate call.
Putting a SalonBridge write right
ActionHow to put it right
Client, service, staff or stock detailsCall the same tool again with the earlier values
Payment recorded on the wrong accountVoid or delete it in SalonBridge, as its help centre describes, then record it again
Invoice emailed or SMS campaign sentAlready with your client: speak to them before you change anything
Stock take entered with wrong countsRun a new stock take; SalonBridge logs the old and new values

All 30 write tools ask first: by default you confirm each call, and you can switch that off per tool. The 7 read tools (reports, client messages, form responses and top clients) run straight away.

MCP call
{
  "name": "add_payment",
  "arguments": {
    "client": "Example Client",
    "amount": 177,
    "method": "Credit Card",
    "tip": 20,
    "tip_for": "Lerato"
  }
}
REST
curl -X POST https://cotlet.dev/api/v1/salonbridge/payments \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"client":"Example Client","amount":177,"method":"Credit Card","tip":20,"tip_for":"Lerato"}'
Response
{
  "client": "Example Client",
  "items": [
    {
      "item": "Full highlights",
      "amount": 145
    },
    {
      "item": "Repair shampoo",
      "amount": 32
    }
  ],
  "amount": 177,
  "tip": 20,
  "tip_for": "Lerato",
  "method": "Credit Card",
  "total_paid": 197,
  "account_closed": true
}

The example records $145 for full highlights and $32 for the Repair shampoo, $177, with a $20 tip for Lerato: $197 by Credit Card, and the account closes. No invoice goes to the client until email_invoice runs. A cron job or n8n flow makes the same call over REST at /api/v1/salonbridge with the same key and price. Failed calls are free.

Pay per call

How much does the SalonBridge MCP server cost?

About $27 a monthfor a salon with four stylists, 4,660 credits. Your SalonBridge package stays as it is.

Illustrative month, our assumption: successful calls for this workload
JobCallsCredits
Appointments booked from client messages1 × 60600
Payments taken and invoices emailed2 × 40800
Retail sales and gift cards2 × 20400
Course sales and session redemptions1 × 30300
Stock orders loaded and stock takes2 × 8160
Monday payments and sales reports2 × 480
Month-end P&L and staff roster2 × 120
Client and message lookups1 × 80800
Cloud Browser, 30 days1,500
Total316 calls4,660

The smallest pack, 5,000 credits for $29, covers this month. A busy December of gift card sales uses more calls.

  • Free 7-day trial, no card
  • 10 credits per successful call, MCP or REST
  • 50 credits a day for the Cloud Browser
  • Your SalonBridge package and staff access apply as they are

Credit packs are one-time purchases, not a subscription. The month above comes from our own assumptions, not measured customer usage.

Cotlet credit packs: price, credits and calls at 10 credits each
Credits Price, one time Calls at 10 credits Per 1,000 credits
5,000 $29 500 $5.80
15,000 $79 1,500 $5.27
32,000 $149 3,200 $4.66
60,000 $249 6,000 $4.15

Only successful calls use credits; failed calls and timeouts cost nothing. At a balance of 0 calls pause, never a surprise charge. Authenticate with the Authorization: Bearer header.

Other options

SalonBridge MCP server: other ways to connect What each route does for a salon or spa, and where it stops.

Other ways to work with SalonBridge, checked 16 Nov 2026
OptionWhat it doesWhere it stops
SalonBridge APIREST resources for appointments, clients, gift cards, retail stock, orders, loyalty and payments.An integration secret from SalonBridge, for a limited number of partners; no report or stock take resources.
Zapier integrationListed by SalonBridge: triggers for new appointments, payments and clients; actions that create or update clients and create retail sales.Recipes you set up in Zapier, not an agent working in the console. Not on the Starter package.
By handOpen each appointment, account and report in the console.One screen at a time, only while someone is at the desk.

If SalonBridge's own Zapier integration already covers your job, use it: it is the vendor's route. Cotlet fits when you want ChatGPT, Claude or a script working the SalonBridge console today, from your own login, with nothing to host.

EU company, since 2019

Who runs Cotlet A company you can look up.

Cotlet is built by Take Group sp. z o.o., registered in Poland, EU (VAT PL6342984273) and in business since 2019, with founders Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the SalonBridge tools go to contact@cotlet.dev.

SalonBridge MCP server: questions

How do I get access?

Sign up free at https://cotlet.dev/signup?app=salonbridge, turn on SalonBridge under Integrations in the console and sign in at https://online.mysalonbridge.com in your Cloud Browser. Then connect your AI agent and ask it about today's calendar or last week's takings. The trial needs no card.

Does SalonBridge have an API?

SalonBridge publishes REST API documentation at developers.mysalonbridge.com, but says it can integrate with only a limited number of partners: an integration secret from SalonBridge and an employee's go-ahead come first (checked 16 Nov 2026). The documented resources are appointments, close outs, services, staff, clients, gift cards, retail stock, orders, loyalty, accounts and payments. No SalonBridge MCP server and no official ChatGPT or Claude connector was found. Cotlet does not use that API: it works in your own signed-in SalonBridge console.

Which SalonBridge package do the tools need?

SalonBridge says its Starter package leaves out quotes, courses, room and resource management, expenses, events and classes, electronic forms, loyalty and marketing; Basic, Standard and Premium have all features. The tools follow your package: what Starter does not include, they cannot do there.

Why can a report tool fail for one staff login and work for another?

SalonBridge reports need a permission per staff member, such as the sales and revenue report permission or the payments report permission. An Administrator can run all reports; a Receptionist runs cash up reports. Sign in with a login that has the reports you want.

When does an SMS campaign go out, and what does it use?

Tomorrow at the earliest, at the time you set; SalonBridge sends it on its own. It uses your SMS credits: Basic includes 150 free SMSs a month, Standard 300 and Premium 500, and credits you top up roll over.

Which SalonBridge login should I sign in with?

The staff login whose work the agent should do, usually the owner's Administrator login. The agent sees only what that access level, its report permissions and your package allow.

Is the MCP server different from the REST API?

Only in how it is called. Both carry the same 37 tools, inputs, answers, API key and price. Agents use MCP; scripts and n8n HTTP steps use REST.

Is Cotlet affiliated with SalonBridge?

No. Cotlet is independent and not affiliated with SalonBridge.

Hand tomorrow's front desk work to your agent.

Free 7-day trial with 2,000 credits, no card needed.