Hotel Booking AI MCP

io.github.tourmind-com由 GitHub 账号 tourmind-com 发布v1.0.0更新于 Oct 27, 2026

Consumer hotel search, live rates, booking, order management, and payment via TourMind.

已验证Streamable HTTP可网页运行位置与生活金融商业与电商

概览

AI 生成的概览

TourMind 酒店预订服务器：让 AI 助手搜索酒店、比价实时房价、下单、支付并管理订单。

可以做什么
  • 把地区、地标、商圈或酒店名解析为 TourMind 区域、酒店或坐标
  • 按区域、坐标半径或模糊关键词搜索酒店，并读取酒店静态设施、政策与图片
  • 查询单家或每批最多 20 家酒店的实时房型与报价，并在下单前重新验价、核对库存与取消政策
  • 创建预订，查询与取消当前账号名下的订单
  • 发起支付请求，包括微信支付、支付宝链接或需收银台确认的预支付信息
  • 检查配套 Skill 是否有新版本
适用场景
适合让助手帮消费者查找酒店、比较实时房价并完成下单与支付，也适合一次调用批量比较多家酒店的报价。
运行要求
远程 streamable HTTP 端点 api.tourmind.com/mcp/toc，连接无需请求头。搜索、酒店详情、房价与库存查询可匿名使用。下单、订单查询、取消与支付需要由可信的本地 Skill 或客户端集成提供的 TourMind user_key，不应在对话中粘贴。
安装前请注意
下单、取消与支付会改动真实订单并涉及付款；服务器要求下单前重新验价并由用户确认酒店、日期、入住人数与价格。受保护操作需要 user_key，应在客户端配置而非在聊天中粘贴。支付链接与预支付信息为一次性且会过期，订单状态需在服务端核实。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Hotel Booking AI MCP，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.tourmind-com%2Fhotel-booking-ai-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "hotel-booking-ai": {
      "type": "http",
      "url": "https://api.tourmind.com/mcp/toc"
    }
  }
}

README

Hotel Booking AI MCP Product Package

This repository contains the ToC product contract and the user-installable companion Skill for Hotel Booking AI MCP. It intentionally does not contain MCP server source code, deployment scripts, or runtime-specific implementation.

Package contents

text
Hotel-Booking-AI-MCP/├── README.md├── Hotel Booking AI MCP-FORMAT.md└── skill/    └── hotel-booking-ai/        ├── SKILL.md        └── references/            └── parameter_guide.md
  • skill/hotel-booking-ai/ defines the Agent's hotel-search, live-rate, booking, payment, order-management, and update behavior.
  • Hotel Booking AI MCP-FORMAT.md defines the public MCP connection and capability contract.

MCP connection

Use the public production endpoint without connection headers:

json
{  "mcpServers": {    "tourmind": {      "url": "https://api.tourmind.com/mcp/toc",      "type": "streamableHttp"    }  }}

The MCP connection itself is public. check_skill_update, hotel search, hotel detail, single-hotel rates, batch rates, and availability checks require no user_key. Booking, order lookup, cancellation, and payment tools receive user_key from the companion Skill only when those protected actions are requested.

Product model

The ToC MCP and ToB MCP use the same hotel discovery, Google POI resolution, candidate verification, live-rate ranking, image, cancellation, tax, payment, and error-handling prompts wherever their product behavior is identical.

The ToC variant differs only where the product differs:

ConcernToC behavior
MCP endpointhttps://api.tourmind.com/mcp/toc
Connection authenticationPublic connection; no headers
Discovery and availabilityPublic; no user_key required
Booking and order operationsRequire user_key from user_key.txt
Read-only web_urlOptional anonymous result returned by hotel-search or room-rate tools; no sign-in required; the companion Skill localizes the result-page URL to the user's language

The MCP service provides stable hotel tools, including batch_query_room_rates for partial-success live-rate retrieval across up to 20 hotels. Search, single/batch rate, availability, and booking tools support repeated per-room adult/child occupancy. The local Skill defines the current user workflow and can evolve independently as search, ranking, price verification, booking, and display strategies improve.

Skill version and updates

The installed SKILL.md frontmatter is the single source of truth for the Skill version:

yaml
metadata:  author: TourMind  version: "<current-version>"

The Agent sends metadata.version only to check_skill_update when an update check is due. Hotel and order tools never receive a Skill version, and users never maintain it in the MCP connection configuration.

