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.
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
