Smoobu MCP by usefulapi

usefulapi 提供的 Smoobu MCP

通过 Claude、Cursor 或任何 MCP 客户端使用 Smoobu——查看房源、预订、房价、可订状态、住客消息和住客，并创建或更新预订。 托管服务，无需本地安装：使用你自己的 Smoobu 凭据连接。

线上端点： https://smoobu.usefulapi.io/mcp · 主页： https://usefulapi.io/smoobu

连接

• Claude（claude.ai、Desktop）：打开 Customize → Connectors，点击 + Add → Add custom connector，然后粘贴 https://smoobu.usefulapi.io/mcp。
• Claude Code： claude mcp add --transport http smoobu https://smoobu.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将此 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "smoobu": {
      "url": "https://smoobu.usefulapi.io/mcp"
    }
  }
}

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

分步设置指南、凭据查找位置及常见问题解答：https://usefulapi.io/smoobu/

首次连接时，你需要提供 Smoobu API key and API secret（Settings → Advanced → API Keys）。 系统会验证凭据，按用户存储并限定为仅供你使用——配置文件中不会包含任何密钥。

工具

工具	类型	功能
smoobu_get_user	读取	获取当前用户
smoobu_list_apartments	读取	列出房源
smoobu_get_apartment	读取	获取单个房源
smoobu_list_reservations	读取	列出预订
smoobu_get_reservation	读取	获取单个预订
smoobu_list_price_elements	读取	列出预订的价格项目
smoobu_get_reservation_placeholders	读取	获取预订的消息占位符
smoobu_get_rates	读取	获取房价和可订状态
smoobu_check_availability	读取	检查可订状态并估算住宿费用
smoobu_list_message_threads	读取	列出收件箱会话
smoobu_list_reservation_messages	读取	列出预订消息
smoobu_list_guests	读取	列出住客
smoobu_get_guest	读取	获取单个住客
smoobu_list_addons	读取	列出附加项目
smoobu_list_custom_placeholders	读取	列出自定义占位符
smoobu_create_reservation	写入	创建预订
smoobu_update_reservation	写入	更新预订
smoobu_set_rates	写入	设置房价和最短入住天数
smoobu_send_message_to_guest	写入	向住客发送消息
smoobu_send_message_to_host	写入	向房东发送消息
smoobu_usage_status	元数据	使用情况（免费套餐用量计数）
smoobu_request_feature	元数据	请求添加缺失的功能
smoobu_upgrade	元数据	升级到 Pro（无限*）
smoobu_cancel_subscription	元数据	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应在执行前确认）；meta 工具用于报告用量、管理订阅或发送功能请求。

定价

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

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

Pro 仅适用于此服务。使用 smoobu_upgrade 订阅（它会返回一个 Stripe Checkout 链接）。可随时使用 smoobu_cancel_subscription 取消：Pro 仍可使用至已付费周期结束，当前周期不予退款；在此之前运行 smoobu_upgrade 可撤销取消操作。也可发送邮件至 [email protected]。

许可证

MIT © usefulapi。与 Smoobu 无关联，也未获得其认可。