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可網頁執行效率與工作流商業與電商

概覽

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 中

  1. 開啟 儀表板中的 WuBook MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

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:
json
{  "mcpServers": {    "wubook": {      "url": "https://wubook.usefulapi.io/mcp"    }  }}

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

ToolTypeWhat it does
wubook_list_roomsreadList rooms
wubook_list_room_typesreadList room types
wubook_list_ratesreadList rates
wubook_list_productsreadList products
wubook_list_meal_boardsreadList meal boards
wubook_list_extrasreadList extras
wubook_get_inventory_symbolsreadGet inventory symbols
wubook_get_room_availabilityreadGet room availability
wubook_get_rate_valuesreadGet rate values
wubook_update_inventorywriteUpdate prices, availability and restrictions
wubook_get_reservationreadGet reservation
wubook_list_reservationsreadList reservations
wubook_list_todays_reservationsreadList today's reservations
wubook_create_reservationwriteCreate reservation
wubook_check_inwriteCheck in
wubook_check_outwriteCheck out
wubook_undo_check_inwriteUndo check-in
wubook_undo_check_outwriteUndo check-out
wubook_get_customerreadGet customer (guest)
wubook_usage_statusmetaUsage status (free-tier meter)
wubook_request_featuremetaRequest a missing feature
wubook_upgrademetaUpgrade to Pro or Pro+
wubook_cancel_subscriptionmetaCancel 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

PlanPriceLimit
Free$050 tool calls / month
Pro (per API key)$9/mo or $90/yr (2 months free)Unlimited*

*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

工具

19

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

版本歷史

11
  1. v1.11.3最新Nov 7, 2026
  2. v1.10.3Nov 5, 2026
  3. v1.10.2Nov 5, 2026
  4. v1.10.1Nov 4, 2026
  5. v1.10.0Nov 3, 2026
  6. v1.9.1Nov 3, 2026
  7. v1.8.0Nov 1, 2026
  8. v1.6.0Oct 31, 2026
  9. v1.5.0Oct 31, 2026
  10. v1.4.2Oct 30, 2026
  11. v1.4.0Oct 30, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合