mcpField
H
hotelbooking

hotelbooking

Local
github.com/DIDA-AIMaps & Travel
Repository

About hotelbooking

道旅酒店 MCP is a hotel search and booking service for AI agents, MCP clients, travel products, and business travel tools. It combines location and date filters with room, price, and order capabilities.

Key features

  1. 01Search hotels by location
  2. 02Filter by dates and star rating
  3. 03Retrieve hotel and price details
  4. 04Check orders and lock room rates
  5. 05Monitor prices and send alerts

Use cases

  1. 01Add hotel search to a travel agent
  2. 02Find hotels near attractions for set dates
  3. 03Integrate booking into business travel products

MCP support

The service exposes hotel search, detail, and filtering tools to MCP clients over Streamable HTTP. Its OAuth version also includes price confirmation, booking, and order tools.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "dida-ai-hotelbooking": {
      "command": "npx",
      "args": [
        "-y",
        "@didaai/hotelbooking"
      ],
      "env": {
        "DIDA_API_KEY": "<DIDA_API_KEY>"
      }
    }
  }
}
Run commandnpx -y @didaai/hotelbooking
Environment variables to set
DIDA_API_KEYSecretDida Hotel API Key

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@didaai/hotelbooking1.0.0

Tools

3

Saved tool list · updated 1w ago

ParameterTypeRequiredDescription
sizenumberNoNumber of hotel results to return. Defaults to 5 hotels, with a maximum of 20.
placestringYesName of the search target. Enter the city, airport, attraction, train station, subway station, hotel, district/county, or detailed address specified by the user; if the user entered a specific hotel name, enter the hotel name directly.
hotelTagsobjectNoHotel filter tag parameters (optional). When provided, these tags are used directly for filtering and sorting, without additional server-side parsing. Fields: requiredTags (required tags), preferredBrands (preferred brands), maxPricePerNight (maximum budget per night).
hotelTags.requiredTagsarrayNoRequired tags (hard constraints; results that do not match must be filtered out).
hotelTags.preferredBrandsarrayNoPreferred brands
hotelTags.maxPricePerNightnumberNoMaximum price per night (RMB, numeric value)
placeTypestringYesType of place; must match the actual content of place. Available values: city, airport, attraction, train station, subway station, hotel, district/county, detailed address.
countryCodestringNoISO 3166-1 alpha-2 country/region code for currency/region preferences. Defaults to CN (China).
originQuerystringYesSynthesize the user's complete accommodation/booking intent from the full multi-turn conversation.
checkInParamobjectNoCheck-in parameters. Fields: adultCount (integer, >=1, default 2); checkInDate (string, YYYY-MM-DD, future date); stayNights (integer, 1–28, default 1).
checkInParam.adultCountnumberNo
checkInParam.stayNightsnumberNo
checkInParam.checkInDatestringNo
filterOptionsobjectNoHotel filter options, such as hotel star rating, number of adults per room, and distance
filterOptions.starRatingsarrayNoHotel star rating (0.0–5.0, in increments of 0.5), defaults to [0.0, 5.0] or above, e.g. [4.5, 5.0], [0.0, 2.0]
filterOptions.distanceInMeternumberNoStraight-line distance in meters; applies when the location is a POI, with a default value of 2000 when enabled

Details

The maintainer has not added details yet. Check the README in the repository.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.