The server marks this tool read-only

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；只对超时等暂时失败项有限重试，不重复整批已成功项。无房属于成功空结果。查询失败时先区分参数/鉴权错误和上游暂时失败：修正参数或重新授权后再调用，仅暂时失败可有限重试；不得把错误或空结果改述成成功。

read-only

Argument	Type	Description
adults	integer	每房成人数，不是所有房间合计；相同入住配置应用于每间房。有效入住人数必须大于 0。省略或 0 默认 1；负数无效。
children	integer	每房儿童数，非负整数；省略或 0 表示无儿童，必须等于 children_ages 数组长度。
user_key	string	由可信本地客户端配置的 TourMind 用户凭证；勿让用户在聊天中粘贴。普通 ToC 查询可省略，订单/支付操作必填；OAuth 与 ToB 不接受此字段。
hotel_ids*	null \| array	每批 1–20 个 TourMind 酒店 ID 字符串；输出顺序与输入相同，每项失败独立返回。
room_count	integer	相同入住配置的房间数；业务处理器将 0 按 1 间处理，负数无效。查询工具可省略；下单工具原有 MCP Schema 要求此字段存在。
check_in_date	string	入住日期，YYYY-MM-DD。省略/空字符串默认服务端当前日期的明天。
children_ages	null \| array	每房儿童年龄数组，逐个为 0–17 岁整数；数组长度必须等于 children，同一组年龄应用于每间房。省略/null/[] 只适用于 children=0。
check_out_date	string	离店日期，YYYY-MM-DD，必须晚于 check_in_date。省略/空字符串默认入住次日。

Input schema (JSON)

{
  "type": "object",
  "required": [
    "hotel_ids"
  ],
  "properties": {
    "adults": {
      "type": "integer",
      "description": "每房成人数，不是所有房间合计；相同入住配置应用于每间房。有效入住人数必须大于 0。 省略或 0 默认 1；负数无效。"
    },
    "children": {
      "type": "integer",
      "description": "每房儿童数，非负整数；省略或 0 表示无儿童，必须等于 children_ages 数组长度。"
    },
    "user_key": {
      "type": "string",
      "description": "由可信本地客户端配置的 TourMind 用户凭证；勿让用户在聊天中粘贴。普通 ToC 查询可省略，订单/支付操作必填；OAuth 与 ToB 不接受此字段。"
    },
    "hotel_ids": {
      "type": [
        "null",
        "array"
      ],
      "items": {
        "type": "string"
      },
      "description": "每批 1–20 个 TourMind 酒店 ID 字符串；输出顺序与输入相同，每项失败独立返回。"
    },
    "room_count": {
      "type": "integer",
      "description": "相同入住配置的房间数；业务处理器将 0 按 1 间处理，负数无效。查询工具可省略；下单工具原有 MCP Schema 要求此字段存在。"
    },
    "check_in_date": {
      "type": "string",
      "description": "入住日期，YYYY-MM-DD。 省略/空字符串默认服务端当前日期的明天。"
    },
    "children_ages": {
      "type": [
        "null",
        "array"
      ],
      "items": {
        "type": "integer"
      },
      "description": "每房儿童年龄数组，逐个为 0–17 岁整数；数组长度必须等于 children，同一组年龄应用于每间房。省略/null/[] 只适用于 children=0。"
    },
    "check_out_date": {
      "type": "string",
      "description": "离店日期，YYYY-MM-DD，必须晚于 check_in_date。 省略/空字符串默认入住次日。"
    }
  },
  "additionalProperties": false
}

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 不证明退款已到账。

destructive

Argument	Type	Description
user_key*	string	由可信本地客户端配置的 TourMind 用户凭证；勿让用户在聊天中粘贴。普通 ToC 查询可省略，订单/支付操作必填；OAuth 与 ToB 不接受此字段。
agent_ref_id*	string	create_booking 返回的 TourMind 订单号，必须属于当前鉴权用户；不是酒店确认号或第三方支付订单号。

Input schema (JSON)

