# Bookingmood MCP by usefulapi (remote · bookingmood.usefulapi.io)

Read Bookingmood bookings, availability, guests, payments and invoices; update bookings, contacts.

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

## Components

- remote · `bookingmood.usefulapi.io`: 61/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-bookingmood/bookingmood.md), [page](https://verifymcp.io/servers/io-usefulapi-bookingmood/bookingmood)

## Channel facts

- Endpoint: `https://bookingmood.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `required`
- Version: `1.0.3`

## 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-25.

- **Endpoint Security**: 78/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token.
  - HTTPS enforcement could not be verified: the plaintext port redirected somewhere other than https, so enforcement is unproven.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
  - The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents.
- **Transport & Reachability**: 0/100
  - Transport check failed: declared streamable-http, but the endpoint redirected instead of responding directly.
- **Schema Quality & AI Usability**: 79/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 3109 tokens (~148/item across 21 items; 21 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 3/100
  - Stability observed for 1 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 90/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 70% 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.
  - We read all 21 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 22 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### How do I install the Bookingmood MCP by usefulapi server?

Bookingmood MCP by usefulapi is a hosted endpoint at https://bookingmood.usefulapi.io/mcp, 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 io-usefulapi-bookingmood 'https://bookingmood.usefulapi.io/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "io-usefulapi-bookingmood": {
      "url": "https://bookingmood.usefulapi.io/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "io-usefulapi-bookingmood": {
      "type": "http",
      "url": "https://bookingmood.usefulapi.io/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.io-usefulapi-bookingmood]
url = "https://bookingmood.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-bookingmood": {
      "type": "remote",
      "url": "https://bookingmood.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-bookingmood --url 'https://bookingmood.usefulapi.io/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-bookingmood:
    url: "https://bookingmood.usefulapi.io/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "io-usefulapi-bookingmood": {
      "Transport": "http",
      "Url": "https://bookingmood.usefulapi.io/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add io-usefulapi-bookingmood -t streamable-http -u 'https://bookingmood.usefulapi.io/mcp'
```

### Other

```json
{
  "mcpServers": {
    "io-usefulapi-bookingmood": {
      "type": "http",
      "url": "https://bookingmood.usefulapi.io/mcp"
    }
  }
}
```

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-25 (score 61, 0)

- [functional improvement] Stability: unverified → 0.03
- [functional] Server version: 1.0.0 → 1.0.3

### 2026-10-24 (score 61)

First indexed and scored.

## MCP tools (21)

### `bookingmood_get_organization` (~62 tokens)

Get organization

The Bookingmood organization this API key belongs to: name, company, plan (tier, subscription type, expiry), languages, country, VAT number, custom domain and contact details. Payment-provider ids and secrets are not returned. GET /organizations.

### `bookingmood_list_products` (~114 tokens)

List products (rentals)

List the rentable products (apartments, rooms, boats, bikes...) with name, currency, timezone, rent period (daily/nightly), booking interaction, fee and deposit. Names and descriptions are objects keyed by language ('default', 'nl-NL', ...). Images are not returned. GET /products.

Input parameters:

- `limit` (integer): Rows per page, 1-100 (default 25).
- `offset` (integer): Rows to skip (default 0). Pass the previous reply's next_offset.

### `bookingmood_get_product` (~58 tokens)

Get product

One product by id with its capacities (guest-group min/max limits) embedded. GET /products?id=eq.{id}&select=*,capacities(*).

Input parameters:

- `product_id` (string, required): Bookingmood product id (UUID).

### `bookingmood_list_bookings` (~213 tokens)

List bookings

List bookings, newest first: reference, method (request or book), currency, confirmed_at (null = not confirmed yet), created_at. A booking's dates and guests are on its calendar events (bookingmood_list_calendar_events) and contacts. Filter by creation date, confirmation state or reference text. The guest access secret is never returned. GET /bookings.

Input parameters:

- `confirmed` (boolean): true = only confirmed bookings, false = only unconfirmed ones.
- `created_from` (string): Only bookings created on or after this date.
- `created_to` (string): Only bookings created on or before this date.
- `limit` (integer): Rows per page, 1-100 (default 25).
- `method` (string): 'request' = booking request awaiting approval, 'book' = instant booking.
- `offset` (integer): Rows to skip (default 0). Pass the previous reply's next_offset.
- `reference` (string): Text contained in the booking reference.

### `bookingmood_get_booking` (~117 tokens)

Get booking with details

One booking with everything attached: its calendar events (dates, product, status, occupancy, notes), line items, payments, invoices and the guest contacts linked to it. Five or six read requests. The guest contacts come from the booking-contact link table; if that lookup fails the reply says so instead of failing. GET /bookings, /calendar_events, /line_items, /payments, /invoices, /contact_bookings, /contacts.

Input parameters:

- `booking_id` (string, required): Bookingmood booking id (UUID).

### `bookingmood_list_calendar_events` (~291 tokens)

List calendar events

List calendar events: bookings (type 'booking'), blocked periods and notes, with product_id, booking_id, start_date, end_date, status (TENTATIVE, CONFIRMED, CANCELLED), occupancy, title and notes. Use the date filters for arrivals/departures (e.g. start_date_from = start_date_to = today lists today's arrivals) or active_on for who is in the property on a day. Ordered by start date. GET /calendar_events.

Input parameters:

- `active_on` (string): Only events that cover this date (start_date <= date <= end_date).
- `booking_id` (string): Only events of this booking.
- `end_date_from` (string): end_date on or after this date (departures from).
- `end_date_to` (string): end_date on or before this date (departures until).
- `limit` (integer): Rows per page, 1-100 (default 25).
- `offset` (integer): Rows to skip (default 0). Pass the previous reply's next_offset.
- `product_id` (string): Only events of this product.
- `start_date_from` (string): start_date on or after this date (arrivals from).
- `start_date_to` (string): start_date on or before this date (arrivals until).
- `status` (string)
- `type` (string)

### `bookingmood_check_availability` (~100 tokens)

Check availability

Availability calendar of up to 5 products: per product a list of intervals {start, end, status} with status available, tentative, unavailable, booked or reserved. One request per product. GET /availability?product_id={id}.

Input parameters:

- `product_ids` (array, required): Product ids (UUIDs), 1-5.
- `show_pending_as` (string): How pending (tentative) bookings count (default TENTATIVE).

### `bookingmood_search_products` (~145 tokens)

Search available products

Which products can be booked for a stay: for each product whether it matches the dates, guest numbers and options, its availability and a price range {min, max}. Read-only (a search; nothing is booked). occupancy maps a capacity-group id (from bookingmood_get_product capacities) to a number of guests. POST /search.

Input parameters:

- `end` (string): Departure date.
- `occupancy` (object): Map of capacity-group id (UUID) to the number of guests of that group, e.g. adults.
- `option_ids` (array): Attribute option ids (UUIDs) the product must have.
- `start` (string): Arrival date.

### `bookingmood_list_contacts` (~135 tokens)

List contacts (guests)

List contacts (guests and customers): name, email, phone, company, address, language, notes. Search by name, email or company (case-insensitive, contains). Newest first. GET /contacts.

Input parameters:

- `company` (string): Text contained in the company name.
- `email` (string): Text contained in the email address.
- `limit` (integer): Rows per page, 1-100 (default 25).
- `name` (string): Text contained in the contact name.
- `offset` (integer): Rows to skip (default 0). Pass the previous reply's next_offset.

### `bookingmood_get_contact` (~40 tokens)

Get contact

One contact by id. GET /contacts?id=eq.{id}.

Input parameters:

- `contact_id` (string, required): Bookingmood contact id (UUID).

### `bookingmood_list_payments` (~223 tokens)

List payments

List payments (deposits, balances, offline payments): booking_id, invoice_id, amount and paid (integers; the API reference does not state the unit, normally the smallest currency unit), currency, due_at, completed_at (null = not paid), status, offline. Filter to unpaid payments, a booking or a due date. Ordered by due date, latest first. GET /payments.

Input parameters:

- `booking_id` (string): Only payments of this booking.
- `completed` (boolean): true = only completed payments, false = only open ones.
- `due_from` (string): due_at on or after this date.
- `due_to` (string): due_at on or before this date.
- `invoice_id` (string): Only payments of this invoice.
- `limit` (integer): Rows per page, 1-100 (default 25).
- `offline` (boolean): true = only offline (manual) payments.
- `offset` (integer): Rows to skip (default 0). Pass the previous reply's next_offset.

### `bookingmood_list_invoices` (~145 tokens)

List invoices

List invoices: reference, booking_id, attachment (a custom uploaded file URL, if any), created_at. Filter by booking or creation date. Newest first. GET /invoices.

Input parameters:

- `booking_id` (string): Only invoices of this booking.
- `created_from` (string): Created on or after this date.
- `created_to` (string): Created on or before this date.
- `limit` (integer): Rows per page, 1-100 (default 25).
- `offset` (integer): Rows to skip (default 0). Pass the previous reply's next_offset.
- `reference` (string): Text contained in the invoice reference.

### `bookingmood_list_line_items` (~152 tokens)

List line items

List invoice/booking line items: name (per language), amount and quantity (integers; the API reference does not state the unit), item_type (rent, fee...), fee_type (fee or deposit), booking_id, event_id, invoice_id. GET /line_items.

Input parameters:

- `booking_id` (string): Only line items of this booking.
- `event_id` (string): Only line items of this calendar event.
- `invoice_id` (string): Only line items of this invoice.
- `limit` (integer): Rows per page, 1-100 (default 25).
- `offset` (integer): Rows to skip (default 0). Pass the previous reply's next_offset.

### `bookingmood_list_coupons` (~90 tokens)

List coupons

List discount coupons: code, description, definition, quota, scope (global, product, service, rent), stackable. Deleted coupons are left out. GET /coupons.

Input parameters:

- `limit` (integer): Rows per page, 1-100 (default 25).
- `offset` (integer): Rows to skip (default 0). Pass the previous reply's next_offset.

### `bookingmood_list_services` (~84 tokens)

List services (extras and fees)

List services: the extras, fees and form fields guests can add to a booking, with label, type, fee, deposit and description. GET /services.

Input parameters:

- `limit` (integer): Rows per page, 1-100 (default 25).
- `offset` (integer): Rows to skip (default 0). Pass the previous reply's next_offset.

### `bookingmood_list_tasks` (~168 tokens)

List tasks

List housekeeping/operations tasks attached to calendar events: label, due_at, completed_at (null = open), schedule (manual, arrival, departure), calendar_event_id. Filter to open tasks or a due-date window. Earliest due first. GET /tasks.

Input parameters:

- `calendar_event_id` (string): Only tasks of this calendar event.
- `completed` (boolean): true = only completed tasks, false = only open ones.
- `due_from` (string): due_at on or after this date.
- `due_to` (string): due_at on or before this date.
- `limit` (integer): Rows per page, 1-100 (default 25).
- `offset` (integer): Rows to skip (default 0). Pass the previous reply's next_offset.

### `bookingmood_list_messages` (~143 tokens)

List guest messages

List the e-mails and SMS Bookingmood sent or scheduled to guests: subject, body, type (email or sms), status (sent, manually-scheduled, scheduled-around-arrival, scheduled-around-departure), send_at, booking_id. The rendered HTML is not returned. Latest first. GET /messages.

Input parameters:

- `booking_id` (string): Only messages of this booking.
- `limit` (integer): Rows per page, 1-100 (default 25).
- `offset` (integer): Rows to skip (default 0). Pass the previous reply's next_offset.
- `status` (string)
- `type` (string)

### `bookingmood_update_event_notes` (~103 tokens)

Set calendar event notes

WRITE: replace the internal notes of ONE calendar event (the whole notes text is overwritten, so include the existing text if you want to keep it - read it first with bookingmood_list_calendar_events). Notes are internal; no guest is notified. PATCH /calendar_events?id=eq.{id}.

Input parameters:

- `event_id` (string, required): Calendar event id (UUID).
- `notes` (string, required): The new notes text (an empty string clears the notes).

### `bookingmood_set_event_status` (~107 tokens)

Set calendar event status (confirm / cancel)

WRITE: change the status of ONE calendar event to CONFIRMED, TENTATIVE or CANCELLED. This changes what the calendar shows as available and can trigger Bookingmood's own automations for the booking (guest e-mails, tasks, payment reminders), so confirm with the user before cancelling or confirming. PATCH /calendar_events?id=eq.{id}.

Input parameters:

- `event_id` (string, required): Calendar event id (UUID).
- `status` (string, required): The new status.

### `bookingmood_create_contact` (~175 tokens)

Create contact

WRITE: create ONE new contact (guest/customer) in Bookingmood. Not idempotent: calling it twice creates two contacts, so search with bookingmood_list_contacts first. No message is sent to the contact. POST /contacts.

Input parameters:

- `city` (string)
- `company_name` (string)
- `country_code` (string)
- `email` (string)
- `first_name` (string)
- `language` (string): Contact language, e.g. en-US or nl-NL.
- `last_name` (string)
- `notes` (string)
- `phone` (string)
- `province` (string)
- `state` (string)
- `street` (string)
- `street2` (string)
- `zip` (string)

### `bookingmood_update_contact` (~175 tokens)

Update contact

WRITE: change fields of ONE existing contact (only the fields you pass are changed; others stay). No message is sent to the contact. PATCH /contacts?id=eq.{id}.

Input parameters:

- `city` (string)
- `company_name` (string)
- `contact_id` (string, required): Contact id (UUID).
- `country_code` (string)
- `email` (string)
- `first_name` (string)
- `language` (string): Contact language, e.g. en-US or nl-NL.
- `last_name` (string)
- `notes` (string)
- `phone` (string)
- `province` (string)
- `state` (string)
- `street` (string)
- `street2` (string)
- `zip` (string)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-bookingmood/bookingmood#diagnostics

## Score history

- 2026-10-25: 61
- 2026-10-24: 61

## Common questions

### What is the Bookingmood MCP by usefulapi server?

Bookingmood MCP by usefulapi is listed in the public MCP registry as io.usefulapi/bookingmood. Read Bookingmood bookings, availability, guests, payments and invoices; update bookings, contacts. This page covers its hosted endpoint (https://bookingmood.usefulapi.io/mcp).

### Is the Bookingmood MCP by usefulapi server safe to use?

Bookingmood MCP by usefulapi scores 61 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 Bookingmood MCP by usefulapi server expose?

Bookingmood MCP by usefulapi exposes 21 tools: bookingmood_get_organization, bookingmood_list_products, bookingmood_get_product, bookingmood_list_bookings, bookingmood_get_booking, and 16 more. Their descriptions and schemas cost roughly 2,840 tokens of context every time the server is loaded.

### Does the Bookingmood MCP by usefulapi server require authentication?

Yes. Bookingmood MCP by usefulapi asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.

### Is the Bookingmood MCP by usefulapi server still maintained?

Bookingmood MCP by usefulapi is still listed as active in the MCP registry. We last reached this channel on 25 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://bookingmood.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Website: https://usefulapi.io/bookingmood/
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-bookingmood/bookingmood.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-bookingmood/bookingmood.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-bookingmood/bookingmood