# io.usefulapi/smoobu (remote · smoobu.usefulapi.io)

Check vacation-rental reservations, rates, availability and guest messages, and update bookings.

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

## Components

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

## Channel facts

- Endpoint: `https://smoobu.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

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

- **Endpoint Security**: 83/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, but the challenge carries no valid RFC 9728 metadata, so a client cannot discover where to get a token.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 76/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2672 tokens (~133/item across 20 items; 20 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 7/100
  - Stability observed for 2 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **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 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 20 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 io.usefulapi/smoobu MCP server?

io.usefulapi/smoobu is a hosted endpoint at https://smoobu.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-smoobu 'https://smoobu.usefulapi.io/mcp'
```

### Cursor

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

### VS Code

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

### Codex

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

### opencode

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

### OpenClaw

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

### Hermes

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

### Netclaw

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

### Vellum

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

### Other

```json
{
  "mcpServers": {
    "io-usefulapi-smoobu": {
      "type": "http",
      "url": "https://smoobu.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-04 (score 74, +41)

- [security regression] Authorization: unverified → fail
- [security improvement] Injection markers: unverified → pass
- [functional regression] MCP protocol: unverified → fail
- [functional improvement] Endpoint reachability: not serving MCP → reachable
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Stability: unverified → 0.07

### 2026-10-03 (score 33, −43)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Authorization: pass → unverified
- [security regression] Tool safety: pass → unverified
- [functional regression] Capabilities: fail → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-10-02 (score 76, +43)

- [security improvement] Authorization: unverified → pass
- [security improvement] Injection markers: unverified → pass
- [security] First check of Judged manipulation: pass
- [functional regression] MCP protocol: unverified → fail
- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: excellent
- [functional] First check of Schema quality: fail
- [functional] First check of Destructive annotations: 100
- [functional] First check of Tool coverage: 100

### 2026-10-01 (score 33, +5)

- [security improvement] HTTPS: unverified → pass

### 2026-09-30 (score 28, +10)

- [security improvement] Transport: fail → pass
- [security] Authorization: Authorisation not fully verified: no authorisation is required to connect, but we couldn't read the whole tool list to see what that exposes.

### 2026-09-29 (score 18)

First indexed and scored.

## MCP tools (20)

### `smoobu_get_user` (~56 tokens)

Get the current user

Fetch the Smoobu user these credentials belong to (id, name, email). A cheap way to confirm the setup works; the id is the customerId used by availability checks. Smoobu: GET /api/me.

### `smoobu_list_apartments` (~50 tokens)

List properties

List every property (Smoobu calls them apartments) in the account, with id and name. Start here to get apartment ids. Smoobu: GET /api/apartments.

### `smoobu_get_apartment` (~68 tokens)

Get one property

Fetch one property's details: location, time zone, rooms and beds, max occupancy, amenities, currency, min/max nightly price and type. Smoobu: GET /api/apartments/{apartmentId}.

Input parameters:

- `apartment_id` (integer, required): The apartment (property) id.

### `smoobu_list_reservations` (~349 tokens)

List reservations

List reservations across all channels (Airbnb, Booking.com, direct, ...), paginated, with guest, dates, channel, price and payment status. Filter by stay range, arrival, departure, creation or modification date, and property. Smoobu: GET /api/reservations.

Input parameters:

- `apartment_id` (integer): Only this property.
- `arrival_from` (string): Only arrivals on or after (yyyy-mm-dd).
- `arrival_to` (string): Only arrivals on or before (yyyy-mm-dd).
- `created_from` (string): Only bookings created on or after (yyyy-mm-dd).
- `created_to` (string): Only bookings created on or before (yyyy-mm-dd).
- `departure_from` (string): Only departures on or after (yyyy-mm-dd).
- `departure_to` (string): Only departures on or before (yyyy-mm-dd).
- `exclude_blocked` (boolean): Hide blocked-period bookings.
- `from` (string): Only bookings overlapping a stay range starting on this date (yyyy-mm-dd).
- `include_price_elements` (boolean): Include each booking's price breakdown.
- `include_related` (boolean): With apartment_id: also return bookings from grouped properties.
- `modified_from` (string): Only bookings modified on or after (yyyy-mm-dd).
- `modified_to` (string): Only bookings modified on or before (yyyy-mm-dd).
- `page` (integer): Page number, starting at 1.
- `page_size` (integer): Bookings per page, 1-100.
- `show_cancellations` (boolean): Include cancelled bookings.
- `to` (string): End of that stay range (yyyy-mm-dd).

### `smoobu_get_reservation` (~74 tokens)

Get one reservation

Fetch one reservation by id: guest, dates, check-in/out times, channel and its reference id, price, prepayment and deposit status, and the guest-app URL. Smoobu: GET /api/reservations/{reservationId}.

Input parameters:

- `reservation_id` (integer, required): The reservation (booking) id.

### `smoobu_list_price_elements` (~73 tokens)

List a reservation's price elements

List the financial breakdown of one reservation: base price, cleaning fee, add-ons, long-stay discounts and coupons, with amounts, tax and currency. Smoobu: GET /api/reservations/{reservationId}/price-elements.

Input parameters:

- `reservation_id` (integer, required): The reservation (booking) id.

### `smoobu_get_reservation_placeholders` (~95 tokens)

Get a reservation's message placeholders

Get every placeholder value Smoobu would substitute into a message for this reservation: guest name, dates and times, nights, price and balance, online check-in link, guest-app link, door PIN codes and more. Useful for drafting a guest message. Smoobu: GET /api/reservations/{reservationId}/placeholders.

Input parameters:

- `reservation_id` (integer, required): The reservation (booking) id.

### `smoobu_get_rates` (~88 tokens)

Get rates and availability

Get the nightly price, minimum length of stay and availability (0 = not available) for each date in a range, for one or more properties. Smoobu: GET /api/rates.

Input parameters:

- `apartment_ids` (array, required): Property ids.
- `end_date` (string, required): Last date (yyyy-mm-dd).
- `start_date` (string, required): First date (yyyy-mm-dd).

### `smoobu_check_availability` (~172 tokens)

Check availability and quote a stay

Check which properties can be booked for an arrival/departure pair and get the total price for each; unavailable ones come back with the reason (minimum stay, too many guests, arrival day, lead time...). Read-only, books nothing. Smoobu: POST /booking/checkApartmentAvailability.

Input parameters:

- `apartment_ids` (array): Properties to check. Omit or pass [] to check all.
- `arrival_date` (string, required): Arrival date (yyyy-mm-dd).
- `customer_id` (integer): Your Smoobu user id. Omit to look it up automatically (one extra GET /api/me).
- `departure_date` (string, required): Departure date (yyyy-mm-dd).
- `discount_code` (string): Discount code from the booking-tool settings.
- `guests` (integer): Number of guests.

### `smoobu_list_message_threads` (~85 tokens)

List inbox threads

List the unified guest inbox: one thread per booking with guest name, property and the latest message, plus the unread count. Smoobu: GET /api/threads.

Input parameters:

- `apartment_ids` (array): Only threads for these properties.
- `page_number` (integer): Page number, starting at 1.
- `page_size` (integer): Threads per page.

### `smoobu_list_reservation_messages` (~121 tokens)

List a reservation's messages

Get the full conversation for one reservation, paginated. Each message has a subject, plain-text and HTML body, and type (1 = inbox / from guest, 2 = outbox / sent). Smoobu: GET /api/reservations/{reservationId}/messages.

Input parameters:

- `only_related_to_guest` (boolean): true = only guest-facing messages; false = every message on the booking.
- `page` (integer): Page number, starting at 1.
- `reservation_id` (integer, required): The reservation (booking) id.

### `smoobu_list_guests` (~93 tokens)

List guests

List guests from the Smoobu CRM with their emails, phone numbers, address, notes and bookings; optionally search. Smoobu: GET /api/guests.

Input parameters:

- `page` (integer): Page number, starting at 1.
- `page_size` (integer): Guests per page, 1-100.
- `query` (string): Search term, e.g. a name or email.

### `smoobu_get_guest` (~60 tokens)

Get one guest

Fetch one guest by id (the guestId on a reservation) with contact details, notes and every booking they have made. Smoobu: GET /api/guests/{guestId}.

Input parameters:

- `guest_id` (integer, required): The guest id.

### `smoobu_list_addons` (~98 tokens)

List add-ons

List the bookable add-ons (towels, breakfast, late check-out...) with amount, tax, calculation type (0 per booking, 1 per person, 2 per night, 3 per person and night) and the properties they apply to; optionally for one property. Smoobu: GET /api/addons[/{apartmentId}].

Input parameters:

- `apartment_id` (integer): Only add-ons for this property.

### `smoobu_list_custom_placeholders` (~48 tokens)

List custom placeholders

List the account's custom message placeholders (key, default value, and whether they are global, per booking or per property). Smoobu: GET /api/custom-placeholders.

### `smoobu_create_reservation` (~449 tokens)

Create a reservation

Create a reservation (or a blocked period) on a property. Smoobu treats it like a booking from a channel and SYNCS the blocked dates to every connected channel (Airbnb, Booking.com, ...). Fails if the dates overlap an existing booking. This server offers no cancel — cancel it in Smoobu if needed. Which guest fields are mandatory depends on your booking-tool 'Form Content' settings. Smoobu: POST /api/reservations.

Input parameters:

- `address` (object): Guest address.
- `adults` (integer): Number of adults.
- `apartment_id` (integer, required): The property id.
- `arrival_date` (string, required): Arrival date (yyyy-mm-dd).
- `arrival_time` (string): Arrival time (HH:mm, 24h).
- `channel_id` (integer): Channel id (defaults to 70). Must be a channel the account has, e.g. 13 = Direct booking, 11 = Blocked channel.
- `children` (integer): Number of children.
- `country` (string): Guest country.
- `departure_date` (string, required): Departure date (yyyy-mm-dd).
- `departure_time` (string): Departure time (HH:mm, 24h).
- `deposit` (number): Deposit amount.
- `deposit_status`: Deposit status: 0 = open / not paid, 1 = paid in full.
- `email` (string): Guest email.
- `first_name` (string): Guest first name.
- `language` (string): Guest language, e.g. en, de, es.
- `last_name` (string): Guest last name.
- `notice` (string): Free-text notes on the booking.
- `phone` (string): Guest phone.
- `prepayment` (number): Prepayment amount.
- `prepayment_status`: Prepayment status: 0 = open / not paid, 1 = paid in full.
- `price` (number): Total price of the booking.
- `price_elements` (array): Optional price breakdown (base price, cleaning fee, ...).
- `price_status`: Price status: 0 = open / not paid, 1 = paid in full.

### `smoobu_update_reservation` (~313 tokens)

Update a reservation

Update an existing reservation's times, guest contact, notes, guest counts, language, or price / prepayment / deposit amounts and paid status. Only the fields you pass are sent. Dates and property cannot be changed here. Smoobu: PUT /api/reservations/{reservationId}.

Input parameters:

- `adults` (integer): Number of adults.
- `arrival_time` (string): Arrival time (HH:mm, 24h).
- `assistant_notice` (string): Instructions for your assistant / cleaner.
- `children` (integer): Number of children.
- `departure_time` (string): Departure time (HH:mm, 24h).
- `deposit` (number): Deposit amount.
- `deposit_status`: Deposit status: 0 = open / not paid, 1 = paid in full.
- `guest_email` (string): Guest email.
- `guest_name` (string): Guest name.
- `guest_phone` (string): Guest phone.
- `language` (string): Guest language, e.g. en, de, es.
- `notice` (string): Free-text notes on the booking.
- `prepayment` (number): Prepayment amount.
- `prepayment_status`: Prepayment status: 0 = open / not paid, 1 = paid in full.
- `price` (number): Total price.
- `price_status`: Price status: 0 = open / not paid, 1 = paid in full.
- `reservation_id` (integer, required): The reservation (booking) id.

### `smoobu_set_rates` (~123 tokens)

Set rates and minimum stays

Set the nightly price and/or minimum length of stay for dates on one or more properties. Smoobu PUSHES these to every channel with price sync enabled, so this changes live prices guests see. Reversible by setting the old values again — read them first with smoobu_get_rates. Each operation needs daily_price, min_length_of_stay, or both (a minimum stay alone needs an existing price). Smoobu: POST /api/rates.

Input parameters:

- `apartment_ids` (array, required): Property ids.
- `operations` (array, required): Rate changes to apply.

### `smoobu_send_message_to_guest` (~127 tokens)

Send a message to a guest

Send a message to the guest of a reservation through Smoobu (it goes out on the booking's channel, e.g. the Airbnb or Booking.com inbox, or email). Delivered IMMEDIATELY and cannot be unsent — confirm the text with the user first. Smoobu: POST /api/reservations/{reservationId}/messages/send-message-to-guest.

Input parameters:

- `message_body` (string, required): Message content, HTML or plain text.
- `reservation_id` (integer, required): The reservation (booking) id.
- `subject` (string): Subject line.

### `smoobu_send_message_to_host` (~130 tokens)

Post a message to the host

Post a message on a reservation's thread addressed to the Smoobu user (the host). With internal=true it is an internal note hidden from the guest — handy for logging. Cannot be unsent. Smoobu: POST /api/reservations/{reservationId}/messages/send-message-to-host.

Input parameters:

- `internal` (boolean): true = visible only to the host, hidden from the guest.
- `message_body` (string, required): Message content, HTML or plain text.
- `reservation_id` (integer, required): The reservation (booking) id.
- `subject` (string): Subject line.

## Diagnostics

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

## Score history

- 2026-10-04: 74
- 2026-10-03: 33
- 2026-10-02: 76
- 2026-10-01: 33
- 2026-09-30: 28
- 2026-09-29: 18

## Common questions

### What is the io.usefulapi/smoobu MCP server?

io.usefulapi/smoobu is an MCP server listed in the public MCP registry as io.usefulapi/smoobu. Check vacation-rental reservations, rates, availability and guest messages, and update bookings. This page covers its hosted endpoint (https://smoobu.usefulapi.io/mcp).

### Is the io.usefulapi/smoobu MCP server safe to use?

io.usefulapi/smoobu scores 74 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 io.usefulapi/smoobu MCP server expose?

io.usefulapi/smoobu exposes 20 tools: smoobu_get_user, smoobu_list_apartments, smoobu_get_apartment, smoobu_list_reservations, smoobu_get_reservation, and 15 more. Their descriptions and schemas cost roughly 2,672 tokens of context every time the server is loaded.

### Does the io.usefulapi/smoobu MCP server require authentication?

Yes. io.usefulapi/smoobu 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 io.usefulapi/smoobu MCP server still maintained?

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