{
  "type": "object",
  "required": [
    "user_key",
    "agent_ref_id"
  ],
  "properties": {
    "user_key": {
      "type": "string",
      "description": "由可信本地客户端配置的 TourMind 用户凭证；勿让用户在聊天中粘贴。普通 ToC 查询可省略，订单/支付操作必填；OAuth 与 ToB 不接受此字段。"
    },
    "agent_ref_id": {
      "type": "string",
      "description": "create_booking 返回的 TourMind 订单号，必须属于当前鉴权用户；不是酒店确认号或第三方支付订单号。"
    }
  },
  "additionalProperties": false
}

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、库存和取消政策。价格或政策变化须用户重新确认；验价不锁库存。查询失败时先区分参数/鉴权错误和上游暂时失败：修正参数或重新授权后再调用，仅暂时失败可有限重试；不得把错误或空结果改述成成功。

read-only

Argument	Type	Description
adults	integer	每房成人数，不是所有房间合计；相同入住配置应用于每间房。有效入住人数必须大于 0。省略或 0 默认 1；负数无效。
children	integer	每房儿童数，非负整数；省略或 0 表示无儿童，必须等于 children_ages 数组长度。
hotel_id*	string	TourMind 酒店 ID，数字字符串；从地点/酒店搜索返回取得，不使用 Google place_id。
user_key	string	由可信本地客户端配置的 TourMind 用户凭证；勿让用户在聊天中粘贴。普通 ToC 查询可省略，订单/支付操作必填；OAuth 与 ToB 不接受此字段。
rate_code*	string	不透明报价代码，原样传递；验价使用 query_room_rates 返回值，下单使用 check_room_availability 最新返回值，酒店/日期/入住人数必须一致。
room_count	integer	相同入住配置的房间数；业务处理器将 0 按 1 间处理，负数无效。查询工具可省略；下单工具原有 MCP Schema 要求此字段存在。
check_in_date	string	入住日期，YYYY-MM-DD。省略/空字符串默认服务端当前日期的明天。

check_skill_update

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

read-only

Argument	Type	Description
current_version*	string	已安装 TourMind Skill 的语义版本，例如 1.0.0；没有安装 Skill 的 MCP 客户端不要编造版本。

Input schema (JSON)

{
  "type": "object",
  "required": [
    "current_version"
  ],
  "properties": {
    "current_version": {
      "type": "string",
      "description": "已安装 TourMind Skill 的语义版本，例如 1.0.0；没有安装 Skill 的 MCP 客户端不要编造版本。"
    }
  },
  "additionalProperties": false
}

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 查最新状态。没有幂等键，超时/断线结果不明时不得自动重复下单，应先核实订单。

destructive

Argument	Type	Description
rooms	null \| array	按房间分组的入住人，提供非空数组时长度必须等于有效 room_count；每房至少 1 名、最多 adults 名，优先于 guest_name。
adults*	integer	每房成人数，不是所有房间合计；相同入住配置应用于每间房。有效入住人数必须大于 0。此入口不提供默认值；在使用入住条件时必须显式提供。
children	integer	每房儿童数，非负整数；省略或 0 表示无儿童，必须等于 children_ages 数组长度。
currency*	string	核实报价的 ISO 4217 币种；订单实际以鉴权账号结算币种为准，本参数不改变账号币种。
hotel_id*	string	TourMind 酒店 ID，数字字符串；从地点/酒店搜索返回取得，不使用 Google place_id。
user_key*	string	由可信本地客户端配置的 TourMind 用户凭证；勿让用户在聊天中粘贴。普通 ToC 查询可省略，订单/支付操作必填；OAuth 与 ToB 不接受此字段。
rate_code*	string	不透明报价代码，原样传递；验价使用 query_room_rates 返回值，下单使用 check_room_availability 最新返回值，酒店/日期/入住人数必须一致。

get_hotel_detail

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

read-only

