Skip to content
MCP server

WuBook MCP by usefulapi

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

Install
Runs
Remotely
Version
1.15.0
Listing updated
4 days ago

About WuBook MCP by usefulapi

WuBook MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http wubook https://wubook.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://wubook.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "wubook": {
      "url": "https://wubook.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "wubook": {
      "type": "http",
      "url": "https://wubook.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "wubook": {
      "serverUrl": "https://wubook.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (19)

Read directly from the server.

wubook_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 the room types (id, name, short name, default price, default occupancy). POST /kp/property/fetch_room_types.
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.
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.
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.
wubook_list_extras
List the extras the property sells (id, name, price, VAT percentage, cost, tags). POST /kp/property/fetch_extras.
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.
wubook_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.
wubook_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.
wubook_update_inventory
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.
wubook_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.
wubook_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.
wubook_list_todays_reservations
Reservations of the property for today (arrivals, departures and stays in house). POST /kp/reservations/fetch_today_reservations.
wubook_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
wubook_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.
wubook_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.
wubook_undo_check_in
WRITE: revert the check-in of a reservation in ZaK. POST /kp/reservations/undo_checkin.
wubook_undo_check_out
WRITE: revert the check-out of a reservation in ZaK. POST /kp/reservations/undo_checkout.
wubook_get_customer
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.

WuBook MCP by usefulapi FAQ

How do I add WuBook MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http wubook https://wubook.usefulapi.io/mcp