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 集成

Ably MCP by usefulapi

io.usefulapi官方发布者

面向 Ably 的托管 MCP 服务器，让助手查看实时频道、在线状态与用量统计、发布消息，并查看应用配置。

Streamable HTTP可网页运行
沟通与协作15 个工具Nov 14, 2026

Oyster MCP by usefulapi

io.usefulapi官方发布者

面向 Oyster 的远程 MCP 服务器，让助手读取团队、休假、报销、合同与发票数据，并审批或拒绝相关申请。

Streamable HTTP可网页运行
效率与工作流20 个工具Nov 14, 2026

Avirato MCP by usefulapi

io.usefulapi官方发布者

读取 Avirato 酒店 PMS 的预订、可用房、房价与餐标数据，并可在预订上登记现金付款。

Streamable HTTP可网页运行
金融23 个工具Nov 14, 2026

Willo MCP by usefulapi

io.usefulapi官方发布者

托管的只读 MCP 服务器，让助手列出 Willo 账户中的面试、参与者和部门元数据。

Streamable HTTP可网页运行
数据与分析3 个工具Nov 14, 2026

Testlify MCP by usefulapi

io.usefulapi官方发布者

托管型 MCP 服务器，让助手读取 Testlify 招聘工作区的资料、测评和测评候选人。

Streamable HTTP可网页运行
效率与工作流3 个工具Nov 14, 2026