Argument	Type	Description
hotel_id*	string	TourMind 酒店 ID，数字字符串；从地点/酒店搜索返回取得，不使用 Google place_id。
language	string	酒店图片查询语言，省略默认 zh-CN；直接传给图片服务，不承诺全部酒店文字翻译，也不改变 web_url 的固定 zh-CN 语言。
user_key	string	由可信本地客户端配置的 TourMind 用户凭证；勿让用户在聊天中粘贴。普通 ToC 查询可省略，订单/支付操作必填；OAuth 与 ToB 不接受此字段。

Input schema (JSON)

{
  "type": "object",
  "required": [
    "hotel_id"
  ],
  "properties": {
    "hotel_id": {
      "type": "string",
      "description": "TourMind 酒店 ID，数字字符串；从地点/酒店搜索返回取得，不使用 Google place_id。"
    },
    "language": {
      "type": "string",
      "description": "酒店图片查询语言，省略默认 zh-CN；直接传给图片服务，不承诺全部酒店文字翻译，也不改变 web_url 的固定 zh-CN 语言。"
    },
    "user_key": {
      "type": "string",
      "description": "由可信本地客户端配置的 TourMind 用户凭证；勿让用户在聊天中粘贴。普通 ToC 查询可省略，订单/支付操作必填；OAuth 与 ToB 不接受此字段。"
    }
  },
  "additionalProperties": false
}

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 的客户端。

destructive

Argument	Type	Description
user_key*	string	由可信本地客户端配置的 TourMind 用户凭证；勿让用户在聊天中粘贴。普通 ToC 查询可省略，订单/支付操作必填；OAuth 与 ToB 不接受此字段。
agent_ref_id*	string	create_booking 返回的 TourMind 订单号，必须属于当前鉴权用户；不是酒店确认号或第三方支付订单号。
payment_method*	string	精确枚举：Stripe、微信支付、支付宝、支付宝AI付。后三种仅 CNY；支付宝AI付需千问原生收银台，返回 prepay_id，不是可点击支付链接。

Input schema (JSON)

{
  "type": "object",
  "required": [
    "user_key",
    "agent_ref_id",
    "payment_method"
  ],
  "properties": {
    "user_key": {
      "type": "string",
      "description": "由可信本地客户端配置的 TourMind 用户凭证；勿让用户在聊天中粘贴。普通 ToC 查询可省略，订单/支付操作必填；OAuth 与 ToB 不接受此字段。"
    },
    "agent_ref_id": {
      "type": "string",
      "description": "create_booking 返回的 TourMind 订单号，必须属于当前鉴权用户；不是酒店确认号或第三方支付订单号。"
    },
    "payment_method": {
      "type": "string",
      "description": "精确枚举：Stripe、微信支付、支付宝、支付宝AI付。后三种仅 CNY；支付宝AI付需千问原生收银台，返回 prepay_id，不是可点击支付链接。"
    }
  },
  "additionalProperties": false
}

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 表示已支付待确认，不能再次支付。查询失败时先区分参数/鉴权错误和上游暂时失败：修正参数或重新授权后再调用，仅暂时失败可有限重试；不得把错误或空结果改述成成功。

read-only

Argument	Type	Description
user_key*	string	由可信本地客户端配置的 TourMind 用户凭证；勿让用户在聊天中粘贴。普通 ToC 查询可省略，订单/支付操作必填；OAuth 与 ToB 不接受此字段。
agent_ref_id*	string	create_booking 返回的 TourMind 订单号，必须属于当前鉴权用户；不是酒店确认号或第三方支付订单号。

Input schema (JSON)

{
  "type": "object",
  "required": [
    "user_key",
    "agent_ref_id"
  ],
  "properties": {
    "user_key": {
      "type": "string",
      "description": "由可信本地客户端配置的 TourMind 用户凭证；勿让用户在聊天中粘贴。普通 ToC 查询可省略，订单/支付操作必填；OAuth 与 ToB 不接受此字段。"
    },
    "agent_ref_id": {
      "type": "string",
      "description": "create_booking 返回的 TourMind 订单号，必须属于当前鉴权用户；不是酒店确认号或第三方支付订单号。"
    }
  },
  "additionalProperties": false
}

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，缺失不等于不接待儿童，必须按实际儿童人数/年龄验价。查询失败时先区分参数/鉴权错误和上游暂时失败：修正参数或重新授权后再调用，仅暂时失败可有限重试；不得把错误或空结果改述成成功。