Development handoff

The server implementation must satisfy Hotel Booking AI MCP-FORMAT.md, including all eleven tools referenced by the companion Skill. Transport framework, hosting, deployment, internal forwarding, and release infrastructure are outside this package.

TourMind hotel booking ecosystem

Choose the package that matches the audience and connection model:

AudienceIntegrationAuthentication modelRepository
Consumer / ToCDirect HTTP SkillPublic search and availability; user_key only for order operationsHotel Booking AI
Business / ToBDirect HTTP SkillSkill Token required for every API callTourMind Booking Skill
Consumer / ToCMCP package + companion SkillPublic MCP connection; user_key only for order operationsHotel Booking AI MCP
Business / ToBMCP package + companion SkillBearer-authenticated MCP connectionTourMind Booking MCP

来源：README.md，提交 6ca4f7b

工具

11

batch_query_room_rates

Batch Query Room Rates

Get live room types and rate products for multiple hotels with partial-success results. 普通 ToC 酒店查询可匿名，user_key 可选；下单、订单查询、取消和支付需要客户端安全配置的 user_key。 每批 1–20 家酒店，逐项检查 ok/data.reason/reason；只对超时等暂时失败项有限重试，不重复整批已成功项。无房属于成功空结果。 查询失败时先区分参数/鉴权错误和上游暂时失败：修正参数或重新授权后再调用，仅暂时失败可有限重试；不得把错误或空结果改述成成功。

输入参数adultschildrenuser_keyhotel_ids必填room_countcheck_in_datechildren_agescheck_out_date

cancel_booking

Cancel Booking

Cancel a booking owned by the authenticated account. Configure a valid TourMind user_key in a trusted local Skill or client integration that supplies the user_key tool argument. Do not ask users to paste user keys into chat. 普通 ToC 酒店查询可匿名，user_key 可选；下单、订单查询、取消和支付需要客户端安全配置的 user_key。 先查询订单，让用户明确确认具体订单及可能的取消费用后再取消。结果不明时先查订单，不盲目重复取消；refund_amount 不证明退款已到账。

输入参数user_key必填agent_ref_id必填

check_room_availability

Check Room Availability

Recheck the selected rate code, price, and inventory before booking. 普通 ToC 酒店查询可匿名，user_key 可选；下单、订单查询、取消和支付需要客户端安全配置的 user_key。 选择报价后、下单前必须用相同入住条件验价；读取 data.room_types[].rateInfos 的当前 rateCode/totalPrice/currencyCode、库存和取消政策。价格或政策变化须用户重新确认；验价不锁库存。 查询失败时先区分参数/鉴权错误和上游暂时失败：修正参数或重新授权后再调用，仅暂时失败可有限重试；不得把错误或空结果改述成成功。

输入参数adultschildrenhotel_id必填user_keyrate_code必填room_countcheck_in_datechildren_agescheck_out_date

check_skill_update

Check Skill Update

Check whether a newer TourMind Booking Skill version is available. 普通 ToC 酒店查询可匿名，user_key 可选；下单、订单查询、取消和支付需要客户端安全配置的 user_key。 仅在已知安装的 Skill 版本时调用；直接使用 MCP 的客户端无需伪造 Skill 版本。 查询失败时先区分参数/鉴权错误和上游暂时失败：修正参数或重新授权后再调用，仅暂时失败可有限重试；不得把错误或空结果改述成成功。

输入参数current_version必填

create_booking

Create Booking

Create a hotel booking from a verified rate. Configure a valid TourMind user_key in a trusted local Skill or client integration that supplies the user_key tool argument. Do not ask users to paste user keys into chat. 普通 ToC 酒店查询可匿名，user_key 可选；下单、订单查询、取消和支付需要客户端安全配置的 user_key。 先验价并让用户确认酒店、日期、每房入住人、总价/币种、餐食和取消费用，再创建订单。下单不代表支付或酒店确认；使用 query_booking 查最新状态。没有幂等键，超时/断线结果不明时不得自动重复下单，应先核实订单。

输入参数roomsadults必填childrencurrency必填hotel_id必填user_key必填rate_code必填guest_name必填room_count必填total_price必填check_in_date必填children_ages另有 3 个

get_hotel_detail

Get Hotel Detail

