Hostfully MCP by usefulapi

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

Check properties, calendars, leads, quotes, guests and messages in Hostfully, and send replies.

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

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

概覽

AI 產生的概覽

針對 Hostfully 的託管 MCP 伺服器,讓助理讀取房源、行事曆、訂單線索、報價、旅客與訊息,並回覆旅客。

可以做什麼
  • 列出機構、房源、房源詳情、行事曆與價格區間
  • 搜尋並讀取線索(預訂、詢價、行事曆占用)、訂單、旅客、業主與評價
  • 為預計住宿計算報價
  • 讀取各通路的旅客對話與訊息
  • 建立或更新線索、安排服務工作、傳送訊息給旅客
  • 查看用量並管理訂閱方案
適用情境
適合已在使用 Hostfully 的短租房東或代管機構,讓助理回答空房、價格、近期預訂、已排定的清潔工作與旅客對話等問題,或起草並傳送旅客回覆。
執行需求
遠端 streamable HTTP 端點,無需本機安裝。透過 OAuth 登入,登入頁需填寫 Hostfully 機構 API 金鑰,可選填預設機構 UID 與沙盒開關。免費方案每月 50 次工具呼叫,付費方案依使用者計費。
安裝前請注意
寫入類工具會變更真實資料:建立線索或行事曆占用、更新旅客資料、安排工作,以及傳送給真實旅客且無法收回的訊息。旅客姓名、聯絡方式與訊息內容會經過此託管服務。付費方案透過結帳連結扣款,取消後當期不退款。

安裝

在 SourceWeft 中

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

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

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

README

Hostfully MCP by usefulapi

Use Hostfully from Claude, Cursor, or any MCP client — check properties, calendars, leads, quotes, guests and messages, and reply to guests. Hosted, no local install: connect with your own Hostfully credentials.

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

Connect

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

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

On first connect you'll provide your Hostfully agency API key (Agency Settings), plus an optional default agency UID and a sandbox toggle. They're validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
hostfully_list_agenciesreadList agencies
hostfully_list_propertiesreadList properties
hostfully_get_propertyreadGet one property
hostfully_get_property_calendarreadGet a property's calendar
hostfully_get_pricing_periodsreadGet pricing periods
hostfully_search_leadsreadSearch leads and bookings
hostfully_get_leadreadGet one lead or booking
hostfully_calculate_quotereadCalculate a stay quote
hostfully_list_ordersreadList orders
hostfully_list_threadsreadList message threads
hostfully_list_messagesreadList messages
hostfully_list_guestsreadList guests
hostfully_list_jobsreadList jobs
hostfully_list_servicesreadList services
hostfully_list_reviewsreadList guest reviews
hostfully_list_ownersreadList property owners
hostfully_create_leadwriteCreate a calendar block or inquiry
hostfully_update_leadwriteUpdate a lead's notes or guest details
hostfully_send_messagewriteSend a message to a guest
hostfully_create_jobwriteSchedule a job
hostfully_usage_statusmetaUsage status (free-tier meter)
hostfully_request_featuremetaRequest a missing feature
hostfully_upgrademetaUpgrade to Pro or Pro+
hostfully_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 hostfully_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 hostfully_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 hostfully_upgrade before then undoes the cancel. Or write to [email protected].

License

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

來源:servers/hostfully/README.md,提交 f22f848

工具

20

hostfully_list_agencies

List agencies

List the agencies this API key can access, with their UIDs, currency and default check-in/out times. Start here to find the agency_uid other tools need. Hostfully: GET /api/v3.3/agencies.

無需輸入參數。

hostfully_list_properties

List properties

List an agency's properties (rentals) with name, address, type, bedrooms, active flag and pricing/availability settings. Cursor-paginated. Hostfully: GET /api/v3.3/properties.

輸入參數limitcursoragency_uidupdated_since

hostfully_get_property

Get one property

Fetch one property's full details — address, time zone, rooms, pricing and availability settings, channel data, booking notes and cancellation policy. Hostfully: GET /api/v3.3/properties/{propertyUid}.

輸入參數property_uid必填

hostfully_get_property_calendar

Get a property's calendar

Day-by-day availability and pricing for one property over a date range — the direct answer to 'is it free, and at what price?'. Hostfully: GET /api/v3.3/property-calendar/{propertyUid}.

輸入參數to必填from必填property_uid必填availability_comments

hostfully_get_pricing_periods

Get pricing periods

The nightly price, minimum stay and check-in/check-out availability set for each date of one property over a range. Hostfully: GET /api/v3.3/pricing-periods.

輸入參數to必填from必填property_uid必填

hostfully_search_leads

Search leads and bookings