read-only

Argument	Type	Description
adults	integer	每房成人数，不是所有房间合计；相同入住配置应用于每间房。有效入住人数必须大于 0。省略或 0 默认 1；负数无效。
children	integer	每房儿童数，非负整数；省略或 0 表示无儿童，必须等于 children_ages 数组长度。
hotel_id*	string	TourMind 酒店 ID，数字字符串；从地点/酒店搜索返回取得，不使用 Google place_id。
user_key	string	由可信本地客户端配置的 TourMind 用户凭证；勿让用户在聊天中粘贴。普通 ToC 查询可省略，订单/支付操作必填；OAuth 与 ToB 不接受此字段。
room_count	integer	相同入住配置的房间数；业务处理器将 0 按 1 间处理，负数无效。查询工具可省略；下单工具原有 MCP Schema 要求此字段存在。
check_in_date	string	入住日期，YYYY-MM-DD。省略/空字符串默认服务端当前日期的明天。
children_ages	null \| array	每房儿童年龄数组，逐个为 0–17 岁整数；数组长度必须等于 children，同一组年龄应用于每间房。省略/null/[] 只适用于 children=0。
check_out_date	string

search_hotels

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

read-only

Argument	Type	Description
limit	integer	仅关键词模糊搜索生效；省略或 0 使用 20；服务端未定义最大值，负值直接交给搜索服务处理，不应传负值。区域/坐标搜索固定最多取 20 个候选再实时筛选。
adults	integer	每房成人数，不是所有房间合计；相同入住配置应用于每间房。有效入住人数必须大于 0。省略或 0 默认 1；负数无效。仅区域/坐标搜索使用；关键词搜索忽略入住条件。
keyword	string	地点或酒店名称。search_location 必填非空白文本；search_hotels 中关键词模式优先于 region_id，坐标模式优先于关键词。
children	integer	每房儿童数，非负整数；省略或 0 表示无儿童，必须等于 children_ages 数组长度。仅区域/坐标搜索使用；关键词搜索忽略入住条件。
latitude	null \| number	搜索中心纬度，-90 至 90 度；使用坐标模式必须同时提供 longitude 和 radius_km。
user_key	string	由可信本地客户端配置的 TourMind 用户凭证；勿让用户在聊天中粘贴。普通 ToC 查询可省略，订单/支付操作必填；OAuth 与 ToB 不接受此字段。
longitude	null \| number	搜索中心经度，-180 至 180 度；使用坐标模式必须同时提供 latitude 和 radius_km。
radius_km

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。查询失败时先区分参数/鉴权错误和上游暂时失败：修正参数或重新授权后再调用，仅暂时失败可有限重试；不得把错误或空结果改述成成功。

read-only

Argument	Type	Description
keyword*	string	地点或酒店名称。search_location 必填非空白文本；search_hotels 中关键词模式优先于 region_id，坐标模式优先于关键词。
user_key	string	由可信本地客户端配置的 TourMind 用户凭证；勿让用户在聊天中粘贴。普通 ToC 查询可省略，订单/支付操作必填；OAuth 与 ToB 不接受此字段。

Input schema (JSON)

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "description": "地点或酒店名称。search_location 必填非空白文本；search_hotels 中关键词模式优先于 region_id，坐标模式优先于关键词。"
    },
    "user_key": {
      "type": "string",
      "description": "由可信本地客户端配置的 TourMind 用户凭证；勿让用户在聊天中粘贴。普通 ToC 查询可省略，订单/支付操作必填；OAuth 与 ToB 不接受此字段。"
    }
  },
  "additionalProperties": false
}

Hotel Booking AI MCP

Try it

batch_query_room_rates Read-only

Hotel Booking AI MCP

Try it

batch_query_room_rates Read-only

Tools (11)