Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Amadeus Hotel API MCP Server search for hotels in Paris with 4-star rating"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
This Model Context Protocol (MCP) server provides a bridge to Amadeus Hotel APIs, allowing AI assistants to search for and book hotels through the Amadeus Travel API.
Search for hotels in a specific city
Get detailed hotel offers with pricing and availability
View specific hotel offer details
Book hotel rooms with guest and payment information
Related MCP server: Travel Amadeus MCP Server
Set the required environment variables before running the server:
export AMADEUS_API_KEY=your_amadeus_api_key
export AMADEUS_API_SECRET=your_amadeus_api_secretName: amadeus_hotel_list
Description: Search for hotels in a specific city with optional filters (amenities, star rating, hotel name)
Example: amadeus_hotel_list({"cityCode": "PAR", "ratings": [4, 5]})
Name: amadeus_hotel_search
Description: Search for hotel offers with pricing for specific dates
Example: amadeus_hotel_search({"cityCode": "PAR", "checkInDate": "2025-04-01", "checkOutDate": "2025-04-05", "adults": 2})
Name: amadeus_hotel_offer
Description: Get detailed information about a specific hotel offer
Example: amadeus_hotel_offer({"offerId": "XYZ123"})
Name: amadeus_hotel_booking
Description: Book a hotel offer for specified guests
Example:
amadeus_hotel_booking({
"offerId": "XYZ123",
"guests": [
{
"name": {
"title": "MR",
"firstName": "John",
"lastName": "Doe"
},
"contact": {
"email": "john.doe@example.com",
"phone": "+1234567890"
}
}
],
"payments": [
{
"method": "CREDIT_CARD",
"card": {
"vendorCode": "VI",
"cardNumber": "4111111111111111",
"expiryDate": "2025-12"
}
}
]
})npm install
npm run build
node dist/index.jsTo use this MCP server with Claude Desktop, update your configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"amadeus-hotel": {
"command": "node",
"args": ["/path/to/amadeus-travel/dist/index.js"],
"env": {
"AMADEUS_API_KEY": "your_amadeus_api_key",
"AMADEUS_API_SECRET": "your_amadeus_api_secret"
}
}
}
}This server integrates with the following Amadeus APIs:
Hotel List API (/v1/reference-data/locations/hotels) - For listing hotels in a location
Hotel Search API (/v2/shopping/hotel-offers) - For finding hotel availability and pricing
Hotel Offer API (/v2/shopping/hotel-offers/{offerId}) - For getting details about a specific offer
Hotel Booking API (/v1/booking/hotel-bookings) - For booking hotel rooms
For more information, refer to the Amadeus API documentation.
Book a hotel offer for specified guests. This tool allows you to make an actual reservation using an offer ID from a previous search. You'll need to provide guest details and payment information.
| Name | Required | Description | Default |
|---|---|---|---|
| offerId | Yes | Hotel offer ID from a previous search result | |
| guests | Yes | List of guests for the booking | |
| payments | Yes | Payment information |
Search for hotels in a specific city. Retrieves a list of hotels based on location and optional filters including amenities, star rating, and hotel name. This is useful for getting an overview of accommodation options in a destination. Always use valid IATA 3-letter city codes (e.g., 'PAR' for Paris, 'NYC' for New York, 'LON' for London, 'SFO' for San Francisco, 'LAX' for Los Angeles).
Examples:
amadeus_hotel_list({"cityCode": "PAR"})
amadeus_hotel_list({"cityCode": "NYC", "ratings": [4, 5]})
amadeus_hotel_list({"cityCode": "LON", "amenities": ["SWIMMING_POOL", "WIFI"]})
| Name | Required | Description | Default |
|---|---|---|---|
| cityCode | Yes | IATA city code (e.g., 'PAR' for Paris, 'NYC' for New York, 'LON' for London, 'SFO' for San Francisco, 'LAX' for Los Angeles). Must be a valid 3-letter IATA city code. | |
| radius | No | Radius around the coordinates in KM (max 100) | |
| radiusUnit | No | Radius unit (KM only) | KM |
| amenities | No | Filter by amenities (e.g., SWIMMING_POOL, WIFI) | |
| ratings | No | Filter by star ratings (1-5) | |
| hotelName | No | Filter by hotel name |
Get detailed information about a specific hotel offer using its ID. This provides comprehensive details about an offer that was found in a previous search result, including updated availability and pricing.
| Name | Required | Description | Default |
|---|---|---|---|
| offerId | Yes | The unique identifier of the offer from a previous search |
Search for hotel offers (available rooms with pricing) based on location, dates, guests, and other criteria. This tool provides detailed pricing and availability information for specific stay dates, including room types, board options, and cancellation policies. Always use valid IATA 3-letter city codes (e.g., 'PAR' for Paris, 'NYC' for New York, 'LON' for London, 'SFO' for San Francisco, 'LAX' for Los Angeles).
Examples:
amadeus_hotel_search({"cityCode": "PAR", "checkInDate": "2025-04-01", "checkOutDate": "2025-04-05", "adults": 2})
amadeus_hotel_search({"cityCode": "NYC", "checkInDate": "2025-04-10", "checkOutDate": "2025-04-15", "adults": 2, "currency": "USD"})
amadeus_hotel_search({"cityCode": "LON", "checkInDate": "2025-05-01", "checkOutDate": "2025-05-07", "adults": 1, "roomQuantity": 1, "priceRange": "100-300"})
amadeus_hotel_search({"cityCode": "SFO", "checkInDate": "2025-06-15", "checkOutDate": "2025-06-20", "hotelName": "Grand Hyatt", "boardType": "BREAKFAST"})
| Name | Required | Description | Default |
|---|---|---|---|
| cityCode | Yes | IATA city code (e.g., 'PAR' for Paris, 'NYC' for New York, 'LON' for London, 'SFO' for San Francisco, 'LAX' for Los Angeles). Must be a valid 3-letter IATA city code. | |
| checkInDate | Yes | Check-in date in YYYY-MM-DD format | |
| checkOutDate | Yes | Check-out date in YYYY-MM-DD format | |
| adults | No | Number of adult guests | |
| roomQuantity | No | Number of rooms | |
| priceRange | No | Price range (e.g., '100-200' for prices between 100 and 200) | |
| currency | No | Currency code (e.g., USD, EUR) | USD |
| boardType | No | Board type (e.g., ROOM_ONLY, BREAKFAST, HALF_BOARD, FULL_BOARD, ALL_INCLUSIVE) | |
| includeClosed | No | Include closed properties | |
| bestRateOnly | No | Return only best available rate | |
| lang | No | Preferred language for hotel descriptions | EN |
| paymentPolicy | No | Filter by payment policy type | NONE |
| hotelName | No | Filter by hotel name |
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
v0.1.0amadeus_hotel_bookingamadeus_hotel_listamadeus_hotel_offeramadeus_hotel_searchScored across 4 tools
Each tool has a clear, distinct purpose: listing hotels, searching offers, getting offer details, and booking. There is no overlap between their functionalities.
All tools share the 'amadeus_hotel_' prefix and follow a verb/noun pattern, but 'offer' and 'booking' are nouns whereas 'list' and 'search' are verbs, causing slight inconsistency.
With 4 tools, the server covers the essential booking flow but is on the lower side. It is reasonable for a focused API but could benefit from a few more tools.
The set covers listing, searching, detailing, and booking hotels, but lacks essential post-booking operations like cancellation or modification, leaving notable gaps.
Live hotel search and booking for AI agents in DACH, the UK and 10 US cities.
AI hotel search and booking: millions of properties, 85,000+ cities, live rates.
Search, quote and book hotels and resorts from any AI agent. Checkout on tellandgo.com. No API key.
Book hotels direct through your AI, for a 5% fee. Demo: sample hotels, no real bookings yet.
