WuBook MCP by usefulapi
Read WuBook ZaK rooms, availability and reservations; manage inventory and guest check-in.
Should I use this
Quality & Safety
Findings (1)
- LOWTool 'wubook_list_todays_reservations' name length outside 3-30 rangein wubook_list_todays_reservations
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"wubook": {
"url": "https://wubook.usefulapi.io/mcp"
}
}
}Remote endpoints
https://wubook.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (19)
🟢wubook_list_rooms
List the physical rooms of the property (id, room type id, name, tags). POST /kp/property/fetch_rooms.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wubook_list_room_types
List the room types (id, name, short name, default price, default occupancy). POST /kp/property/fetch_room_types.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wubook_list_rates
List the rates of the property (id, name, board, currency, standard flag). Use a rate id for prices and restrictions. POST /kp/property/fetch_rates.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wubook_list_products
List the products (a room type sold on a board basis: id, room type id, name, default price, occupancy). Product ids are the keys of prices and availability. POST /kp/property/fetch_products.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wubook_list_meal_boards
List the meal rules and meal prices per board type (fb, hb, bb, ai) for adults, teens, children and babies. POST /kp/property/fetch_meals_board.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wubook_list_extras
List the extras the property sells (id, name, price, VAT percentage, cost, tags). POST /kp/property/fetch_extras.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wubook_get_inventory_symbols
The meaning of the short keys in prices and restrictions (p price, a availability, m MinStay, M MaxStay, c closure, ...). POST /kp/inventory/fetch_symbols.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wubook_get_room_availability(arrival, departure)
Availability for a stay: for each room type id, the number of rooms available and the ids of the available physical rooms. The availability count can be lower than the number of listed physical rooms when a reservation has no physical room assigned yet; use the availability count when assessing bookable capacity. POST /kp/inventory/fetch_rooms_availability.
Input Schema
{
"type": "object",
"properties": {
"arrival": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Arrival date, yyyy-mm-dd."
},
"departure": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Departure date, yyyy-mm-dd."
}
},
"required": [
"arrival",
"departure"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wubook_get_rate_values(from, rate_id, days)
Daily prices, availability and restrictions of one rate, starting at a date: for each product id a list with one object per day (p price, a availability, m/M min/max stay, c closed, ...; see wubook_get_inventory_symbols). POST /kp/inventory/fetch_rate_values.
Input Schema
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First day, yyyy-mm-dd."
},
"rate_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Rate id (wubook_list_rates)."
},
"days": {
"type": "integer",
"minimum": 1,
"maximum": 366,
"description": "Number of days from `from`, 1-366."
}
},
"required": [
"from",
"rate_id",
"days"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴wubook_update_inventory(from, rate_id, products)
WRITE: overwrite daily prices, availability and stay restrictions of one rate. `products` maps a product id to a list of day objects; the first object is the day `from`, the next the following day, and so on. Only the fields you send per day change. Changes can be pushed to connected channels (OTAs) and affect live bookings, so confirm the values with the user first. POST /kp/inventory/write.
Input Schema
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First day the lists start at, yyyy-mm-dd."
},
"rate_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Rate id (wubook_list_rates)."
},
"products": {
"type": "object",
"propertyNames": {
"type": "string",
"pattern": "^[1-9]\\d{0,15}$"
},
"additionalProperties": {
"minItems": 1,
"maxItems": 366,
"type": "array",
"items": {
"type": "object",
"properties": {
"p": {
"description": "Price.",
"type": "number",
"minimum": 0,
"maximum": 10000000
},
"a": {
"description": "Availability (rooms).",
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"m": {
"description": "Minimum stay (nights).",
"type": "integer",
"minimum": 1,
"maximum": 365
},
"M": {
"description": "Maximum stay (nights).",
"type": "integer",
"minimum": 1,
"maximum": 365
},
"ma": {
"description": "Minimum stay by arrival date.",
"type": "integer",
"minimum": 1,
"maximum": 365
},
"Ma": {
"description": "Maximum stay by arrival date.",
"type": "integer",
"minimum": 1,
"maximum": 365
},
"ni": {
"description": "1 = no check-in on this day.",
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
},
"no": {
"description": "1 = no check-out on this day.",
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
},
"c": {
"description": "1 = closed for sale on this day.",
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
},
"nt": {
"description": "1 = no OTA reservations on this day.",
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
},
"mx": {
"description": "Minimum advance to book (hours).",
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"Mx": {
"description": "Maximum advance to book.",
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"o": {
"description": "1 = overbooking allowed.",
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
},
"l": {
"description": "Maximum OTA reservations.",
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"additionalProperties": false
}
},
"description": "Product id → one object per day, e.g. {\"12\": [{\"p\": 90, \"a\": 3}, {\"p\": 95}]}. Keys: p price, a availability, m/M min/max stay, ma/Ma by arrival, ni no check-in, no no check-out, c closed, nt no OTA, mx/Mx advance, o overbooking, l max OTA."
}
},
"required": [
"from",
"rate_id",
"products"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wubook_get_reservation(reservation_id, reservation_code)
One reservation by id or by reservation code (XY-0001): status, booker customer id, origin channel, board, dates, price split (rooms, extras, meals), payment, taxes and rooms with occupancy and customer ids. POST /kp/reservations/fetch_one_reservation.
Input Schema
{
"type": "object",
"properties": {
"reservation_id": {
"description": "Reservation id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"reservation_code": {
"type": "string",
"minLength": 2,
"maxLength": 40,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$",
"description": "Reservation (human) code such as XY-0001."
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wubook_list_reservations(created_from, created_to, arrival_from, arrival_to, departure_from, ...)
List reservations, optionally filtered by creation, arrival or departure date ranges (inclusive). Newest first is not guaranteed; page with offset. Returns the page plus next_offset (null when the last page was reached). POST /kp/reservations/fetch_reservations.
Input Schema
{
"type": "object",
"properties": {
"created_from": {
"description": "Created on or after (yyyy-mm-dd). Needs created_to.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"created_to": {
"description": "Created on or before.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"arrival_from": {
"description": "Arriving on or after. Needs arrival_to.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"arrival_to": {
"description": "Arriving on or before.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"departure_from": {
"description": "Departing on or after. Needs departure_to.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"departure_to": {
"description": "Departing on or before.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"limit": {
"description": "Page size: 8, 16, 32 or 64 (default 32).",
"anyOf": [
{
"type": "number",
"const": 8
},
{
"type": "number",
"const": 16
},
{
"type": "number",
"const": 32
},
{
"type": "number",
"const": 64
}
]
},
"offset": {
"description": "Reservations to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wubook_list_todays_reservations
Reservations of the property for today (arrivals, departures and stays in house). POST /kp/reservations/fetch_today_reservations.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡wubook_create_reservation(arrival, departure, guest, rooms, products, ...)
WRITE: create a reservation in ZaK for one guest. Give rooms (room type and optionally the physical room id, with price and currency) and/or products (product id with price and currency). Set assign_rooms to let ZaK pick the physical rooms. This books inventory and is NOT idempotent: calling it twice creates two reservations, so check wubook_get_room_availability first and do not retry on an error without looking the reservation up. POST /kp/reservations/new.
Input Schema
{
"type": "object",
"properties": {
"arrival": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Arrival date, yyyy-mm-dd."
},
"departure": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Departure date, yyyy-mm-dd (after arrival)."
},
"guest": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"surname": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"email": {
"type": "string",
"maxLength": 200,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"phone": {
"type": "string",
"minLength": 3,
"maxLength": 40
}
},
"required": [
"name",
"surname"
],
"additionalProperties": false,
"description": "The booker."
},
"rooms": {
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"room_type": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Room type id (wubook_list_room_types)."
},
"room": {
"description": "Physical room id (wubook_list_rooms); leave out with assign_rooms.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"price": {
"type": "number",
"minimum": 0,
"maximum": 10000000
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"required": [
"room_type",
"price",
"currency"
],
"additionalProperties": false
}
},
"products": {
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"product": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Product id (wubook_list_products)."
},
"price": {
"type": "number",
"minimum": 0,
"maximum": 10000000
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"required": [
"product",
"price",
"currency"
],
"additionalProperties": false
}
},
"assign_rooms": {
"description": "Let ZaK choose physical rooms for entries without a room id.",
"type": "boolean"
}
},
"required": [
"arrival",
"departure",
"guest"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴wubook_check_in(reservation_id, reservation_code, room_customer_ids)
WRITE: check in the guests of a reservation in ZaK. Applies to every guest of the reservation unless room_customer_ids is given. POST /kp/reservations/do_checkin.
Input Schema
{
"type": "object",
"properties": {
"reservation_id": {
"description": "Reservation id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"reservation_code": {
"type": "string",
"minLength": 2,
"maxLength": 40,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$",
"description": "Reservation (human) code such as XY-0001."
},
"room_customer_ids": {
"description": "Only these reservation-room guest ids (default: all guests).",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴wubook_check_out(reservation_id, reservation_code, room_customer_ids)
WRITE: check out the guests of a reservation in ZaK. Applies to every guest of the reservation unless room_customer_ids is given. POST /kp/reservations/do_checkout.
Input Schema
{
"type": "object",
"properties": {
"reservation_id": {
"description": "Reservation id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"reservation_code": {
"type": "string",
"minLength": 2,
"maxLength": 40,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$",
"description": "Reservation (human) code such as XY-0001."
},
"room_customer_ids": {
"description": "Only these reservation-room guest ids (default: all guests).",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴wubook_undo_check_in(reservation_id, reservation_code)
WRITE: revert the check-in of a reservation in ZaK. POST /kp/reservations/undo_checkin.
Input Schema
{
"type": "object",
"properties": {
"reservation_id": {
"description": "Reservation id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"reservation_code": {
"type": "string",
"minLength": 2,
"maxLength": 40,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$",
"description": "Reservation (human) code such as XY-0001."
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴wubook_undo_check_out(reservation_id, reservation_code)
WRITE: revert the check-out of a reservation in ZaK. POST /kp/reservations/undo_checkout.
Input Schema
{
"type": "object",
"properties": {
"reservation_id": {
"description": "Reservation id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"reservation_code": {
"type": "string",
"minLength": 2,
"maxLength": 40,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$",
"description": "Reservation (human) code such as XY-0001."
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wubook_get_customer(customer_id, include_documents)
One guest record by customer id (from a reservation's booker or room customers): name, country, address, contact, birth data, billing info. Personal data. Identity documents (type, number, expiry) are left out unless include_documents is true. POST /kp/customers/fetch_one.
Input Schema
{
"type": "object",
"properties": {
"customer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Customer id."
},
"include_documents": {
"description": "Also return the guest's identity documents (default false).",
"type": "boolean"
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence