# BookingKoala by Cotlet (remote · cotlet.dev)

Bookings, providers and customers in your BookingKoala store.

- Trust score: 69/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-24

## Components

- remote · `cotlet.dev`: 69/100 (this document), [markdown](https://verifymcp.io/servers/dev-cotlet-bookingkoala/mcp-v1-bookingkoala.md), [page](https://verifymcp.io/servers/dev-cotlet-bookingkoala/mcp-v1-bookingkoala)
- remote · `cotlet.dev`: 40/100, [markdown](https://verifymcp.io/servers/dev-cotlet-bookingkoala/mcp-v1-bookingkoala-connect.md), [page](https://verifymcp.io/servers/dev-cotlet-bookingkoala/mcp-v1-bookingkoala-connect)
- pypi · `bookingkoala-api-mcp`: 64/100, [markdown](https://verifymcp.io/servers/dev-cotlet-bookingkoala/bookingkoala-api-mcp.md), [page](https://verifymcp.io/servers/dev-cotlet-bookingkoala/bookingkoala-api-mcp)

## Channel facts

- Endpoint: `https://cotlet.dev/mcp/v1/bookingkoala`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.2`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-24.

- **Endpoint Security**: 66/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (cotlet_browser_click).
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 80/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 5332 tokens (~148/item across 36 items; 35 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability check failed: schema churn in the 1 day we've observed: 3 tool removals, 0 breaking changes, 0 auth/transport breaks, 0 additions.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 3 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 37 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the BookingKoala by Cotlet MCP server?

BookingKoala by Cotlet is a hosted endpoint at https://cotlet.dev/mcp/v1/bookingkoala, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http dev-cotlet-bookingkoala 'https://cotlet.dev/mcp/v1/bookingkoala'
```

### Cursor

```json
{
  "mcpServers": {
    "dev-cotlet-bookingkoala": {
      "url": "https://cotlet.dev/mcp/v1/bookingkoala"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "dev-cotlet-bookingkoala": {
      "type": "http",
      "url": "https://cotlet.dev/mcp/v1/bookingkoala"
    }
  }
}
```

### Codex

```toml
[mcp_servers.dev-cotlet-bookingkoala]
url = "https://cotlet.dev/mcp/v1/bookingkoala"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dev-cotlet-bookingkoala": {
      "type": "remote",
      "url": "https://cotlet.dev/mcp/v1/bookingkoala",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add dev-cotlet-bookingkoala --url 'https://cotlet.dev/mcp/v1/bookingkoala' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  dev-cotlet-bookingkoala:
    url: "https://cotlet.dev/mcp/v1/bookingkoala"
```

### Netclaw

```json
{
  "McpServers": {
    "dev-cotlet-bookingkoala": {
      "Transport": "http",
      "Url": "https://cotlet.dev/mcp/v1/bookingkoala"
    }
  }
}
```

### Vellum

```bash
assistant mcp add dev-cotlet-bookingkoala -t streamable-http -u 'https://cotlet.dev/mcp/v1/bookingkoala'
```

### Other

```json
{
  "mcpServers": {
    "dev-cotlet-bookingkoala": {
      "type": "http",
      "url": "https://cotlet.dev/mcp/v1/bookingkoala"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-24 (score 69, 0)

- [security regression] Stability: unverified → fail
- [security regression] A breaking change shipped without a version bump: still 0.1.0
- [security regression] Tool “cotlet_balance” was removed
- [security regression] Tool “cotlet_browser_connect” was removed
- [security regression] Tool “cotlet_browser_sessions” was removed
- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “assign_provider” rewrote its description, which is the text the model reads
- [security] Tool “cancel_booking” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_click” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_navigate” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_close” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_open” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_press” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_read” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_screenshot” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_scroll” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_select” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_type” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_upload” rewrote its description, which is the text the model reads
- [security] Tool “create_booking” rewrote its description, which is the text the model reads
- [security] Tool “create_customer” rewrote its description, which is the text the model reads
- [security] Tool “dashboard” rewrote its description, which is the text the model reads
- [security] Tool “get_booking” rewrote its description, which is the text the model reads
- [security] Tool “get_customer” rewrote its description, which is the text the model reads
- [security] Tool “get_provider” rewrote its description, which is the text the model reads
- [security] Tool “list_bookings” rewrote its description, which is the text the model reads
- [security] Tool “list_charges” rewrote its description, which is the text the model reads
- [security] Tool “list_customers” rewrote its description, which is the text the model reads
- [security] Tool “list_drafts” rewrote its description, which is the text the model reads
- [security] Tool “list_invoices” rewrote its description, which is the text the model reads
- [security] Tool “list_providers” rewrote its description, which is the text the model reads
- [security] Tool “refund_charge” rewrote its description, which is the text the model reads
- [security] Tool “reschedule_booking” rewrote its description, which is the text the model reads
- [security] Tool “resend_invoice” rewrote its description, which is the text the model reads
- [security] Tool “send_quote” rewrote its description, which is the text the model reads
- [functional regression] Schema quality: 107 → 148
- [functional improvement] Stability: unverified → 0.03

### 2026-10-23 (score 69)

First indexed and scored.

## MCP tools (35)

### `cotlet_whoami` (~63 tokens)

Cotlet: who am I

The Cotlet account this connection acts as: email, workspace, access status, the API key or OAuth client in use with its scope, the apps the workspace may call and its credit balance. Free. Needs the user's Cotlet API key or sign-in.

### `cotlet_apps` (~89 tokens)

Cotlet: apps I can use

The apps of the user's workspace and whether each works now: access granted or requested, the app account in the user's Cloud Browser (connected, signed out, not enabled for agents), and the one step the user has to take, with the console link. Free. Needs the user's Cotlet API key or sign-in.

Input parameters:

- `app` (string): Only this app, e.g. skool.

### `cotlet_request_apps` (~102 tokens)

Cotlet: request access to apps

Requests access to apps for the user's workspace, as Request access in the console: a live app is granted at once, any other goes to the Cotlet team, who answer within 72 hours. Takes app slugs as listed at https://cotlet.dev/api/v1/apps. Free. Needs the user's Cotlet API key or sign-in.

Input parameters:

- `apps` (array, required): App slugs, e.g. ["skool", "substack"].

### `cotlet_get_call` (~76 tokens)

Cotlet: check a call

Status of an earlier Cotlet call, by its call_id: pending (waits for the owner's approval in the Cotlet console), approved, running, success, rejected, expired, blocked or failed. For a call that answered with status pending or running.

Input parameters:

- `call_id` (string, required): call_id from the earlier call

### `cotlet_upload_file` (~115 tokens)

Cotlet: upload a file for a tool

Returns a one-time upload_url and a file_id for a local file (an image for a post, an attachment). The file is sent to upload_url with an HTTP PUT; an argument that takes a file accepts {"file_id": "..."}. Up to 25 MB, the URL works once. Free. Needs the user's Cotlet API key or sign-in.

Input parameters:

- `content_type` (string): MIME type, e.g. image/jpeg.
- `name` (string): File name, e.g. photo.jpg.

### `cotlet_report_issue` (~276 tokens)

Cotlet: report a bug or a missing feature

Sends a report straight to the Cotlet team: a tool that failed or returned wrong data, an error you could not get past, or a tool, field or app the task needed and Cotlet lacks. The report carries the error text and call_id when there is one, never passwords or tokens. Needs the user's Cotlet API key or sign-in.

Input parameters:

- `app`: App slug the report is about, e.g. 'skool'.
- `call_id`: call_id of the call that went wrong, if any.
- `client`: Agent or tool sending this, e.g. 'Claude Code'.
- `description` (string, required): What you tried, what you expected and what happened, with the error text if there was one. No passwords, tokens or other secrets.
- `kind` (string, required): bug: a tool did the wrong thing or returned wrong data. error: a call failed or returned an error you could not get past. feature_request: something new the user wants. missing_feature: an app is her…
- `title` (string, required): One line, e.g. 'skool_list_members stops after 50 members'.
- `tool`: Tool or endpoint name, e.g. 'skool_list_members'.

### `cotlet_browser_open` (~131 tokens)

Open the browser

Wakes the user's BookingKoala Cloud Browser, a real Chrome hosted on Cotlet and signed in to BookingKoala as the user. Use it for what the BookingKoala tools do not cover. Opens `url` when given and returns the page's URL and title. The user watches every step live. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

Input parameters:

- `url` (string): A public http or https address, e.g. https://example.com. In an app's browser, a page of that app.

### `cotlet_browser_navigate` (~101 tokens)

Go to a page

Opens a public http or https address in the user's BookingKoala Cloud Browser and returns the URL and title it ended on. Only BookingKoala pages open. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

Input parameters:

- `url` (string, required): A public http or https address, e.g. https://example.com. In an app's browser, a page of that app.

### `cotlet_browser_read` (~99 tokens)

Read the page

Returns the current page of the user's BookingKoala Cloud Browser: its readable text, up to 20,000 characters, and a numbered list of its links, buttons and fields. Field values, cookies and storage are never returned. On a page longer than that, both start near where it is scrolled to. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

### `cotlet_browser_screenshot` (~77 tokens)

See the page

Returns a JPEG image of the visible part of the current page in the user's BookingKoala Cloud Browser, with its URL and title: boards, canvases and layouts that the page text does not show. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

### `cotlet_browser_scroll` (~177 tokens)

Scroll the page

Scrolls the current page in the user's BookingKoala Cloud Browser with the mouse wheel, as a person does: down or up by `screens` viewport heights (default 0.8), to the top or the bottom, or until element `element` is in view. Content that loads on scroll appears, and the next read lists it. Returns the URL, title and scroll position (at_top, at_bottom). Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

Input parameters:

- `direction` (string): Where to scroll. Default: down.
- `element` (integer): Scroll until this element of the element list is in view.
- `screens` (number): How far, in viewport heights, for down and up. Default: 0.8.

### `cotlet_browser_click` (~121 tokens)

Click on the page

Clicks a link, button or other element of the current page in the user's BookingKoala Cloud Browser, by its number in the page's element list, and returns the URL and title after the click. It acts as the user on that site. Buttons that pay or buy and buttons on account or sign-in pages are refused. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

Input parameters:

- `element` (integer, required): The element's number in the element list of the current page.

### `cotlet_browser_type` (~150 tokens)

Type on the page

Types text into a field of the current page in the user's BookingKoala Cloud Browser, by the field's number in the page's element list, and with `submit` presses Enter. Returns the URL and title after it. Password, card and one-time code fields and sign-in pages are refused: the user fills those in themselves. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

Input parameters:

- `element` (integer, required): The element's number in the element list of the current page.
- `submit` (boolean): Press Enter after typing, e.g. to search.
- `text` (string, required): The text to type.

### `cotlet_browser_select` (~124 tokens)

Choose from a list

Chooses an option of a drop-down list on the current page in the user's BookingKoala Cloud Browser, by the list's number in the element list and the option's label as read lists it (or its value). Returns the URL and title after it. Card fields and account pages are refused. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

Input parameters:

- `element` (integer, required): The element's number in the element list of the current page.
- `option` (string, required): The option.

### `cotlet_browser_press` (~110 tokens)

Press a key

Presses one key on the current page in the user's BookingKoala Cloud Browser, on the element that has focus: Tab to the next field, Enter to send, Escape to close a dialog or pop-up, arrows to move through a suggestion list. Returns the URL and title after it. Enter on account pages is refused. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

Input parameters:

- `key` (string, required): The key.

### `cotlet_browser_upload` (~153 tokens)

Upload a file

Puts files into a file field of the current page in the user's BookingKoala Cloud Browser, or into the file picker that an upload button opens, by its number in the element list. A file is given as {"url": "https://..."} for a file online or {"file_id": "..."} for one uploaded to Cotlet first; up to 10 files, 20 MB each. Returns the URL and title after it. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

Input parameters:

- `element` (integer, required): The element's number in the element list of the current page.
- `files` (array, required): The files.

### `cotlet_browser_close` (~46 tokens)

Close the browser

Ends the session in the user's BookingKoala Cloud Browser: the browser keeps its cookies, goes to sleep and the per-minute charge stops. Returns the session's minutes and credits.

### `dashboard` (~128 tokens)

Dashboard

Store totals for a date range: revenue, provider pay, bookings, ratings, referrals. Returns the figures of the admin Dashboard for the dates given (this month by default): revenue paid and pending, split into bookings, custom invoices and separate charges; what providers earned and what is still unpaid; booking counts, unassigned and cancelled included; ratings and referrals. Amounts are in the store's currency.

Input parameters:

- `end_date` (string): YYYY-MM-DD, included. Default: last day of this month.
- `start_date` (string): YYYY-MM-DD. Default: first day of this month.

### `get_booking` (~87 tokens)

Get booking

One booking with its price breakdown, provider pay, notes and service. Reads a booking by id: date and arrival window, customer, address, assigned providers, the service parameters and extras, notes, the price breakdown (service total, discounts, tax, tip, final amount) and what the providers are paid for it.

Input parameters:

- `booking_id` (integer, required): Booking id from list_bookings.

### `get_customer` (~109 tokens)

Get customer

One customer: contact details, addresses, booking counts and bookings not charged yet. Returns the customer's profile as their page in the admin shows it: name, email, phone, saved addresses (address_id is what a booking or invoice for this customer uses), counts of upcoming and cash bookings, the bookings not charged yet (past ones included), gift cards received and the referral summary. Times of day are in the store's time zone.

Input parameters:

- `customer_id` (integer, required): customer_id from list_customers.

### `get_provider` (~139 tokens)

Get provider

One provider or team: contact, category, team members, reviews and payment logs. Returns the provider's profile as their page in the admin shows it: contact details, IC or W2 category, priority, scheduling permissions, the team's members and lead (for a team) or the teams it belongs to, customer reviews and the newest payment logs (what the store paid the provider). Payment logs come as BookingKoala records them.

Input parameters:

- `payment_logs_limit` (integer): Newest payment logs to include, 1 to 50. Default: 20.
- `provider_id` (integer, required): provider_id from list_providers (a team too).

### `list_bookings` (~214 tokens)

List bookings

Bookings of the store: upcoming, unassigned, completed, charge pending or declined. Lists bookings as the Bookings page shows them, newest schedule dates first within the filter, with the customer, address, assigned providers, total and whether it is charged. Filter by status, date range, a search on the customer, or one customer or provider. Cancelled bookings are not listed. Page with next_cursor.

Input parameters:

- `cursor` (string): next_cursor from the previous call.
- `customer_id` (integer): Only this customer's bookings.
- `end_date` (string): Up to this date.
- `limit` (integer): Page size. Default: 20.
- `provider_id` (integer): Only this provider's bookings.
- `search` (string): Customer name, email or phone.
- `start_date` (string): From this date.
- `status` (string): Which bookings: upcoming (default), today, unassigned, completed, pending (charge pending), declined (charge declined), paused or all.

### `list_charges` (~206 tokens)

List charges

Charged bookings with their payments and refunds, as the Charges page lists them. Returns bookings that were charged, newest first, each with its payments: the booking charge, extras, tips, fees and refunds, with amount, tax, refunded amount and card. Filter by booking day and search by customer. BookingKoala gives no total: next_cursor is set while a full page comes back. booking_id and payment_log_id go to refund_charge. Empty until the store charges through a connected payment processor or marks bookings paid in cash.

Input parameters:

- `cursor` (string): next_cursor from the previous call.
- `end_date` (string): Last booking day, YYYY-MM-DD. Default: no upper bound.
- `limit` (integer): 1 to 100. Default: 20.
- `search` (string): Customer name, email or phone, or a booking id.
- `start_date` (string): First booking day, YYYY-MM-DD. Default: no lower bound.

### `list_customers` (~137 tokens)

List customers

Customers of the store, with email and phone; search by name, email or phone. Returns the store's customers as the Customers page lists them, newest first, active or deactivated. BookingKoala gives no total: next_cursor is set while a full page comes back. Use customer_id in get_customer.

Input parameters:

- `cursor` (string): next_cursor from the previous call.
- `limit` (integer): 1 to 100. Default: 20.
- `search` (string): Part of a name, email or phone number.
- `status` (string): active or inactive (deactivated) customers. Default: active.

### `list_drafts` (~97 tokens)

List drafts

Draft bookings and quotes saved in the store, not yet booked. Lists the drafts and quotes on the Drafts page: customer, date when set, total and whether it is a quote. create_booking leaves a draft here. Page with next_cursor.

Input parameters:

- `cursor` (string): next_cursor from the previous call.
- `limit` (integer): Page size. Default: 20.
- `search` (string): Customer name or email.

### `list_invoices` (~248 tokens)

List invoices

Invoices of the store or of one customer, with payment status, total and amount due. Returns invoices as the Invoices page lists them, newest first: number, customer, booking or custom type, payment status (paid, unpaid, partially_paid, void, uncollectible), total, paid, amount due, issue and due dates. Filter by customer, payment status and issue dates (default: two years back to a year ahead), or search by number, email, name or phone. BookingKoala gives no total: next_cursor is set while a full page comes back. invoice_id goes to resend_invoice.

Input parameters:

- `cursor` (string): next_cursor from the previous call.
- `customer_id` (integer): Only this customer's invoices.
- `end_date` (string): To this issue day, YYYY-MM-DD. Default: a year ahead.
- `limit` (integer): 1 to 100. Default: 20.
- `pay_status` (string): Payment status filter.
- `search` (string): Invoice number, customer email, name or phone.
- `start_date` (string): From this issue day, YYYY-MM-DD. Default: 2 years ago.

### `list_providers` (~184 tokens)

List providers

Providers (cleaners, technicians) and teams of the store, in priority order. Returns the store's service providers as the Providers page lists them, single providers and teams together; type team returns teams only. A team lists its members' provider ids, a provider the teams it belongs to and leads. BookingKoala gives no total: next_cursor is set while a full page comes back. Use provider_id in get_provider and when assigning a booking.

Input parameters:

- `cursor` (string): next_cursor from the previous call.
- `limit` (integer): 1 to 100. Default: 20.
- `search` (string): Part of a name, email or phone number.
- `status` (string): active or inactive (deactivated) providers. Default: active.
- `type` (string): all: providers and teams (default). team: teams only.

### `assign_provider` (~160 tokens)

Assign provider

Assign a provider or team to a booking, or to its whole recurring schedule. Puts the provider on the booking, as Assign in the booking's sidebar does, and returns the booking as get_booking shows it. BookingKoala tells the provider about the job. A provider who is not available at that time is refused unless even_if_unavailable is true. Waits for the owner's approval.

Input parameters:

- `booking_id` (integer, required): Booking id from list_bookings.
- `even_if_unavailable` (boolean): Assign although the provider is not available then. Default: false.
- `provider_id` (integer, required): Provider or team id from list_providers.
- `whole_schedule` (boolean): Assign every later booking of the recurring schedule too. Default: false.

### `cancel_booking` (~155 tokens)

Cancel booking

Cancel one booking or its whole recurring schedule, without a cancellation fee. Checks the store's cancellation rules first (a store that requires a reason gets the 'Other' reason with your text), then cancels as Cancel in the booking's sidebar does, with no fee. Nobody is told unless notify is true. Cancelled bookings leave list_bookings. Waits for the owner's approval.

Input parameters:

- `booking_id` (integer, required): Booking id from list_bookings.
- `notify` (boolean): Email the customer and providers about it. Default: false.
- `reason` (string): Why it is cancelled (kept on the booking).
- `whole_schedule` (boolean): Cancel the whole recurring schedule from this booking on. Default: false.

### `create_booking` (~98 tokens)

Create booking

Start a new booking as a copy of an existing one: same customer, service and price. Copies the booking as Duplicate in its sidebar does. The copy is saved as a draft (list_drafts) with the same customer, address, service, extras and price; open form_url to pick the date and book it. Nobody is told until it is booked.

Input parameters:

- `from_booking_id` (integer, required): Booking to copy, from list_bookings.

### `create_customer` (~275 tokens)

Create customer

New customer in the store. BookingKoala emails them an invitation to set a password. Adds a customer as Add Customer in the admin does, with an optional address that becomes their default service address. BookingKoala emails the customer at once to set a password for the store's booking page, so use their real address. An email already in the store is refused. Returns the new customer as get_customer does. Waits for the owner's approval.

Input parameters:

- `address` (string): Street address, e.g. 540 W 28th Street, New York, NY, USA.
- `apt` (string): Apartment or suite.
- `city` (string): City.
- `country` (string): Country, e.g. United States.
- `email` (string, required): Email address. BookingKoala sends the customer an invitation to set a password.
- `first_name` (string, required): First name.
- `gender` (string): Gender, optional.
- `last_name` (string, required): Last name.
- `phone` (string): Phone number, digits only for US numbers, e.g. 2125550147.
- `sms_notifications` (boolean): Text the customer booking updates. Default: false.
- `state` (string): State, e.g. New York.
- `zipcode` (string): ZIP or postal code.

### `refund_charge` (~265 tokens)

Refund a charge

Refund a paid booking charge, extra, tip or fee to the customer's card, in full or in part. Refunds one payment from list_charges (payment_log_id and its booking_id) through the store's payment processor, as the Refund popup of the Charges page does. amount includes tax and defaults to what is not refunded yet; less than that is a partial refund. Cancellation and reschedule fees are refunded only in full. The customer is not emailed unless notify_customer is true. Refused before you confirm when the store has no payment processor, the payment is not paid or the amount is too large. A booking paid partly with a gift card or referral credit is refunded in the panel. Money goes back to the customer and cannot be taken back. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.

Input parameters:

- `amount` (number): Amount to refund, tax included. Default: everything not refunded yet.
- `booking_id` (integer, required): Booking id from list_bookings.
- `notify_customer` (boolean): Email the customer about the refund. Default: false.
- `payment_log_id` (integer, required): payment_log_id of a paid payment, from list_charges.
- `reason` (string, required): Refund reason.

### `reschedule_booking` (~178 tokens)

Reschedule booking

Postpone a visit of a recurring booking to the date of a later visit in its schedule. Works like Postpone in the booking's sidebar: the visit moves to one of the schedule's later visit dates, keeping its arrival time and price, and the booking comes back as get_booking shows it. A date outside the schedule fails with the list of allowed dates. One-time bookings cannot be postponed. Nobody is told unless notify is true. A store that charges a reschedule fee refuses the move here: charge it in the panel. Waits for the owner's approval.

Input parameters:

- `booking_id` (integer, required): Booking id from list_bookings.
- `date` (string, required): New date: one of the later visit dates of the booking's recurring schedule.
- `notify` (boolean): Email the customer and providers about the change. Default: false.

### `resend_invoice` (~213 tokens)

Resend an invoice

Send an invoice to its customer again by email, text or both. Sends an existing invoice from list_invoices to its customer again, as the invoice's Resend button does: by email (default) and, with sms true, a text with the invoice link. The invoice's CC and billing addresses get the email too. attach_pdf defaults to the invoice's own setting. The invoice itself does not change. The customer gets it at once. BookingKoala refuses some resends with a warning, for example a void invoice; the error carries its message. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.

Input parameters:

- `attach_pdf` (boolean): Attach the PDF to the email. Default: as the invoice.
- `email` (boolean): Email the invoice to the customer. Default: true.
- `invoice_id` (string, required): invoice_id from list_invoices.
- `sms` (boolean): Text the invoice link to the customer. Default: false.

### `send_quote` (~236 tokens)

Send a quote

Email a saved quote to the customer with a link to book it. Sends a quote from list_drafts as the Send quote popup does: saves the recipient and expiry date on the quote, then emails the store's Send quote template (or your subject and message) with the quote's booking link. email defaults to the quote's customer; expires_on to the saved date, else a month ahead. Only drafts saved as quotes can be sent; a plain draft is refused before you confirm. The customer gets the email at once. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.

Input parameters:

- `draft_id` (integer, required): Id of a quote from list_drafts.
- `email` (string): Send to this address. Default: the quote's customer.
- `expires_on` (string): Last day the customer can book it, YYYY-MM-DD. Default: as saved, else a month ahead.
- `message` (string): Email body (HTML allowed). Default: the store's Send quote template.
- `subject` (string): Email subject. Default: the store's.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/dev-cotlet-bookingkoala/mcp-v1-bookingkoala#diagnostics

## Score history

- 2026-10-24: 69
- 2026-10-23: 69

## Common questions

### What is the BookingKoala by Cotlet MCP server?

BookingKoala by Cotlet is an MCP server listed in the public MCP registry as dev.cotlet/bookingkoala. Bookings, providers and customers in your BookingKoala store. This page covers its hosted endpoint (https://cotlet.dev/mcp/v1/bookingkoala).

### Is the BookingKoala by Cotlet MCP server safe to use?

BookingKoala by Cotlet scores 69 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the BookingKoala by Cotlet MCP server expose?

BookingKoala by Cotlet exposes 35 tools: cotlet_whoami, cotlet_apps, cotlet_request_apps, cotlet_get_call, cotlet_upload_file, and 30 more. Their descriptions and schemas cost roughly 5,139 tokens of context every time the server is loaded.

### Does the BookingKoala by Cotlet MCP server require authentication?

No. We connected to BookingKoala by Cotlet without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the BookingKoala by Cotlet MCP server still maintained?

BookingKoala by Cotlet is still listed as active in the MCP registry. We last reached this channel on 24 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://cotlet.dev/mcp/v1/bookingkoala
- Authorisation metadata: https://cotlet.dev/.well-known/oauth-protected-resource/mcp/v1/bookingkoala
- Repository: https://github.com/cotletdev/bookingkoala-api-mcp-server
- Website: https://cotlet.dev/integrations/bookingkoala-api-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/dev-cotlet-bookingkoala/mcp-v1-bookingkoala.xml
- Changelog JSON feed: https://verifymcp.io/servers/dev-cotlet-bookingkoala/mcp-v1-bookingkoala.json
- HTML version of this page: https://verifymcp.io/servers/dev-cotlet-bookingkoala/mcp-v1-bookingkoala