WuBook MCP by usefulapi
Read WuBook ZaK rooms, availability and reservations; manage inventory and guest check-in.
我該用這個嗎
品質與安全性
發現項目（1）
- LOWTool 'wubook_list_todays_reservations' name length outside 3-30 range在 wubook_list_todays_reservations 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"wubook": {
"url": "https://wubook.usefulapi.io/mcp"
}
}
}遠端端點
https://wubook.usefulapi.io/mcpstreamable-http它能做什麼
工具清單
工具（19）
🟢wubook_list_rooms
List the physical rooms of the property (id, room type id, name, tags). POST /kp/property/fetch_rooms.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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"
}社群
證據