Local services & SaaS
Kitomba
Appointments, client cards and services in Kitomba 1 salon software.
9 endpoints
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.
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.
37 tools Read and write
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.
| What you need | SalonBridge API | By hand | Cotlet |
|---|---|---|---|
| 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
Once, in a Cloud Browser hosted for you.
Paste one address into its settings.
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
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.
Add the Cotlet address. Paste https://cotlet.dev/mcp/v1 into your agent as the MCP server or connector URL.
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.
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth 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/mcp.json
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
}
}
} # ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY" MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: view_payments_report 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.
Bookings in the Calendar, the client list, the messages SalonBridge sent and the forms clients filled in.
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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"client": "client",
"service": "service",
"staff": "staff",
"start": "start"
} {
"client": "Example Client",
"service": "Full highlights",
"staff": "Lerato",
"start": "2026-11-20T10:00",
"duration_minutes": 120,
"requested": true,
"booked": true
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"action": "action"
} {
"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"
}
]
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"file_url": "https://example.com",
"columns": "columns"
} {
"file": "clients.csv",
"imported": 1240,
"skipped": 0
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"messages": [
{
"client": "Example Client",
"type": "Appointment reminder",
"sent": "2026-11-19T10:00"
},
{
"client": "Sample Client",
"type": "Thank you",
"sent": "2026-11-18T17:30"
}
]
} 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
| Name | Type | Description |
|---|---|---|
| form string | string | Form name, to read all its responses. |
| client string | string | Client, to read only the responses on their profile. |
{
"form": "Laser consultation",
"responses": [
{
"client": "Example Client",
"submitted": "2026-11-18"
},
{
"client": "Unlinked response",
"submitted": "2026-11-17"
}
]
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"start_date": "start date",
"end_date": "end date"
} {
"clients": [
{
"client": "Example Client",
"visits": 9
},
{
"client": "Sample Client",
"visits": 7
}
]
} The client account at the till: retail added, payment and tip taken, invoice emailed. Expenses go on an expense account.
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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"client": "Example Client",
"amount": 177,
"method": "Credit Card",
"tip": 20,
"tip_for": "Lerato"
} {
"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
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"client": "client",
"items": "items"
} {
"client": "Example Client",
"items": [
{
"item": "Repair shampoo",
"staff": "Lerato",
"quantity": 1,
"amount": 32
}
],
"account_total": 177,
"saved": true
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"client": "client"
} {
"client": "Example Client",
"date": "2026-11-20",
"total": 177,
"paid": 177,
"sent": true
} 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
| Name | Type | Description |
|---|---|---|
| client string required | string | Client name or mobile number, as manage_clients returns it. |
| items array required | array | Services and products on the quote. |
{
"client": "client",
"items": "items"
} {
"client": "Sample Client",
"quote": "Q-EXAMPLE",
"items": [
"Bridal glow",
"Trial updo"
],
"saved": true
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"name": "Jane Doe",
"category": "category",
"vendor": "vendor",
"amount": 1,
"account": "account"
} {
"expense": "Towel laundry",
"category": "Cleaning",
"vendor": "Example Laundry",
"amount": 650,
"account": "Business account",
"saved": true
} Gift cards and treatment courses sold now and redeemed later, gift card designs, and points that add up per visit or spend.
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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"client": "client",
"value": 1,
"expiry_date": "expiry date"
} {
"client": "Example Client",
"recipient": "Sample Client",
"value": 500,
"expiry_date": "2027-11-30",
"code": "GC-EXAMPLE",
"notify_by": [
"email"
],
"saved": true
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"client": "client",
"code": "code",
"amount": 1
} {
"client": "Sample Client",
"code": "GC-EXAMPLE",
"amount": 280,
"remaining_balance": 220,
"paid": true
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"category": "category",
"type": "type",
"image_url": "https://example.com"
} {
"category": "Festive",
"type": "e_gift",
"saved": true
} 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
| Name | Type | Description |
|---|---|---|
| client string required | string | Client name or mobile number, as manage_clients returns it. |
| course string required | string | Course to sell. |
{
"client": "client",
"course": "course"
} {
"client": "Example Client",
"course": "6x Underarm laser",
"sessions": 6,
"saved": true
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"client": "client",
"course": "course",
"service": "service"
} {
"client": "Example Client",
"course": "6x Underarm laser",
"service": "Underarm laser",
"sessions_left": 4,
"redeemed": true
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"name": "Jane Doe",
"start_date": "start date",
"basis": "basis",
"reward_threshold": 1
} {
"programme": "Glow rewards",
"basis": "visit",
"reward_threshold": 10,
"start_date": "2026-12-01",
"saved": true
} Bulk SMS campaigns from tomorrow on, promo codes with limits, and classes with their own booking page.
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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"name": "Jane Doe",
"message": "message",
"send_at": "send at",
"audience": "audience"
} {
"campaign": "Quiet Tuesday",
"audience": "tag: Colour",
"send_at": "2026-11-24T09:00",
"saved": true
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"code": "code",
"redeemable_for": "redeemable for",
"discount": "discount",
"valid_from": "valid from",
"valid_until": "valid until",
"usage_limit": 20
} {
"code": "WINTER15",
"redeemable_for": "services",
"discount": {
"type": "percentage",
"amount": 15
},
"valid_until": "2027-07-31",
"usage_limit": 100,
"saved": true
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"type": "type",
"name": "Jane Doe",
"description": "description",
"price": 1,
"size": 1,
"staff": "staff",
"start": "start",
"duration_minutes": 1,
"location": "location"
} {
"type": "class",
"name": "Brow shaping masterclass",
"price": 450,
"size": 8,
"start": "2026-12-06T10:00",
"saved": true
} The price list, packages, who may do which service, working hours, commission, targets and treatment rooms.
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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"action": "action"
} {
"service": "Full manicure",
"category": "Nails",
"duration_minutes": 45,
"price": 280,
"show_online": true,
"saved": true
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"name": "Jane Doe",
"category": "category",
"services": "services"
} {
"package": "Bridal glow",
"services": [
"Express facial",
"Full manicure",
"Blow dry"
],
"total_price": 790,
"saved": true
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"action": "action"
} {
"staff": "Naledi",
"access": "Individual",
"service_commission": 35,
"retail_commission": 10,
"services": [
"Full manicure",
"Gel overlay"
],
"saved": true
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"staff": "staff",
"hours": "hours"
} {
"staff": "Lerato",
"hours": [
{
"day": "Saturday",
"working": true,
"start": "08:00",
"end": "14:00"
},
{
"day": "Monday",
"working": false
}
],
"saved": true
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"staff": "staff",
"structure": "structure",
"rates": "rates"
} {
"staff": "Lerato",
"structure": "tiered_percentage",
"rates": [
{
"from": 0,
"percent": 30
},
{
"from": 20000,
"percent": 35
}
],
"saved": true
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"target_for": "target for",
"target_type": "target type",
"start_date": "start date",
"end_date": "end date",
"amount": 1
} {
"target_for": "Naledi",
"target_type": "retail",
"start_date": "2026-12-01",
"end_date": "2026-12-31",
"amount": 6000,
"saved": true
} 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
| Name | Type | Description |
|---|---|---|
| name string required | string | Room name. |
| capacity number required | number | Maximum capacity. |
{
"name": "Jane Doe",
"capacity": 1
} {
"room": "Treatment room two",
"capacity": 1,
"saved": true
} Shelf products and back-bar stock, counts, deliveries, scheduled price rises and the colour used per client.
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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"action": "action"
} {
"products": [
{
"name": "Repair shampoo",
"category": "Example Supplier",
"inventory": 7,
"retail_price": 32
},
{
"name": "Shine serum",
"category": "Example Supplier",
"inventory": 2,
"retail_price": 48
}
]
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"action": "action"
} {
"item": "Lightener 500 g",
"inventory": 1500,
"unit": "g",
"cost_per_unit": 0.4,
"saved": true
} 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
| Name | Type | Description |
|---|---|---|
| counts array required | array | Product name or barcode with the quantity on hand. |
{
"counts": "counts"
} {
"counted": 42,
"changed": [
{
"item": "Shine serum",
"before": 4,
"after": 2
}
],
"saved": true
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"items": "items"
} {
"order_number": "INV-EXAMPLE",
"items": [
{
"item": "Repair shampoo",
"received": 12,
"on_hand": 19
}
],
"order_total": 1440,
"as_expense": true,
"saved": true
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"name": "Jane Doe",
"run_at": "run at"
} {
"update": "March price increase",
"run_at": "2027-03-01T06:00",
"blanket_percent": 6,
"saved": true
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"appointment": "appointment",
"service": "service",
"items": "items"
} {
"appointment": "Example Client, 20 Nov 10:00",
"service": "Full highlights",
"items": [
{
"item": "Lightener 500 g",
"amount": 60,
"unit": "g"
}
],
"saved": true
} My Business > Reports. Each report needs its permission on the staff login you signed in with.
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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"start_date": "start date",
"end_date": "end date"
} {
"start_date": "2026-11-09",
"end_date": "2026-11-15",
"services": 18450,
"retail": 2310,
"gratuity": 860,
"gift_cards": 1500
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"start_date": "start date",
"end_date": "end date"
} {
"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
}
]
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"start_date": "start date",
"end_date": "end date"
} {
"start_date": "2026-10-01",
"end_date": "2026-10-31",
"income": 84200,
"expenses": 31650,
"net_profit": 52550
} 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
| Name | Type | Description |
|---|---|---|
| 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. |
{
"start_date": "start date",
"end_date": "end date"
} {
"roster": [
{
"staff": "Lerato",
"date": "2026-11-21",
"hours": "08:00 to 14:00"
},
{
"staff": "Naledi",
"date": "2026-11-21",
"hours": "Off"
}
]
} Your signed-in SalonBridge browser profile, AES-256-GCM encrypted, in Finland. Never your password.
The 37 SalonBridge tools. The session cookie never leaves the Cloud Browser.
The calendar, clients, accounts and reports your staff access level and package open, nothing beyond.
Your login details, client notification and online booking settings, Yoco, Payfast and PayPal setup, and your subscription.
You sign in again yourself in the same Cloud Browser. The one-time PIN of two-factor sign-in stays on your phone.
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).
| Action | How to put it right |
|---|---|
| Client, service, staff or stock details | Call the same tool again with the earlier values |
| Payment recorded on the wrong account | Void or delete it in SalonBridge, as its help centre describes, then record it again |
| Invoice emailed or SMS campaign sent | Already with your client: speak to them before you change anything |
| Stock take entered with wrong counts | Run 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.
{
"name": "add_payment",
"arguments": {
"client": "Example Client",
"amount": 177,
"method": "Credit Card",
"tip": 20,
"tip_for": "Lerato"
}
} 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"}' {
"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.
About $27 a monthfor a salon with four stylists, 4,660 credits. Your SalonBridge package stays as it is.
| Job | Calls | Credits |
|---|---|---|
| Appointments booked from client messages | 1 × 60 | 600 |
| Payments taken and invoices emailed | 2 × 40 | 800 |
| Retail sales and gift cards | 2 × 20 | 400 |
| Course sales and session redemptions | 1 × 30 | 300 |
| Stock orders loaded and stock takes | 2 × 8 | 160 |
| Monday payments and sales reports | 2 × 4 | 80 |
| Month-end P&L and staff roster | 2 × 1 | 20 |
| Client and message lookups | 1 × 80 | 800 |
| Cloud Browser, 30 days | 1,500 | |
| Total | 316 calls | 4,660 |
The smallest pack, 5,000 credits for $29, covers this month. A busy December of gift card sales uses more calls.
Credit packs are one-time purchases, not a subscription. The month above comes from our own assumptions, not measured customer usage.
| 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.
| Option | What it does | Where it stops |
|---|---|---|
| SalonBridge API | REST 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 integration | Listed 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 hand | Open 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.
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.
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.
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.
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.
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.
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.
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.
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.
No. Cotlet is independent and not affiliated with SalonBridge.
Free 7-day trial with 2,000 credits, no card needed.
May we use Google Analytics to see which pages help people? It sets cookies only if you accept. No ads, and we never sell data. Cookie policy