Get static hotel details, facilities, rooms, policies, and images. 普通 ToC 酒店查询可匿名，user_key 可选；下单、订单查询、取消和支付需要客户端安全配置的 user_key。 使用已解析的 hotel_id 获取静态设施、政策、图片；不据此判断实时库存。 查询失败时先区分参数/鉴权错误和上游暂时失败：修正参数或重新授权后再调用，仅暂时失败可有限重试；不得把错误或空结果改述成成功。

输入参数hotel_id必填languageuser_key

pay_order

Pay Order

Create a payment request for a booking owned by the authenticated account. CNY WeChat Pay and Alipay return a one-time device-aware payment link. 支付宝AI付 returns prepay_id and expires_at for Qwen batchPay; requires the user's cashier confirmation and server-side order status verification. Configure a valid TourMind user_key in a trusted local Skill or client integration that supplies the user_key tool argument. Do not ask users to paste user keys into chat. 普通 ToC 酒店查询可匿名，user_key 可选；下单、订单查询、取消和支付需要客户端安全配置的 user_key。 先查询订单，仅在待支付且用户确认支付方式、币种、订单金额及 Stripe 另收手续费后发起。生成链接/预支付信息不表示支付成功，需用户完成收银台并查询订单核实。超时或状态不明先查订单，不自动重复支付。支付宝AI付仅适用于支持千问 batchPay 的客户端。

输入参数user_key必填agent_ref_id必填payment_method必填

query_booking

Query Booking

Query a booking owned by the authenticated account. Configure a valid TourMind user_key in a trusted local Skill or client integration that supplies the user_key tool argument. Do not ask users to paste user keys into chat. 普通 ToC 酒店查询可匿名，user_key 可选；下单、订单查询、取消和支付需要客户端安全配置的 user_key。 仅查询当前账号拥有的 TourMind 订单号；核实付款和酒店确认均使用本工具返回的状态。PENDING 表示已支付待确认，不能再次支付。 查询失败时先区分参数/鉴权错误和上游暂时失败：修正参数或重新授权后再调用，仅暂时失败可有限重试；不得把错误或空结果改述成成功。

输入参数user_key必填agent_ref_id必填

query_room_rates

Query Room Rates

Get live room types and rate products for a hotel and stay. 普通 ToC 酒店查询可匿名，user_key 可选；下单、订单查询、取消和支付需要客户端安全配置的 user_key。 先确定酒店和入住条件，返回 data.room_types[].products；选择符合成人/儿童和餐食政策的报价后验价。产品摘要未提供 maxChildren，缺失不等于不接待儿童，必须按实际儿童人数/年龄验价。 查询失败时先区分参数/鉴权错误和上游暂时失败：修正参数或重新授权后再调用，仅暂时失败可有限重试；不得把错误或空结果改述成成功。

输入参数adultschildrenhotel_id必填user_keyroom_countcheck_in_datechildren_agescheck_out_date

search_hotels

Search Hotels

Search candidate hotels by region, coordinates and radius, or fuzzy keyword. 普通 ToC 酒店查询可匿名，user_key 可选；下单、订单查询、取消和支付需要客户端安全配置的 user_key。 任一非 null 坐标参数会选择坐标模式，必须齐全提供经纬度与正半径；否则非空 keyword 走模糊匹配，否则必须给 region_id。区域/坐标结果已实时筛选，关键词结果仅供定位。预算最终按验价总价核对，不能用每晚参考价代替订单总价。 查询失败时先区分参数/鉴权错误和上游暂时失败：修正参数或重新授权后再调用，仅暂时失败可有限重试；不得把错误或空结果改述成成功。

输入参数limitadultskeywordchildrenlatitudeuser_keylongituderadius_kmregion_idroom_countlowest_pricecheck_in_date另有 4 个

search_location

Search Location

Resolve a region, point of interest, landmark, shopping mall, or hotel name to TourMind regions, hotels, or coordinates. 普通 ToC 酒店查询可匿名，user_key 可选；下单、订单查询、取消和支付需要客户端安全配置的 user_key。 先用此工具解析用户地点/酒店名，再用返回的 ID 或坐标搜索酒店；不得编造 ID。 查询失败时先区分参数/鉴权错误和上游暂时失败：修正参数或重新授权后再调用，仅暂时失败可有限重试；不得把错误或空结果改述成成功。

输入参数keyword必填user_key

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。