MCP Amadeus

Amadeus MCP Server is a community-developed service that integrates Amadeus' flight search API through the Model Context Protocol (MCP), allowing users to query flight information through a natural language interface.

Travel and transportation Developer tools #Flight Search #Natural Language #API Integration #MCP Service .Python

rating : 2.5 points

downloads : 10.7K

update time : 2025-04-29

Open Site

What is Amadeus MCP Server?

Amadeus MCP Server is an open-source server based on the Model Context Protocol (MCP). It integrates Amadeus' flight search API through a natural language interface, enabling users to easily query flight information.

How to use Amadeus MCP Server?

You can set up and use Amadeus MCP Server in just a few steps. First, install the dependencies. Then, configure the API key. Finally, register the server in an MCP-supported client.

Use Cases

It is suitable for applications that need to quickly obtain flight information, such as travel planning tools and personal assistant services.

Main Features

Flight Search

Retrieve flight options based on the departure location, destination, and date.

Multi-leg Flight Search

Supports one-way and round-trip flight queries.

Price Filtering

Allows setting a maximum fare limit.

Advantages

Supports natural language input, simplifying the operation process.

Integrates Amadeus' powerful API, providing comprehensive flight data.

Open-source and free to use.

Limitations

Requires an Amadeus developer account and API key.

May return fewer results for unconventional routes.

Has limited support for high-concurrency requests.

How to Use

Clone the project and install dependencies

Clone the Amadeus MCP Server repository and install the required dependencies locally.

Configure environment variables

Create a.env file and fill in your Amadeus API key.

Add the Amadeus server configuration to an MCP-supported client.

Usage Examples

Query direct flights

Query direct flights from New York to London.

Find round-trip tickets

Find round-trip tickets from Tokyo to Paris.

Frequently Asked Questions

How to obtain an Amadeus API key?

Which language environments does the server support?

Related Resources

Amadeus MCP Server GitHub

Project source code repository.

Amadeus API Documentation

Official API documentation.

🚀 Amadeus MCP Server

Amadeus MCP Server is a community-developed Model Context Protocol (MCP) server that integrates the Amadeus Flight Offers Search API, providing flight search functionality through a natural language interface. It is suitable for MCP-compatible clients (e.g., Claude Desktop).

This project enables users to easily search for flight options between specific dates and locations, leveraging the power of large language models (LLMs) and the Amadeus API.

This project uses the official amadeus-python SDK

⚠️ Important Note

This project is open-source and is not affiliated with or endorsed by Amadeus IT Group. Amadeus® is a registered trademark of Amadeus IT Group.

🚀 Quick Start

📦 Installation

pip install mcp-amadeus

💻 Usage Examples

🔍 Basic Usage

from mcp_amadeus import AmadeusMCP

# Initialize the MCP agent
mcp = AmadeusMCP()

# Search for flights
response = mcp.search_flights(
    origin="JFK",
    destination="LHR",
    departure_date="2025-06-15",
    adults=1,
    children=1
)

print(response)

📄 Output Format

[
  {
    "airline": "AA",
    "departure_time": "2025-06-15T10:00:00",
    "arrival_time": "2025-06-15T14:30:00",
    "duration": "04:30",
    "price": 500,
    "currency": "USD"
  },
  ...
]

✨ Features

✈️ Flight Offer Search

Retrieve flight options between two locations on specified dates.

"I'm looking for a flight from JFK to LHR on June 15, 2025, with one adult and one child."

Sort flights by price, departure time, and airline.
Display flight information (date, time, duration) and price.

🔧 Technical Details

🛠️ Tools

MCP Agent

The MCP agent provides the following interfaces:

search_flights(origin, destination, departure_date, **options)
calculate_price(flight_id, passengers)

📋 Parameter Options

Property	Type	Required	Description	Example Value
origin	string	Yes	Departure airport IATA code	JFK
destination	string	Yes	Destination airport IATA code	LHR
departure_date	string	Yes	Departure date (YYYY-MM-DD)	2025-06-15
return_date	string	No	Return date (YYYY-MM-DD). If not specified for one-way, it is considered a round-trip.	2025-06-20
adults	integer	Yes	Number of adults (1 - 9). Default is 1	2
children	integer	No	Number of children (2 - 11). Maximum total is 9	1
infants	integer	No	Number of infants (≤2). Maximum number is the same as adults.	1
travel_class	string	No	Travel class: ECONOMY, BUSINESS, etc.	ECONOMY
non_stop	boolean	No	If true, only show direct flights. Default is false	true
currency_code	string	No	Currency code (ISO 4217, e.g., USD)	EUR
max_price	integer	No	Maximum price per passenger	500
max	integer	No	Maximum number of flights. Default is 250	10