> This page is for Agent Handler. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # Amadeus **Authentication:** API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow. ## Sample use cases * Find round-trip flights from JFK to LHR next Friday under \$800, sorted by total travel time. * List hotels within walking distance of the Berlin convention center under €200/night. * Quote a multi-city itinerary - SFO to Tokyo to Singapore to SFO - across the next two weeks. ## Available Tools #### search\_activities Search tours and activities near a location. Provide latitude and longitude. Optional radius (1-20 km). Great for finding things to do at a destination. #### get\_activity Get details for a specific tour or activity. Provide the activity ID from search\_activities response. #### search\_transfer\_offers Search airport transfer options (taxi, limo, shuttle). Provide pickup location IATA code, date-time, and drop-off details (address, city, or coordinates). #### create\_transfer\_order Book a transfer (taxi, limo, shuttle). Provide the offer ID from search\_transfer\_offers and optional passenger details. #### get\_most\_booked\_destinations Get most booked flight destinations from an origin city for a given month. Provide origin IATA city code and period (YYYY-MM). Use search\_locations to find city codes. #### get\_most\_traveled\_destinations Get most traveled flight destinations from an origin city for a given month. Provide origin IATA city code and period (YYYY-MM). #### get\_busiest\_periods Get busiest travel periods for a city in a given year. Provide IATA city code and period (YYYY). Optionally filter by ARRIVING or DEPARTING direction. #### create\_flight\_order Book a flight by creating a flight order. Requires flight\_offers from search/pricing and traveler details (name, DOB, contact). Use search\_flight\_offers then price\_flight\_offers first. #### get\_flight\_order Get flight order details by order ID (PNR reference). Use the ID returned from create\_flight\_order. #### delete\_flight\_order Cancel a flight order by order ID. This operation cannot be undone. #### search\_flight\_offers Search flight offers by origin, destination, date, and travelers. Returns priced offers with itineraries. Use search\_locations to find IATA codes. For multi-city, use advanced\_flight\_search instead. #### advanced\_flight\_search Advanced flight search (POST) supporting multi-city, flexible dates, and complex filters. Provide origin\_destinations and travelers. For simple one-way/round-trip, use search\_flight\_offers instead. #### price\_flight\_offers Confirm pricing for selected flight offers. Pass full flight offer objects from search\_flight\_offers response data array. #### search\_flight\_inspirations Find cheapest flight destinations from an origin. Returns destinations with prices. Great for 'where can I fly?' queries. Use search\_locations to find origin IATA code. #### search\_cheapest\_dates Find cheapest travel dates for a route. Returns dates with prices for origin-destination pair. Use search\_locations to find IATA codes. #### search\_flight\_availabilities Check seat availability for flights. Provide origin\_destinations and travelers (same format as advanced\_flight\_search). #### get\_seat\_map Get seat map for flight offers. Pass full flight offer objects from search\_flight\_offers response data array. #### get\_branded\_fares Get branded fare upsell options for flight offers. Pass full flight offer objects from search\_flight\_offers response data array. #### predict\_flight\_choice AI prediction of which flight offer a user will choose. Pass full flight offer objects from search\_flight\_offers response data array. #### list\_hotels\_by\_city List hotels in a city by IATA city code (e.g., 'PAR' for Paris). Filter by radius, chain, amenities, star rating. Use search\_locations to find city codes. Use offset for pagination. #### list\_hotels\_by\_geocode List hotels near coordinates (latitude/longitude). Filter by radius, chain, amenities, star rating. Use offset for pagination. #### list\_hotels\_by\_ids Get specific hotels by Amadeus property codes (8-char IDs). Use list\_hotels\_by\_city to find hotel IDs first. #### search\_hotel\_offers Search hotel prices and availability. Provide hotel IDs from list\_hotels\_by\_city. Filter by dates, adults, rooms, price range, board type. Returns offers with room details and pricing. #### create\_hotel\_booking Book a hotel room. Requires guest details, room associations (offer IDs from search\_hotel\_offers), and payment card. Use search\_hotel\_offers first to get offer IDs. #### get\_hotel\_sentiments Get hotel sentiment ratings and review scores. Provide up to 3 hotel IDs from list\_hotels\_by\_city. Returns overall rating and category scores. #### search\_locations Search airports and cities by keyword. Returns IATA codes, names, and coordinates. Use sub\_type to filter by AIRPORT, CITY, or both. Use offset from page\_info for next page. #### search\_cities Search cities by keyword. Returns city IATA codes, names, and country info. Use offset from page\_info for next page. #### search\_airports Search airports by keyword. Returns airport IATA codes, names, and coordinates. Use offset from page\_info for next page. #### lookup\_airline Look up airline by IATA (2-letter) or ICAO (3-letter) code. Returns airline name and codes. #### get\_checkin\_links Get airline online check-in URLs. Provide IATA airline code (e.g., 'BA' for British Airways). #### get\_flight\_schedule Get flight schedule/timetable for a specific flight. Provide IATA airline code, flight number, and departure date. Use lookup\_airline to find airline codes. #### get\_airport\_routes Get direct flight destinations from an airport. Provide IATA airport code. Use search\_airports to find codes. Use offset for pagination. #### get\_airline\_routes Get airline route network (all destinations served). Provide IATA airline code. Use lookup\_airline to find codes. Use offset for pagination.