Travel Amadeus

This Travel Amadeus MCP Server lets you access a wide range of Amadeus Travel APIs through a Model Context Protocol (MCP) interface. You can search flights and hotels, discover activities, book transfers, and derive travel intelligence, all via a local MCP server that your AI assistant can query.

How to use

You connect an MCP client to the Travel Amadeus MCP Server and begin issuing tool requests to explore flights, hotels, activities, transfers, and travel data. Use the HTTP/remote or local STDIO connection as shown in the configuration snippet to start the server, then point your MCP client to the server endpoint or its local process. Once connected, you can search for flight offers, book itineraries, discover hotel options, pull activity details, check transfer availability, and access analytics and predictions to understand travel trends and delays.

How to install

# Prerequisites: ensure Node.js and npm are installed
node -v
npm -v

# 1. Clone the repository
git clone <repository-url>
cd travel-amadeus-mcp

# 2. Install dependencies
npm install

# 3. Get your Amadeus API credentials
# Sign up at Amadeus for Developers and create an app to obtain Client ID and Client Secret

# 4. Configure environment variables
cp .env.example .env
# Edit .env and add:
# AMADEUS_CLIENT_ID=your_client_id_here
# AMADEUS_CLIENT_SECRET=your_client_secret_here
# AMADEUS_HOSTNAME=production  # or "test" for testing

# 5. Build the project
npm run build

# 6. Start the server (local runtime via STDIO will usually be launched by your MCP client with the provided command)
# The runtime command is exposed as a development/production entry and is typically run through your MCP client configuration.

Configuration and runtime notes

Environment variables are required to authenticate with Amadeus and to select the environment. Create an environment file (as shown above) and ensure your MCP client launches the server using the runtime command documented in the setup. For this setup, the server is intended to run as a local process and be controlled through an MCP client configuration entry.

Security and best practices

Keep your credentials out of version control. Do not commit your .env file or credentials. Use environment variables for sensitive data and consider a secrets management approach for production deployments. When running in production, monitor usage, apply appropriate rate limits, and comply with Amadeus API terms of service.

Troubleshooting tips

If the MCP client cannot connect, verify that the local STDIO process is running and that the command and arguments match those provided in your client configuration. Check that the environment variables are correctly loaded and that the hostname setting corresponds to production or test as needed. Review startup logs for any authentication or connectivity errors from Amadeus.

Available tools

flight_offers_search

Search flight offers with flexible dates and routes.

flight_offers_pricing

Confirm pricing for selected flight offers.

flight_create_order

Book flights by creating an order.

flight_order_get

Retrieve details of an existing flight order.

flight_order_delete

Cancel a flight booking.

flight_inspiration_search

Find cheapest destinations from a given origin.

flight_cheapest_date_search

Identify the cheapest travel dates.

flight_availability_search

Perform advanced flight availability searches.

seatmap_display

Display available seats on flights.

branded_fares_upsell

Provide upsell options with additional services.

flight_choice_prediction

Predict passenger preferences for flight selections.

flight_status

Get real-time flight status.

hotel_offers_search

Search hotel offers by city or coordinates.

hotel_offer_search

Retrieve detailed hotel offer information.

hotel_booking

Book hotel rooms.

hotel_list_by_city

List hotels by city.

hotel_list_by_geocode

List hotels by geographic coordinates.

hotel_sentiments

Analyze hotel reviews sentiment.

points_of_interest_search

Find points of interest nearby.

points_of_interest_by_square

Discover POIs within a specified area.

point_of_interest_details

Get detailed information about a POI.

activities_search

Find tours and activities by location.

activities_by_square

Identify activities within a geographic area.

activity_details

Get detailed information about an activity.

transfer_search

Search private transfer options.

transfer_booking

Book ground transportation.

transfer_cancellation

Cancel transfer bookings.

location_search

Search airports and cities (autocomplete).

airport_city_search

Find airports and cities.

nearest_airport

Find the nearest airport.

airline_lookup

Look up airline information.

checkin_links

Provide airline check-in URLs.

airport_routes

Get routes between airports.

airline_routes

Get airline routes.

most_booked_destinations

Identify the most booked destinations.

most_traveled_destinations

Identify the most traveled destinations.

busiest_travel_period

Identify peak travel periods.

location_score

Provide location safety and tourism ratings.

flight_delay_prediction

Predict flight delay likelihood.

trip_purpose_prediction

Predict trip purpose (business vs leisure).

airport_on_time_performance

Assess on-time performance statistics.

flight_price_analysis

Analyze flight price metrics.