Amadeus Travel
Global flight and hotel intelligence from the Amadeus GDS
Flight search, pricing, status, delay predictions, hotel offers, seat maps, and airport reference data via the Amadeus Self-Service APIs. Works with 500+ airlines and 150,000+ hotels worldwide.
Service Contract
Highlights
About
What it does
Amadeus Travel gives your AI agent access to the Amadeus Global Distribution System — one of the world's largest travel data platforms. Search flights across 500+ airlines, find hotel offers at 150,000+ properties, check real-time flight status, predict delays, discover cheapest travel dates, and look up airport and airline reference data.
Built on the Amadeus Self-Service APIs and the official Python SDK (v12.0.0). No travel agency agreement required for search and pricing — only booking (not included in v1) needs a consolidator.
How it differs from other travel MCPs
| This plugin | Duffel MCP | Google Flights | Skyscanner | |
|---|---|---|---|---|
| Data source | Amadeus GDS (direct) | Duffel aggregator | Discontinued (2018) | Partner-only |
| Airlines | 500+ | 300+ | N/A | N/A |
| Hotels | 150,000+ | No | No | Partner-only |
| Auth | Self-service API key | Self-service API key | N/A | Business partnership |
| Free tier | ~2,000 calls/month | Search free, book paid | N/A | N/A |
| Booking | Search + price only (v1) | Full booking | N/A | N/A |
| ML predictions | Delay, trip purpose, choice | No | No | No |
| Seat maps | Yes | Yes | N/A | No |
Amadeus provides the broadest coverage and unique ML prediction endpoints. The trade-off: responses are verbose (the summary-first formatting in this plugin is essential for token efficiency).
Token efficiency
Amadeus API responses are extremely verbose — a flight search returning 250 offers can exceed 500KB of raw JSON, with nested segments, fare breakdowns, baggage rules, and dictionaries.
This plugin maps every response to compact, summary-first output:
- Flight search: one line per offer (route, stops, duration, price) — typically 5–15 lines for a paginated result
- Flight status: single-line status with departure/arrival times and delays
- Hotel offers: one line per property (name, rating, price, distance)
- Reference data: pipe-delimited lookups
A typical flights_search response is 15–25 lines vs 500KB+ raw. Pagination defaults to 10 results; use limit to control.
Test vs production
Amadeus provides two environments:
| Test | Production | |
|---|---|---|
| Base URL | test.api.amadeus.com | api.amadeus.com |
| Data | Subset (limited routes/dates) | Full GDS |
| Free quota | ~2,000 calls/month | Same free quota, pay overage |
| Rate limit | 10 req/sec | 40 req/sec |
| Registration | Instant, no payment | Requires billing + ToS signing |
The plugin defaults to the test environment. Set AMADEUS_PRODUCTION=true to use production. Test data is realistic but limited to specific routes — if a search returns no results, try major city pairs (LHR-JFK, SYD-LAX, CDG-NRT).
Safety model
All tools are read-only. This plugin does not create bookings, charge payments, or modify any external state. No write gates needed.
API credentials are scoped to your Amadeus developer account. The plugin never stores or logs credentials beyond the initial environment variable read.
Tool reference
| Tool | Category | What it does |
|---|---|---|
| flights_search | flights | Search flight offers by route, dates, passengers, cabin class |
| flights_cheapest_dates | flights | Find cheapest travel dates for a route |
| flights_cheapest_destinations | flights | Discover cheapest destinations from an origin |
| flights_seatmap | flights | Seat map with availability for a flight |
| flights_status | flights | Real-time flight status by carrier, number, and date |
| flights_delay_prediction | flights | ML probability of delay for a specific flight |
| hotels_search | hotels | Search hotels by city code or coordinates |
| hotels_offers | hotels | Pricing and availability for specific hotels |
| hotels_sentiment | hotels | Guest ratings and sentiment scores |
| airport_info | reference | Airport details, direct destinations, on-time rating |
| location_search | reference | Search airports and cities by keyword |
| airline_info | reference | Airline name and destinations by IATA code |
| price_metrics | analytics | Historical price analysis for a route |
Conformance
Setup
Register at developers.amadeus.com to get your API key and secret. No payment or approval needed for the test environment. The test environment provides realistic data for a subset of routes and dates. If a search returns no results, try major city pairs (LHR-JFK, SYD-LAX, CDG-NRT) with dates 2-4 weeks out. To use the full production dataset (500+ airlines, global coverage), set AMADEUS_PRODUCTION=true. Production requires signing the Amadeus ToS and providing billing details — you get the same free monthly quota, with pay-per-call overage at ~EUR 0.01-0.04 per call.
AMADEUS_CLIENT_ID API Key required secret AMADEUS_CLIENT_SECRET API Secret required secret AMADEUS_PRODUCTION Production Mode Prerequisites
- Amadeus developer account (free registration)
- API key and secret from developer dashboard
Scenarios
Use flights_cheapest_dates to find the cheapest travel window for the route. Then call flights_search with the best dates for detailed offers. Optionally call flights_price to confirm the top offer's price and availability.
Call flights_status with the carrier code, flight number, and date. Report current status, delays, terminal and gate info. If delays are likely, call flights_delay_prediction for the probability breakdown.
Call hotels_search with the city code to find available properties. Then call hotels_offers for the top-rated options to get pricing. Check hotels_sentiment for guest ratings and sentiment scores to compare.
Call flights_cheapest_destinations from the user's home airport. Present the top 10 cheapest destinations with prices. For interesting options, call flights_search for specific dates and hotels_search for accommodation.
After finding a flight with flights_search, call flights_seatmap to see seat availability, legroom, and pricing. Recommend seats based on user preferences (window, aisle, extra legroom, proximity to exit).
Use the Forge to design an automation pack powered by amadeus-blade-mcp for travel operations.
Install
sidereal install amadeus-blade-mcp