| name | aigohotel-mcp |
| description | A Skill for searching hotels and querying prices via AIGoHotel MCP (searchHotels / getHotelDetail / getHotelSearchTags) |
AIGoHotel MCP Hotel Search Skill
This Skill describes how the model should use the aigohotel-mcp MCP server to search for hotels, view detailed prices for a specific hotel, and fetch available hotel tag metadata.
When to use this Skill
- When the user wants to find hotels in a specific place (city, airport, attraction, station, detailed address, or a specific hotel), call
searchHotels.
- When the user has already chosen a specific hotel and wants to see detailed room types and prices (including cancellation policies, etc.), call
getHotelDetail.
- When you need to understand or explain available hotel tags (such as “Free WiFi”, “Family-friendly hotel”, “Airport hotel”), or need to map natural-language preferences into structured tags, call
getHotelSearchTags.
Tool 1: searchHotels
Purpose: Search a list of hotels based on destination, dates, star rating, number of guests, budget, and tag filters.
Key input fields (fill them based on the user’s intent as much as possible):
Output highlights (how to use the result):
- Common top-level fields:
message, hotelInformationList.
- Each hotel in
hotelInformationList contains:
hotelId, name, address, destinationId, latitude, longitude, distanceInMeters,starRating, score, tags, hotelAmenities,bookingUrl (you can provide this as a booking link to the user),price (an object rather than a single number):
hasPrice: Whether price is available.currency: Currency code (usually CNY).lowestPrice: The lowest available price under the current conditions.
- Some fields may be missing or
null. Do not fabricate values that are not returned by the MCP tool.
Tool 2: getHotelDetail
Purpose: After the user has chosen a specific hotel, get detailed room types, total prices, and cancellation policies for a given stay period.
Typical call scenarios:
- The user says things like “For this hotel, show me the room types and prices / whether breakfast is included / whether it’s refundable”.
- Typically you first call
searchHotels to find a suitable hotel and remember its hotelId, then call this tool.
Key input fields:
hotelId (number): Prefer using the hotelId returned from searchHotels.name (string): Only use name-based fuzzy matching when you do not have a reliable hotelId.checkInDate / checkOutDate (string, YYYY-MM-DD):
- If empty, invalid, or earlier than today, the service will automatically adjust (e.g. use “tomorrow” and
+1 day).
adultCount (number, default 2), childCount (number, default 0), childAgeDetails (number[]):
- Set according to the actual number and ages of guests.
roomCount (number, default 1): Number of rooms.countryCode (string, default CN): Country code.currency (string, default CNY): Currency code.
Output highlights:
- On success, the response usually contains:
success, errorMessage, hotelId, name, bookingUrl, checkIn, checkOut,roomRatePlans: A list of room types and rate plans.
- Common fields in
roomRatePlans:
roomTypeId, roomName, roomNameCn, ratePlanId, ratePlanName,currency, totalPrice (total price for this stay), inventoryCount, isOnRequest,cancellationPolicies: Cancellation rules (time periods, amounts, descriptions, etc.).
- When responding to the user:
- Focus on summarizing key information: main room types, price range, whether free cancellation is available, whether breakfast is included, etc.
- You may provide
bookingUrl (e.g. “You can complete the booking via this link.”).
- On failure, the tool may return an error message directly (e.g. “Failed to get prices, please try again later”). In that case, explain the failure in natural language and suggest adjusting dates or trying again later.
Tool 3: getHotelSearchTags
Purpose: Fetch metadata for tags that can be used in searchHotels.hotelTags. It is recommended to cache this on the client side and use it to map user intent to tags.
Output highlights:
tags: A list of tags, each including:
name: Tag name (for example “Free WiFi”).category: Category (for example “Core Facilities”, “Hotel Type”, etc.).description: Human-readable explanation.
usageGuide:
tagUsage: How to use tag names in hotelTags.preferredTags / requiredTags / excludedTags.exampleRequest: Example request JSON.
Typical categories (non-exhaustive):
- Brand & Rating
- Selling Points
- Core Facilities
- Family & Kids
- Service Details
- Dining & Service
- Transport & Payment
- View & Room Type
- Hotel Type
- Price Related
When you need complex filtering with tags and are not sure about the exact tag names, you can first call getHotelSearchTags, then choose appropriate tags from tags.name to fill into hotelTags.
General dialogue and safety constraints
- In multi-turn conversations, remember the user’s already-provided destination, dates, number of guests, star rating, and budget as much as possible, and only ask again when information is missing or ambiguous.
- Never fabricate fields or values that are not returned by the MCP tools, especially for sensitive information such as prices and cancellation policies.
- Make it clear that prices and availability are real-time results and may change over time.
- Answer in the same language as the user (use Chinese for Chinese users, English for English users). Keep responses reasonably concise and highlight the most useful information (e.g. 3–5 recommended hotels or a few key room options), instead of dumping very long lists.
Local MCP configuration example (optional)
In development tools that support local MCP configuration (such as Cursor), you can add the following to mcp.json to mount AIGoHotel MCP as an available server (the name aigohotel-mcp-server is just an example and can be adjusted as needed):
{
"mcpServers": {
"aigohotel-mcp-server": {
"url": "https://mcp.aigohotel.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_AIGOHOTEL_MCP_TOKEN>",
"Content-Type": "application/json"
}
}
}
}
