Hotel Booking AI MCP

io.github.tourmind-comPublished by GitHub account tourmind-comv1.0.0Updated Oct 27, 2026

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

VerifiedStreamable HTTPWeb executableLocation & LifestyleFinanceBusiness & Commerce

Overview

AI-generated overview

TourMind hotel booking server: search hotels, compare live room rates, book, pay and manage orders from an AI assistant.

What you can do
  • Resolve places, landmarks and hotel names to TourMind regions, hotels or coordinates
  • Search hotels by region, coordinates and radius, or fuzzy keyword, and read static hotel details, facilities, policies and images
  • Fetch live room types and rates for one hotel or up to 20 hotels per batch, and recheck price, rate code and inventory before booking
  • Create bookings, query and cancel bookings owned by the authenticated account
  • Create payment requests, including WeChat Pay and Alipay links or prepay data for cashier confirmation
  • Check whether a newer version of the companion Skill is available
When to use it
Useful when an assistant should help consumers find hotels, compare live rates and complete a booking and payment through TourMind, including multi-hotel rate comparison in one call.
Requirements
Remote streamable HTTP endpoint at api.tourmind.com/mcp/toc with no connection headers. Search, hotel detail, rate and availability tools work anonymously. Booking, order lookup, cancellation and payment need a TourMind user_key supplied by a trusted local Skill or client integration, not typed into chat.
Before you install
Booking, cancellation and payment change real orders and move money; the server asks that the user confirm hotel, dates, occupancy and price after a recheck before ordering. A user_key is required for protected actions and should be configured in the client, never pasted into chat. Payment links and prepay data are one-time and expire, and order status must be verified server-side.

Installation

In SourceWeft

  1. Open Hotel Booking AI MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.tourmind-com%2Fhotel-booking-ai-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "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

Source: README.md at commit 6ca4f7b

Tools

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

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

Parametersuser_keyrequiredagent_ref_idrequired

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

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

Parameterscurrent_versionrequired

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

Parametersroomsadultsrequiredchildrencurrencyrequiredhotel_idrequireduser_keyrequiredrate_coderequiredguest_namerequiredroom_countrequiredtotal_pricerequiredcheck_in_daterequiredchildren_ages+3 more

get_hotel_detail

Get Hotel Detail

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

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

Parametersuser_keyrequiredagent_ref_idrequiredpayment_methodrequired

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

Parametersuser_keyrequiredagent_ref_idrequired

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

Parametersadultschildrenhotel_idrequireduser_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。区域/坐标结果已实时筛选，关键词结果仅供定位。预算最终按验价总价核对，不能用每晚参考价代替订单总价。 查询失败时先区分参数/鉴权错误和上游暂时失败：修正参数或重新授权后再调用，仅暂时失败可有限重试；不得把错误或空结果改述成成功。

Parameterslimitadultskeywordchildrenlatitudeuser_keylongituderadius_kmregion_idroom_countlowest_pricecheck_in_date+4 more

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

Parameterskeywordrequireduser_key

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.