Amadeus MCP Server exposes a flight offers search capability via the Amadeus Flight Offers API. After installing and running the server with uv, you can query the server's tool named get_flight_offers through an MCP client to fetch flight options between two airports on a given date. The tool returns structured flight details such as airline, departure/arrival times, duration, and pricing. Use natural language prompts in your MCP client to leverage this tool, for example: 'Show me nonstop flights from JFK to LAX on 2025-12-20 for 2 adults.'

Prerequisites:

• Python installed and accessible in PATH
• uv (UVicorn/uv) installed or available via uv wrapper
• Git installed
• An Amadeus API key (Client ID and Client Secret) and an .env file configured

Step-by-step:

1. Clone the repository: git clone https://github.com/donghyun-chae/mcp-amadeus.git cd mcp-amadeus-flight-offers

2. Prepare environment variables: cp .env.example .env

   Edit the .env file to add Amadeus credentials:

   AMADEUS_CLIENT_ID=your_client_id

   AMADEUS_CLIENT_SECRET=your_client_secret

3. Install dependencies (via uv): uv sync

4. Run the MCP server locally: uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/src/ run --env-file /ABSOLUTE/PATH/TO/PARENT/FOLDER/.env server.py

Optional: integrate with your MCP client by updating its config to point to the amadeus server, using the absolute path to your project as shown in the README example.

Notes and troubleshooting:

• Ensure your .env file is correctly formatted with AMADEUS_CLIENT_ID and AMADEUS_CLIENT_SECRET.
• The command/path in your MCP client configuration must match your local setup (absolute paths recommended).
• If you encounter authentication errors, verify that your Amadeus API credentials are valid and have the required Flight Offers Search permissions.
• The get_flight_offers tool accepts parameters like origin, destination, departure_date, and optional fields such as return_date, adults, travel_class, and nonstop; tailor requests to your use case.
• When deploying, consider securing your environment variables and restricting access to the MCP server as needed.