Beds24 MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.39.1更新於 Nov 14, 2026

Check bookings, quote stays, read guest messages and reviews, and update calendars in Beds24.

發布方自己的服務:Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行效率與工作流商業與電商

概覽

AI 產生的概覽

託管的 Beds24 連接器,讓助理查詢訂房、報價房型、讀取旅客訊息與評價,並更新房況日曆。

可以做什麼
  • 檢查權杖並列出房源及其房型與設定
  • 依條件搜尋與讀取訂房、發票以及各通路的旅客對話
  • 為住宿報價,並查看可訂狀態、房間占用、日曆與固定價格規則
  • 讀取 Booking.com 與 Airbnb 的旅客評價
  • 建立或修改訂房、傳送旅客訊息、標記訊息已讀、修改房況日曆數值
  • 查看用量並管理付費訂閱方案
適用情境
適合房東與房源管理者讓助理查詢入住訂房、空房與價格,追蹤未讀的旅客訊息與評價,或不必開啟 Beds24 就能調整日曆與訂房。
執行需求
遠端 MCP 端點,只需填入 URL 連線;透過 OAuth 登入,登入頁會要求 Beds24 邀請碼,或 Beds24 API 設定中的更新權杖/唯讀長效權杖。用戶端設定不要放 API 金鑰或 Authorization 標頭。免費方案每月 50 次工具呼叫。
安裝前請注意
寫入類工具會建立與修改訂房、經旅客所在通路傳送訊息(無法收回),以及修改會同步到各通路的日曆,執行前應先確認。Beds24 憑證由託管服務依使用者儲存。付費方案透過 Stripe 結帳連結付款,取消後當期不退費。

安裝

在 SourceWeft 中

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

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Fbeds24/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

README

Beds24 MCP by usefulapi

Use Beds24 from Claude, Cursor, or any MCP client — check bookings, quote stays, read guest messages and reviews, and update your calendar. Hosted, no local install: connect with your own Beds24 credentials.

Live endpoint: https://beds24.usefulapi.io/mcp · Homepage: https://usefulapi.io/beds24

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://beds24.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http beds24 https://beds24.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": {    "beds24": {      "url": "https://beds24.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 Beds24 credentials.

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

On first connect you'll provide a Beds24 invite code (or a refresh or read-only long life token) from Beds24 → Settings → Account → API. They're validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
beds24_get_token_detailsreadGet token details
beds24_list_propertiesreadList properties
beds24_list_bookingsreadList bookings
beds24_get_bookingreadGet a booking
beds24_list_booking_messagesreadList booking messages
beds24_list_booking_invoicesreadList booking invoices
beds24_get_room_offersreadGet room offers (quote)
beds24_get_room_availabilityreadGet room availability
beds24_get_unit_bookingsreadGet unit bookings (occupancy grid)
beds24_get_room_calendarreadGet room calendar
beds24_list_fixed_pricesreadList fixed prices
beds24_list_booking_com_reviewsreadList Booking.com reviews
beds24_list_airbnb_reviewsreadList Airbnb reviews
beds24_create_bookingwriteCreate a booking
beds24_update_bookingwriteUpdate a booking
beds24_send_booking_messagewriteSend a booking message
beds24_mark_messages_readwriteMark messages read
beds24_update_room_calendarwriteUpdate room calendar
beds24_usage_statusmetaUsage status (free-tier meter)
beds24_request_featuremetaRequest a missing feature
beds24_upgrademetaUpgrade to Pro or Pro+
beds24_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 user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run beds24_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 beds24_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 beds24_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Beds24.

來源:servers/beds24/README.md,提交 3c1b3df

工具

18

beds24_get_token_details

Get token details

Check the configured Beds24 token: whether it is valid, its scopes, owner id, expiry, and whether it is restricted to one property. A cheap way to confirm setup and see which scopes are granted. Note Beds24 answers HTTP 200 with validToken=false for a bad token. Beds24: GET /authentication/details.

無需輸入參數。

beds24_list_properties

List properties

List the properties in the account with their address, currency, check-in times and room types (roomTypes). Optional flags include texts, pictures, offers, unit details and all rooms. Requires the properties scope. Beds24: GET /properties.

輸入參數pageroomIdspropertyIdsincludeTextsincludeOffersincludeAllRoomsincludePicturesincludeLanguagesincludePriceRulesincludeUnitDetailsincludeUpsellItems

beds24_list_bookings

List bookings

Search bookings by arrival/departure date range, booking or modified time, property, room, channel, status, or a free-text search over guest name, email, booking id and API reference. With NO filters Beds24 returns only upcoming bookings. `filter` shortcuts: arrivals (arriving today), departures (departing today), new (created in the last 24h), current (in-house). Guest data needs the bookings-personal scope, invoice items bookings-financial. Beds24: GET /bookings.

輸入參數pagefilterstatusarrivalchannelroomIdsarrivalTodeparturemasterIdsbookingIdsmodifiedToarrivalFrom另有 12 個

beds24_get_booking

Get a booking

Fetch one booking by id with its invoice items, info items and additional guests. Works for any status, including cancelled. Beds24: GET /bookings?id=<id>.

輸入參數bookingId必填

beds24_list_booking_messages

List booking messages

Read the guest conversation on bookings — messages from guests, host replies, internal notes and system messages — across channels (Airbnb, Booking.com, Vrbo, direct). Filter by booking, property, room, read/unread, source and age. Beds24: GET /bookings/messages.

輸入參數pagefiltermaxAgesourceroomIdsmasterIdsbookingIdsmessageIdspropertyIds

beds24_list_booking_invoices

List booking invoices

List invoices and their line items (charges and payments) for bookings. Requires the bookings-financial scope. Beds24 marks this endpoint Alpha. Beds24: GET /bookings/invoices.

