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"
}社区
证据