Search leads — Hostfully's word for bookings, inquiries, booking requests and calendar blocks — by agency, property or UIDs, and by check-in/check-out date. Returns status, type, channel, dates and guest info. Give at least one of agency_uid (or the default), property_uid, or lead_uids. Cursor-paginated. Hostfully: GET /api/v3.3/leads.

輸入參數limitcursorlead_uidsagency_uidcheck_in_tocheck_out_toproperty_uidcheck_in_fromupdated_sincecheck_out_from

hostfully_get_lead

Get one lead or booking

Fetch one lead (booking, inquiry, booking request or block) by UID — status, channel, dates, guest information, notes and assignee. Hostfully: GET /api/v3.3/leads/{leadUid}.

輸入參數lead_uid必填

hostfully_calculate_quote

Calculate a stay quote

Price a prospective stay at one property: rent, fees, taxes, security deposit and total for the given dates and party. Computes only — creates nothing. Hostfully: POST /api/v3.3/quotes.

輸入參數guests必填lead_uidpet_countagency_uidproperty_uid必填check_in_date必填check_out_date必填children_count

hostfully_list_orders

List orders

List orders — the money side of a booking: rent, fees, services, adjustments, taxes, channel commission and total. Filter by lead, property, guest or update time (at least one is required). Hostfully: GET /api/v3.3/orders.

輸入參數lead_uidguest_uidproperty_uidupdated_since

hostfully_list_threads

List message threads

List guest-messaging threads for an agency or one lead, with participants and read status. Give lead_uid, or agency_uid (or the default). Cursor-paginated. Hostfully: GET /api/v3.3/threads.

輸入參數limitcursorlead_uidagency_uid

hostfully_list_messages

List messages

Read guest messages (Airbnb, VRBO, Booking.com, email, SMS, WhatsApp, in-app) for a lead, a thread or a whole agency, with sender type, status and content. Give lead_uid, thread_uid, or agency_uid (or the default). Cursor-paginated. Hostfully: GET /api/v3.3/messages.

輸入參數limitcursorlead_uidagency_uidcreated_atthread_uid

hostfully_list_guests

List guests

List the agency's guest records — names, email, phone, address and profile notes. Hostfully: GET /api/v3.3/guests/{agencyUid}.

輸入參數agency_uid

hostfully_list_jobs

List jobs

List operational jobs (cleanings, greetings, maintenance and other services) scheduled in a date window, optionally for given properties and statuses, sorted by start date. Hostfully: GET /api/v3.3/jobs.

輸入參數to必填from必填statusesproperty_uidsmodified_since

hostfully_list_services

List services

List the services an agency offers or schedules (cleaning, transportation, greeting, cooking, tours ...), with provider, price and duration. A service UID is what hostfully_create_job needs. Hostfully: GET /api/v3.3/services.

輸入參數agency_uidcatered_toservice_provider_uid

hostfully_list_reviews

List guest reviews

List guest reviews for a property or a lead — rating, title, content, source, private feedback and the host response. Cursor-paginated. Hostfully: GET /api/v3.3/reviews.

輸入參數sortlimitcursorsourcelead_uidproperty_uidupdated_sincesort_direction

hostfully_list_owners

List property owners

List the agency's property owners — contact details, business name, commission rate and permissions — optionally filtered by a search string. Hostfully: GET /api/v3.3/owners.

輸入參數queryagency_uid

hostfully_create_lead

Create a calendar block or inquiry

Create a lead at one property: status BLOCKED puts an owner/maintenance block on the calendar; status NEW records a guest inquiry (which does not confirm a booking or take payment). Blocks can later be removed in Hostfully; inquiries go through the normal pipeline. Dates are local to the property. Hostfully: POST /api/v3.3/leads.

輸入參數guestnotesstatus必填check_in必填check_out必填agency_uidproperty_uid必填external_booking_id

hostfully_update_lead

Update a lead's notes or guest details

Partially update a lead's notes, extra notes and guest details (name, contact, address, arrival/departure times). Does NOT change dates, party size, property or status. Hostfully may ignore personal-data fields the key is not allowed to edit. Hostfully: PATCH /api/v3.3/leads/{leadUid}.

輸入參數guestnoteslead_uid必填extra_notes

hostfully_send_message

Send a message to a guest

Send a message to the guest of a lead, by EMAIL or as a DIRECT_MESSAGE on the booking channel (Airbnb, VRBO or Booking.com leads only). This reaches a real guest and cannot be unsent — confirm the text first. Hostfully: POST /api/v3.3/messages.

輸入參數text必填type必填subjectlead_uid必填thread_uid

hostfully_create_job

Schedule a job

Schedule a job (e.g. a cleaning or a guest greeting) for a service at a property, optionally tied to a lead. Times are property-local. hostfully_list_services gives the service UID. Hostfully: POST /api/v3.3/jobs.

輸入參數end必填notesstart必填statuslead_uidservice_uid必填property_uid必填

版本歷史

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 整合