輸入參數pagebookingIds

beds24_get_room_offers

Get room offers (quote)

Quote a stay: bookable offers with total price and units available per room for given dates and guests. Use before creating a booking. Beds24: GET /inventory/rooms/offers.

輸入參數pagearrival必填roomIdsofferIdsagentCodedeparture必填numAdults必填numChildrenpropertyIdsincludeTexts

beds24_get_room_availability

Get room availability

Per-date availability (true/false) for rooms over a range of nights. endDate is the LAST NIGHT (the day before check-out). Beds24: GET /inventory/rooms/availability.

輸入參數pageendDateroomIdsstartDatepropertyIds

beds24_get_unit_bookings

Get unit bookings (occupancy grid)

Which units of each room type are booked on each date — an occupancy grid keyed by date. endDate is the last night. Beds24 marks this endpoint Beta. Beds24: GET /inventory/rooms/unitBookings.

輸入參數pageendDateroomIdsstartDatepropertyIds

beds24_get_room_calendar

Get room calendar

Per-day calendar values for rooms: units available, min/max stay, multiplier, override (blackout, no check-in, ...) and the price slots price1..price16, as date ranges. Choose fields with the include flags; if none are set this tool asks for numAvail, minStay, maxStay, override and prices. Beds24: GET /inventory/rooms/calendar.

輸入參數pageendDate必填roomIdsstartDate必填propertyIdsincludePricesincludeMaxStayincludeMinStayincludeChannelsincludeNumAvailincludeOverrideincludeMultiplier另有 1 個

beds24_list_fixed_prices

List fixed prices

List fixed price rules (seasonal rates): date span, min/max nights, per-room and per-person prices, discounts, allowed arrival days and channel export. Beds24: GET /inventory/fixedPrices.

輸入參數pageroomIdspropertyIdsfixedPriceIdsincludeRateCodes

beds24_list_booking_com_reviews

List Booking.com reviews

Guest reviews from Booking.com for one property, made on or after a date: scores, content, reviewer and any reply. At most 100 per call. Beds24 marks this endpoint Alpha. Beds24: GET /channels/booking/reviews.

輸入參數from必填propertyId必填

beds24_list_airbnb_reviews

List Airbnb reviews

Guest reviews from Airbnb for one room: overall and category ratings, public review, private feedback and the host response. At most 100 per call. Beds24 marks this endpoint Beta. Beds24: GET /channels/airbnb/reviews.

輸入參數roomId必填

beds24_create_booking

Create a booking

Create a new booking in a room for given dates and guest details. It immediately blocks inventory and is synced to connected channels. Set checkAvailability=true to refuse the booking if the room is not free, and notifyGuest / notifyHost to send confirmation emails. Undo by setting status cancelled with beds24_update_booking. Requires a token with bookings write access. Beds24: POST /bookings.

輸入參數taxcitylangemailnotesphonepricestatetitlemobileroomId必填status另有 22 個

beds24_update_booking

Update a booking

Change an existing booking: dates, room/unit, guest counts, guest details, notes, flag, price, or status (e.g. confirmed, or cancelled to cancel — reversible by setting it back). Only the fields you pass change. Optionally add info items (code/text pairs). Changes sync to channels where allowed. Beds24: POST /bookings with the booking id.

輸入參數taxcitylangemailnotesphonepricestatetitlemobileroomIdstatus另有 21 個

beds24_send_booking_message

Send a booking message

Send a message on a booking's conversation. With source host (default) it is delivered to the GUEST through their channel (Airbnb, Booking.com, Vrbo, email) and cannot be unsent; with source internalNote it is a private host note. Beds24: POST /bookings/messages.

輸入參數sourcemessage必填bookingId必填

beds24_mark_messages_read

Mark messages read

Mark one or more booking messages as read (or unread with read=false). Beds24: POST /bookings/messages with [{ id, read }].

輸入參數readmessageIds必填

beds24_update_room_calendar

Update room calendar

Set per-day calendar values for ONE room over a date range: units available (numAvail), minStay, maxStay, multiplier, override (none, blackout, exception, noCheckIn, noCheckOut, noCheckInOrCheckOut) and price slots price1..price16. Set a price to null to remove it. These values sync to channels. Read the current values first with beds24_get_room_calendar so you can restore them. Beds24: POST /inventory/rooms/calendar.

輸入參數to必填from必填price1price2price3price4price5price6price7price8price9roomId必填另有 12 個

版本歷史

25
  1. v1.39.1最新Nov 13, 2026
  2. v1.38.0Nov 12, 2026
  3. v1.37.3Nov 11, 2026
  4. v1.36.5Nov 8, 2026
  5. v1.36.4Nov 7, 2026
  6. v1.35.3Nov 5, 2026
  7. v1.35.2Nov 5, 2026
  8. v1.35.1Nov 4, 2026
  9. v1.35.0Nov 3, 2026
  10. v1.34.1Nov 3, 2026
  11. v1.33.0Nov 1, 2026
  12. v1.31.0Oct 31, 2026
  13. v1.30.0Oct 31, 2026
  14. v1.29.2Oct 30, 2026
  15. v1.29.0Oct 30, 2026
  16. v1.24.0Oct 26, 2026
  17. v1.21.3Oct 25, 2026
  18. v1.21.0Oct 25, 2026
  19. v1.20.0Oct 24, 2026
  20. v1.17.0Oct 23, 2026
  21. v1.16.4Oct 22, 2026
  22. v1.16.3Oct 21, 2026
  23. v1.11.1Oct 9, 2026
  24. v1.10.0Oct 9, 2026
  25. v1.0.0Sep 30, 2026

評分

已滿足適用檢查項的 100%

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

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

其他 Usefulapi 整合