Flight + Stay Search MCP (TypeScript)

What is Flight + Stay Search MCP (TypeScript)?

A TypeScript implementation of an MCP server that uses the Duffel API to search for flights and stays (hotels/accommodations). It provides tools for one-way, round-trip, and multi-city flight searches, along with stay searches and guest review retrieval.

How to use Flight + Stay Search MCP (TypeScript)?

Install dependencies (npm install), build (npm run build), and start (npm start). Set the DUFFEL_API_KEY environment variable in a .env file. For Smithery, publish with npx @smithery/cli publish and run with npx @smithery/cli run @your-username/flights-mcp-ts --config "{\"duffelApiKey\":\"your_duffel_api_key\"}". Available tools include search_flights, get_offer_details, search_multi_city, search_stays, and get_stay_reviews.

Key features of Flight + Stay Search MCP (TypeScript)

• Search one-way, round-trip, and multi-city flights
• Get detailed flight offer information
• Specify cabin class, passenger count, and connection preferences
• Filter by departure and arrival time windows
• Search for travel stays and hotels
• Retrieve guest reviews for a specific stay

Use cases of Flight + Stay Search MCP (TypeScript)

• Find flights from SFO to NYC on a specific date
• Search for round‑trip business class flights between two cities
• Plan multi‑city itineraries
• Look up hotels in a location for given check‑in/check‑out dates
• Get recent guest reviews for a hotel by its Duffel ID

FAQ from Flight + Stay Search MCP (TypeScript)

What API key is required?

A DUFFEL_API_KEY environment variable must be set. You can start with a test API key (duffel_test) to try the functionality.

How do I get stay reviews?

Use the get_stay_reviews tool with the stay_id parameter. The stay_id is the hotel_id returned by the search_stays tool.

Can I paginate review results?

Yes, get_stay_reviews accepts optional after, before, and limit (1–200) parameters for pagination.

What transport/auth does the server use?

The server connects to the Duffel API using the provided API key. No other transport or authentication method is mentioned.

Are there any known limits?

The review limit parameter is capped at 200 per request. Otherwise, limits depend on the Duffel API.