WuBook MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.11.3更新于 Nov 7, 2026

Read WuBook ZaK rooms, availability and reservations; manage inventory and guest check-in.

发布方自己的服务：Ably MCP by usefulapi

已验证Streamable HTTP可网页运行效率与工作流商业与电商

服务详情

标识符: io.usefulapi/wubook
传输: Streamable HTTP
运行时: Web executable
信任: Verified
发布于: Oct 30, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此服务的命名空间属于 usefulapi.io，且该域名同时运行其端点。这可以确认发布者，但并不代表该服务的工具是安全的。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.usefulapi%2Fwubook.svg)](https://sourceweft.com/mcp/io.usefulapi%2Fwubook?utm_source=readme&utm_medium=badge)

概览

AI 生成的概览

面向 WuBook ZaK 酒店的远程 MCP 服务器：读取房型、房价、可用房与预订，并可管理库存和办理入住。

可以做什么: 列出酒店基础配置：房间、房型、房价、产品、餐食方案、附加项与库存符号
查询某段住宿的可用房，并读取某个房价的每日价格与限制
更新某个房价的每日价格、可用房与住宿限制
按编号或代码查询预订，按日期范围列出预订，查看今日到店、离店与在住
创建预订，为客人办理入住或退房，也可撤销入住与退房
查询客人档案，以及查看用量、提交功能请求、升级或取消套餐
适用场景: 适合使用 WuBook ZaK 的酒店或物业管理者，希望助手在不打开 PMS 的情况下回答可用房与预订问题、查看今日到店离店，或调整价格与可用房。
运行要求: 以 URL 形式添加远程端点 wubook.usefulapi.io/mcp；服务器通过 OAuth 登录，登录页要求填写 WuBook 凭据。需要 WuBook ZaK 物业 API 密钥、Essentials 模块以及 WuBook 工作人员开通 API。仅覆盖 ZaK，不含 Wired 渠道管理器。免费套餐每月 50 次工具调用，付费套餐按 API 密钥计费。

安装前请注意

写入类工具会改动可售库存与预订：更新库存可能推送到已连接的 OTA，创建预订会占用库存且不具幂等性，重复调用会产生重复预订。入住与退房工具会改变客人状态。客人档案属于个人数据，仅在 include_documents 为 true 时返回身份证件。付费套餐涉及支付链接与订阅；重新生成 API 密钥会创建新的计费身份。

安装

在 SourceWeft 中

打开控制台中的 WuBook MCP by usefulapi，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fwubook/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "wubook-by-usefulapi": {
      "type": "http",
      "url": "https://wubook.usefulapi.io/mcp"
    }
  }
}

README

WuBook MCP by usefulapi

Live endpoint: https://wubook.usefulapi.io/mcp

Connect

Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://wubook.usefulapi.io/mcp.
Claude Code: claude mcp add --transport http wubook https://wubook.usefulapi.io/mcp, then run /mcp to log in.
VS Code: Add to VS Code.
Cursor and other clients: add the URL as a remote MCP server:

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your WuBook credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/wubook/

Connect with your WuBook ZaK property API key from Settings → Configurations → ZaK API. The Essentials Module and API activation by WuBook staff are required. This integration covers ZaK, not the Wired channel manager API. Inventory changes affect bookable availability and reservations; review writes before running them. Regenerating the API key creates a new usefulapi billing identity.

Tools

Tool	Type	What it does
`wubook_list_rooms`	read	List rooms
`wubook_list_room_types`	read	List room types
`wubook_list_rates`	read	List rates
`wubook_list_products`	read	List products
`wubook_list_meal_boards`	read	List meal boards
`wubook_list_extras`	read	List extras
`wubook_get_inventory_symbols`	read	Get inventory symbols
`wubook_get_room_availability`	read	Get room availability
`wubook_get_rate_values`	read	Get rate values
`wubook_update_inventory`	write	Update prices, availability and restrictions
`wubook_get_reservation`	read	Get reservation
`wubook_list_reservations`	read	List reservations
`wubook_list_todays_reservations`	read	List today's reservations
`wubook_create_reservation`	write	Create reservation
`wubook_check_in`	write	Check in
`wubook_check_out`	write	Check out
`wubook_undo_check_in`	write	Undo check-in
`wubook_undo_check_out`	write	Undo check-out
`wubook_get_customer`	read	Get customer (guest)
`wubook_usage_status`	meta	Usage status (free-tier meter)
`wubook_request_feature`	meta	Request a missing feature
`wubook_upgrade`	meta	Upgrade to Pro or Pro+
`wubook_cancel_subscription`	meta	Cancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with wubook_upgrade (it returns a Stripe Checkout link). Cancel any time with wubook_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running wubook_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT

来源：servers/wubook/README.md，提交 4046075

工具

wubook_list_rooms

List rooms

List the physical rooms of the property (id, room type id, name, tags). POST /kp/property/fetch_rooms.

无需输入参数。

wubook_list_room_types

List room types

List the room types (id, name, short name, default price, default occupancy). POST /kp/property/fetch_room_types.

无需输入参数。

wubook_list_rates

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.

无需输入参数。

wubook_list_products

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.

无需输入参数。

wubook_list_meal_boards

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.

无需输入参数。

wubook_list_extras

List extras

List the extras the property sells (id, name, price, VAT percentage, cost, tags). POST /kp/property/fetch_extras.

无需输入参数。

wubook_get_inventory_symbols

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.

无需输入参数。

wubook_get_room_availability

Get room availability

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.

输入参数arrival必填departure必填

wubook_get_rate_values

Get rate values

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.

输入参数days必填from必填rate_id必填

wubook_update_inventory

Update prices, availability and restrictions

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.

输入参数from必填rate_id必填products必填

wubook_get_reservation

Get reservation

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.

输入参数reservation_idreservation_code

wubook_list_reservations

List reservations

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.

输入参数limitoffsetarrival_tocreated_toarrival_fromcreated_fromdeparture_todeparture_from

wubook_list_todays_reservations

List today's reservations

Reservations of the property for today (arrivals, departures and stays in house). POST /kp/reservations/fetch_today_reservations.

无需输入参数。

wubook_create_reservation

Create reservation

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.

输入参数guest必填roomsarrival必填productsdeparture必填assign_rooms

wubook_check_in

Check in

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.

输入参数reservation_idreservation_coderoom_customer_ids

wubook_check_out

Check out

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.

输入参数reservation_idreservation_coderoom_customer_ids

wubook_undo_check_in

Undo check-in

WRITE: revert the check-in of a reservation in ZaK. POST /kp/reservations/undo_checkin.

输入参数reservation_idreservation_code

wubook_undo_check_out

Undo check-out

WRITE: revert the check-out of a reservation in ZaK. POST /kp/reservations/undo_checkout.

输入参数reservation_idreservation_code

wubook_get_customer

Get customer (guest)

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.

输入参数customer_id必填include_documents