mcpField
H
Hostaway MCP by usefulapi

Hostaway MCP by usefulapi

远程服务
usefulapi.io地图与出行0今天更新

关于 Hostaway MCP by usefulapi

Hostaway MCP by usefulapi 是面向 Hostaway 住宿运营者的托管服务。它将房源、预订、日历、客人沟通及运营相关的读取和部分写入操作提供给 MCP 客户端,无需本地安装。

主要功能

  1. 01浏览房源和预订
  2. 02查看日历并计算报价
  3. 03查看对话和客人评价
  4. 04创建和更新预订
  5. 05更新日历并给客人发消息
  6. 06创建和管理任务

适用场景

  1. 01查询空房并计算住宿报价
  2. 02查看预订变更和客人对话
  3. 03创建或更新预订
  4. 04发送客人消息或分配任务

MCP 相关

它向 MCP 客户端提供 Hostaway 数据和操作工具,包括预订、日历、消息及任务操作。服务以远程托管方式运行,并使用 Hostaway 账户凭据。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://hostaway.usefulapi.io/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

20
参数类型必填说明
citystring否城市。
limitinteger否返回记录的最大数量(1-500)。
matchstring否按房源名称搜索。
offsetinteger否从开头跳过的记录数。
countrystring否国家/地区。
sortOrderenum否排序顺序。name | nameReversed | order | orderReversed | contactName | contactNameReversed | latestActivity | latestActivityDesc
specialStatusarray否按状态筛选;省略时同时包含启用和归档的房源。
propertyTypeIdinteger否房源类型 ID。
includeResourcesboolean否包含附加的子资源(以 includeResources=1 发送)。
availabilityDateEndstring否仅包含在此日期之前可订的房源(YYYY-MM-DD)。
availabilityDateStartstring否仅包含从此日期起可订的房源(YYYY-MM-DD)。
availabilityGuestNumberinteger否仅包含可容纳此人数的房源。

详细介绍

usefulapi 的 Hostaway MCP

通过 Claude、Cursor 或任何 MCP 客户端使用 Hostaway——读取房源、预订、日历、对话、评价和业主对账单,并创建预订、更新日历、向房客发送消息和管理任务。 托管服务,无需本地安装:使用你自己的 Hostaway 凭据进行连接。

在线端点: https://hostaway.usefulapi.io/mcp · 主页: https://usefulapi.io/hostaway

连接

  • Claude(claude.ai、Desktop):打开 自定义 → 连接器,点击 + 添加 → 添加自定义连接器,然后粘贴 https://hostaway.usefulapi.io/mcp。
  • Claude Code: 运行 claude mcp add --transport http hostaway https://hostaway.usefulapi.io/mcp,然后运行 /mcp 登录。
  • VS Code: 添加到 VS Code。
  • Cursor 和其他客户端: 将 URL 添加为远程 MCP 服务:
{
  "mcpServers": {
    "hostaway": {
      "url": "https://hostaway.usefulapi.io/mcp"
    }
  }
}

只添加 URL。请勿在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Hostaway 凭据。

分步设置说明、凭据查找位置和常见问题:https://usefulapi.io/hostaway/

首次连接时,你需要提供 Hostaway 账户 ID 和 API 密钥(设置 → Hostaway API)。 系统会验证凭据,按用户分别存储,并限定为你本人使用——配置文件中不会包含任何密钥。

工具

工具类型功能
hostaway_list_listings读取列出房源
hostaway_get_listing读取获取一个房源
hostaway_list_reservations读取列出预订
hostaway_get_reservation读取获取一笔预订
hostaway_get_reservation_logs读取获取预订变更历史
hostaway_get_calendar读取获取房源日历
hostaway_calculate_price读取报价住宿费用
hostaway_list_conversations读取列出房客对话
hostaway_list_conversation_messages读取阅读对话
hostaway_list_reviews读取列出评价
hostaway_list_tasks读取列出任务
hostaway_list_expenses读取列出费用和附加项目
hostaway_list_owner_statements读取列出业主对账单
hostaway_get_owner_statement读取获取一份业主对账单
hostaway_create_reservation写入创建预订
hostaway_update_reservation写入更新预订
hostaway_update_calendar写入更新房源日历
hostaway_send_message写入向房客发送消息
hostaway_create_task写入创建任务
hostaway_update_task写入更新任务
hostaway_usage_status元数据使用情况(免费套餐用量计量)
hostaway_request_feature元数据申请添加缺少的功能
hostaway_upgrade元数据升级到 Pro(无限*)
hostaway_cancel_subscription元数据取消 Pro 订阅

read 工具仅用于读取;write 工具会更改数据(客户端应在执行前确认);meta 工具用于报告用量、管理订阅或发送功能申请。

定价

套餐价格限额
免费$0每月 50 次工具调用
Pro(按用户计费)$9/月 或 $90/年(免费 2 个月)无限*

*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。需要更多调用,请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 hostaway_upgrade 订阅(它会返回 Stripe Checkout 链接)。你可以随时使用 hostaway_cancel_subscription 取消:Pro 服务会持续到付费周期结束,当前周期不予退款;在此之前运行 hostaway_upgrade 可撤销取消操作。也可以发送邮件至 [email protected]。

许可证

MIT © usefulapi。与 Hostaway 无关联,也未获其认可。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。