Travel Amadeus MCP Server
A Model Context Protocol (MCP) server that provides access to all Amadeus Travel APIs. This allows AI assistants to search flights, book hotels, find activities, and access comprehensive travel data.
Features
Flight APIs
- Flight Search - Search for flight offers with flexible dates and routes
- Flight Booking - Create, retrieve, and cancel flight orders
- Flight Inspiration - Find cheapest destinations from origin
- Flight Availability - Advanced availability search
- Seat Maps - View available seats on flights
- Branded Fares - Get upsell options with additional services
- Flight Status - Real-time flight tracking
Hotel APIs
- Hotel Search - Find hotel offers by city or coordinates
- Hotel Booking - Book hotel rooms
- Hotel Listings - List hotels by city or location
- Hotel Sentiments - Get review sentiment analysis
Activities & Points of Interest
- Activities Search - Find tours and activities by location
- Points of Interest - Discover tourist attractions
- Activity Details - Get detailed activity information
Transfer Services
- Transfer Search - Find private transfer options
- Transfer Booking - Book ground transportation
- Transfer Cancellation - Cancel transfer bookings
Travel Intelligence
- Travel Analytics - Most booked/traveled destinations, busiest periods
- Price Analysis - Flight price metrics and quartile distributions
- Predictions - Flight delay, trip purpose, on-time performance
- Location Scores - Safety and tourism ratings
Reference Data
- Location Search - Find airports and cities (autocomplete)
- Airline Lookup - Get airline information
- Check-in Links - Airline check-in URLs
- Route Information - Airport and airline routes
Installation
- Clone the repository:
git clone <repository-url>
cd travel-amadeus-mcp
- Install dependencies:
npm install
-
Get your Amadeus API credentials:
- Sign up at Amadeus for Developers
- Create a new app to get your API Key (Client ID) and API Secret (Client Secret)
-
Configure environment variables:
cp .env.example .env
# Edit .env and add your credentials
- Build the project:
npm run build
Configuration
Environment Variables
Create a .env file with the following:
AMADEUS_CLIENT_ID=your_client_id_here
AMADEUS_CLIENT_SECRET=your_client_secret_here
AMADEUS_HOSTNAME=production # or "test" for testing
Claude Desktop Configuration
Add to your Claude Desktop config file:
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"amadeus": {
"command": "node",
"args": ["/absolute/path/to/travel-amadeus-mcp/dist/index.js"],
"env": {
"AMADEUS_CLIENT_ID": "your_client_id",
"AMADEUS_CLIENT_SECRET": "your_client_secret",
"AMADEUS_HOSTNAME": "production"
}
}
}
}
Usage
Once configured, the MCP server provides 50+ tools to Claude. Here are some example prompts:
Flight Search
Find me flights from New York to London departing on 2025-12-15
Hotel Search
Show me hotels in Paris for check-in on 2025-12-20 and check-out on 2025-12-23
Activities
What are the top tourist attractions near the Eiffel Tower?
Travel Insights
What are the most popular destinations from San Francisco this month?
Flight Status
What's the status of flight AA100 on 2025-11-15?
Available Tools
The server provides 50+ MCP tools organized by category:
Flight Tools (12)
flight_offers_search- Search flight offersflight_offers_pricing- Confirm pricingflight_create_order- Book flightsflight_order_get- Get booking detailsflight_order_delete- Cancel bookingsflight_inspiration_search- Find cheap destinationsflight_cheapest_date_search- Find cheapest datesflight_availability_search- Advanced searchseatmap_display- View seat mapsbranded_fares_upsell- Get fare upgradesflight_choice_prediction- Predict preferencesflight_status- Real-time status
Hotel Tools (6)
hotel_offers_search- Search hotelshotel_offer_search- Get offer detailshotel_booking- Book hotelshotel_list_by_city- List hotels by cityhotel_list_by_geocode- List hotels by locationhotel_sentiments- Review analysis
Activity Tools (6)
points_of_interest_search- Find POIspoints_of_interest_by_square- POIs in areapoint_of_interest_details- POI detailsactivities_search- Find activitiesactivities_by_square- Activities in areaactivity_details- Activity details
Transfer Tools (3)
transfer_search- Search transferstransfer_booking- Book transferstransfer_cancellation- Cancel transfers
Reference Data Tools (7)
location_search- Search locationsairport_city_search- Find airports/citiesnearest_airport- Find nearest airportairline_lookup- Airline informationcheckin_links- Check-in URLsairport_routes- Airport routesairline_routes- Airline routes
Analytics Tools (4)
most_booked_destinations- Popular destinationsmost_traveled_destinations- Travel trendsbusiest_travel_period- Peak periodslocation_score- Location ratings
Prediction Tools (4)
flight_delay_prediction- Delay likelihoodtrip_purpose_prediction- Business vs leisureairport_on_time_performance- On-time statsflight_price_analysis- Price metrics
Development
Build
npm run build
Watch Mode
npm run watch
Run Directly
npm run dev
Testing
The project includes comprehensive tests for all 50+ API endpoints:
# Run all tests
npm test
# Run tests in watch mode
npm run test:watch
# Run tests with coverage report
npm run test:coverage
See TEST_GUIDE.md for detailed testing documentation.
Test Coverage:
- ✅ 12 Flight API endpoints
- ✅ 6 Hotel API endpoints
- ✅ 6 Activity & POI endpoints
- ✅ 3 Transfer endpoints
- ✅ 7 Reference Data endpoints
- ✅ 8 Analytics & Prediction endpoints
- ✅ Integration tests for complete booking flows
API Documentation
For detailed API documentation, visit:
Test vs Production
Amadeus provides two environments:
- Test Environment: Use test credentials for development with sample data
- Production Environment: Use production credentials for real bookings (charges apply)
Set AMADEUS_HOSTNAME=test for testing or AMADEUS_HOSTNAME=production for live data.
Limitations
- Some APIs require production credentials
- Booking APIs may incur charges
- Rate limits apply based on your Amadeus account tier
- Some endpoints require specific data formats (see Amadeus documentation)
Security Notes
- Never commit your
.envfile or credentials - Use environment variables for sensitive data
- For production use, implement proper credential management
- Review Amadeus terms of service and API usage policies
License
MIT
Support
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.