io.usefulapi由 usefulapi.io 發布官方發布者v1.0.0更新於 Nov 14, 2026
Read reservations, availability, rates and prices; record cash payments in Avirato.
發布方自己的服務：Ably MCP by usefulapi
讀取 Avirato 飯店 PMS 的訂房、可用房、房價與餐食方案資料，並可在訂房上登記現金付款。
Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/io.usefulapi%2Favirato/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。把它新增到你客戶端的 mcpServers 設定中。
{
"mcpServers": {
"avirato-by-usefulapi": {
"type": "http",
"url": "https://avirato.usefulapi.io/mcp"
}
}
}Use your Avirato account from Claude, Cursor, or any MCP client. It reads reservations, availability, rates, prices and meal plans, and records cash payments on bookings. Hosted, no local install: connect with your own credentials.
Live endpoint: https://avirato.usefulapi.io/mcp · Homepage: https://usefulapi.io
https://avirato.usefulapi.io/mcp.claude mcp add --transport http avirato https://avirato.usefulapi.io/mcp, then run /mcp to log in.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 Avirato credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/avirato/
On first connect you provide the API user email, the API user password and the establishment code (webCode). Create the API user in Avirato under Configuración → Mi cuenta → Usuarios y seguridad, and tick only API. Find the establishment code at the end of the link from Configuración → Canales de venta → Motor de reservas → Generador de enlaces. The server validates it and stores it per user. No keys go in config files.
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.
Each paid plan covers this server only. Ask your AI to run avirato_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with avirato_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with avirato_upgrade before then undoes the cancel. Or write to [email protected].
MIT — see LICENSE. Documentation only; the server is hosted.
來源：servers/avirato/README.md，提交 d5cb945
List reservations between dates
Reservations of the establishment between two dates (reservation id, channel booking id, room, rate, guest name and document, check-in/out, price, paid and outstanding, status, notes) plus a summary of counts by status. Dates are whole days (yyyy-mm-dd) or exact date-times. GET /reservation/betweenDates.
end_date必填start_date必填Get a reservation
One reservation by the hotel's own booking id, or by a channel's booking id together with the channel (operator) id. Returns the booking(s) with guest, room, rate, dates, price, paid and outstanding amounts and status. Card data is never returned. GET /reservation/{bookingId}.
booking_id必填operator_idGet reservation details
Extended information of one reservation by its booking id (the reservationInfo view). Card data is never returned. GET /reservation/reservationInfo.
booking_id必填Get related reservations
A reservation with the other reservations of the same group (master booking and its related rooms). Card data is never returned. GET /reservation/related/{reservationId}.
reservation_id必填List all reservations
Every reservation of the establishment in the PMS (can be a very large list for an old hotel; prefer avirato_list_reservations with a date range). Returns `limit` entries from `offset` (default the first 100), the total count and next_offset. Card data is never returned. GET /reservation/allReservations.
limitoffsetList booking channels
The sales channels (operators: OTAs, own website, ...) that book into the establishment, with their operator ids (used by avirato_get_reservation). GET /reservation/operators.
無需輸入參數。
Check availability
Availability of rooms for a stay: which room types and rooms are free between check-in and check-out, optionally limited to a room category, rooms, room types or zones. GET /availability.
zone_idsspace_idsonline_onlycheck_in_date必填space_type_idcheck_out_date必填space_subtype_idswith_valid_space_idsList available rooms
The free rooms (spaces) of one room category between two dates. GET /availability/availableSpaces.
end_date必填start_date必填space_type_id必填Get unavailable dates of a room
The dates a room (space) is not free from a start date on, ignoring the given booking (useful to check whether a booking can be extended or moved). GET /availability/unavailable-dates.
space_id必填booking_id必填start_date必填Get rooms, diets, extras and availability overview
The booking-engine start data between two dates: room types with descriptions and availability, meal plans (diets), taxes, extras and billing configuration. The quickest way to learn the room type, space type and rate ids of the establishment. GET /rate/init.
end_date必填start_date必填List rates
The rates of the establishment (name, minimum/maximum stay, refundable, linked rate and percentage, release days, room category), optionally only some rate ids and one rate mode. GET /rate.
moderate_idsList rates by room category
All rates of the establishment, optionally limited to some rate ids and room categories (space types). GET /rate/all.
rate_idsspace_type_idsGet a rate
One rate by id: name, stay limits, refundable, linked and master rate, release days and mode. GET /rate/{rateId}.
rate_id必填Get the price of a stay
The final price of a stay for one room type and rate, with discounts and increments applied, for a number of adults, children, meal plan and rooms. GET /rate/getPrice.
dietadultsrate_id必填childrenend_date必填num_roomsstart_date必填space_subtype_id必填Get a price calendar
Prices per room type and rate for each day of a period, with the establishment's taxes. GET /rate/getPricesMap.
end_date必填rate_ids必填start_date必填space_subtype_ids必填Get discounts
The discounts and increments that apply to room types and rates for a period and a number of rooms. GET /rate/discounts.
end_date必填rate_ids必填num_roomsstart_date必填space_subtype_ids必填List meal plans
The meal plans (diets) of the establishment with their ids, as used by the price tools. GET /rate/diets.
無需輸入參數。
List rate release days
The release (minimum advance booking) days of each rate. GET /rate/release.
無需輸入參數。
Get minimum stay restrictions
The minimum-stay restrictions per day for room types and rates over a period. GET /restrictions/minimum-stay.
rate_idsfinal_date必填initial_datespace_subtype_idsGet daily prices of a rate
The daily prices of one rate on one date (per room type and occupancy). GET /dailyPrice.
date必填rate_id必填List promotional packages
The promotional packages of the establishment with their extras. GET /payment/promotionalPackages.
無需輸入參數。
List extras
The extras (additional services) that can be charged on a booking. GET /payment/extras.
無需輸入參數。
Record a cash payment on a booking
WRITE: records a cash payment on an existing booking in the hotel's PMS (it changes the booking's paid and outstanding amounts and cannot be undone through this server). Not idempotent: calling it twice records two payments. Confirm the booking id and the amount with the user first, then pass confirm: true. If the call fails with a network error or timeout the payment may still have been recorded: read the booking (avirato_get_reservation) and check its payments before trying again. Card payments are not supported. POST /payment/addBookingPayment.
amount必填confirm必填datetimebooking_id必填已滿足適用檢查項的 100%
該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。
io.usefulapi官方發布者
針對 Ably 的託管 MCP 伺服器，讓助理檢視頻道、線上狀態與用量統計、發布訊息，並查看應用程式設定。
io.usefulapi官方發布者
面向 Oyster 的遠端 MCP 伺服器，讓助理讀取團隊、休假、費用、合約與發票資料，並核准或拒絕相關申請。
io.usefulapi官方發布者
託管的唯讀 MCP 伺服器，讓助理列出 Willo 帳戶中的面試、參與者與部門中繼資料。
io.usefulapi官方發布者
託管型 MCP 伺服器，讓助理讀取 Testlify 招募工作區的資料、測驗與測驗應試者。
io.usefulapi官方發布者
託管式 Skedway MCP 伺服器，讓助理為使用者辦理工位與停車位預約報到、讀取 API 健康狀態，並管理用量與訂閱。
{ "mcpServers": { "avirato": { "url": "https://avirato.usefulapi.io/mcp" } }}