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" } }}