关于 Hostaway MCP by usefulapi
Hostaway MCP by usefulapi 是面向 Hostaway 住宿运营者的托管服务。它将房源、预订、日历、客人沟通及运营相关的读取和部分写入操作提供给 MCP 客户端,无需本地安装。
主要功能
- 01浏览房源和预订
- 02查看日历并计算报价
- 03查看对话和客人评价
- 04创建和更新预订
- 05更新日历并给客人发消息
- 06创建和管理任务
适用场景
- 01查询空房并计算住宿报价
- 02查看预订变更和客人对话
- 03创建或更新预订
- 04发送客人消息或分配任务
MCP 相关
它向 MCP 客户端提供 Hostaway 数据和操作工具,包括预订、日历、消息及任务操作。服务以远程托管方式运行,并使用 Hostaway 账户凭据。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://hostaway.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-hostaway https://hostaway.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-hostaway":{"type":"http","url":"https://hostaway.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-hostaway":{"type":"http","url":"https://hostaway.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-hostaway":{"type":"http","url":"https://hostaway.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-hostaway":{"serverUrl":"https://hostaway.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
20| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| city | string | 否 | 城市。 |
| limit | integer | 否 | 返回记录的最大数量(1-500)。 |
| match | string | 否 | 按房源名称搜索。 |
| offset | integer | 否 | 从开头跳过的记录数。 |
| country | string | 否 | 国家/地区。 |
| sortOrder | enum | 否 | 排序顺序。name | nameReversed | order | orderReversed | contactName | contactNameReversed | latestActivity | latestActivityDesc |
| specialStatus | array | 否 | 按状态筛选;省略时同时包含启用和归档的房源。 |
| propertyTypeId | integer | 否 | 房源类型 ID。 |
| includeResources | boolean | 否 | 包含附加的子资源(以 includeResources=1 发送)。 |
| availabilityDateEnd | string | 否 | 仅包含在此日期之前可订的房源(YYYY-MM-DD)。 |
| availabilityDateStart | string | 否 | 仅包含从此日期起可订的房源(YYYY-MM-DD)。 |
| availabilityGuestNumber | integer | 否 | 仅包含可容纳此人数的房源。 |
详细介绍
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 无关联,也未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。