How to Use the Amadeus MCP in Windsurf

Q: Does the Amadeus MCP server on Windsurf support live status tracking?

Yes, Cascade uses the getflightstatus tool to pull real-time schedules. You can ask the agent to monitor a flight number, and it will fetch the current departure and arrival times directly inside your workspace.

Q: What happens if a flight search returns no results?

The searchflights tool returns an empty array, which Cascade detects immediately. The agent will then automatically adjust the search parameters or run getflightinspirations to suggest alternative destinations.

Let Windsurf Cascade autonomously chain travel searches, book flights, and map hotel options without leaving your editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Amadeus MCP to Windsurf

Create your Vinkius account to connect Amadeus to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Amadeus with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Multi-Step Route Planning with Windsurf MCP Server

The `search_flights` tool feeds real-time flight offers directly to Cascade so it can map out complex multi-city itineraries. When you ask Windsurf to find the best way to get a team to a conference, Cascade runs the query, grabs the airline codes, and filters the results in one go. It doesn't stop at raw search. Cascade automatically chains this with `get_cheapest_dates` to find when fares drop, presenting you with a finished comparison table without you having to prompt each individual step.

Coordinate Hotels and Airport Transfers

The `search_hotels_nearby` tool targets lodging options near specific geographic coordinates, giving Cascade the exact location data it needs to build localized maps. If you ask for a hotel near the Eiffel Tower, the agent finds the properties and extracts their unique IDs instantly. From there, Cascade calls `search_transfers` to find rides from the closest airport to those specific hotels. You get a complete door-to-door transit plan generated in a single autonomous execution loop.

Build Local Activity Guides Automatically

The `search_activities` tool retrieves curated local tours and things to do based on latitude and longitude coordinates. Cascade uses this raw data to construct markdown itineraries or populate JSON objects for your travel applications. By combining this with `get_flight_inspirations`, the MCP server identifies cheap weekend getaways from your home airport and pairs them with top-rated local spots. It handles the entire lookup chain, leaving you with a ready-to-use travel brief.

Setup guide

Set up Amadeus MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Amadeus MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Amadeus payment history." If connected, Cascade will call the Amadeus tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "amadeus-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Amadeus. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Amadeus now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Amadeus MCP in Windsurf

Open your Windsurf settings, head to the Cascade MCP Servers UI, and add the server configuration. Alternatively, paste the endpoint directly into your `~/.codeium/windsurf/mcp_config.json` file under the `mcpServers` key to let Cascade auto-discover the tools.

Yes, that is exactly what Cascade does. You give it a single prompt like 'find a cheap trip to Tokyo next month,' and it automatically calls `search_airports`, runs `get_cheapest_dates`, and presents the final flight options.

Yes, Cascade uses the `get_flight_status` tool to pull real-time schedules. You can ask the agent to monitor a flight number, and it will fetch the current departure and arrival times directly inside your workspace.

The `search_flights` tool returns an empty array, which Cascade detects immediately. The agent will then automatically adjust the search parameters or run `get_flight_inspirations` to suggest alternative destinations.

All flight queries, airport codes, and coordinates processed by the server run inside an isolated V8 sandbox. Your search history and API keys never touch external logs, ensuring your travel planning remains private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript