Connect your AI Agents to Amadeus in minutes
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.
validate_credential
Validate Amadeus API credentials by attempting token exchange. Returns {success, message}.
How to set up Merge Agent Handler
In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}FAQs on using Merge's Amadeus MCP server
FAQs on using Merge's Amadeus MCP server
Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now
