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 分

    請在儲存庫或註冊中心條目中宣告授權條款。