Flight & Stay Search Server is a travel booking search tool powered by the Duffel API that enables flight and accommodation discovery. Key capabilities: - Search for one-way, round-trip, and multi-city flights with filters for cabin class, passenger count, and connection preferences - Retrieve detailed information about specific flight offers including pricing and itinerary details - Search for hotels and accommodations by location, check-in/check-out dates, number of guests, and rooms - Access guest reviews and ratings for specific hotels and stays - Filter results by departure/arrival time windows and price ranges The server integrates with Duffel's airline distribution platform to provide real-time flight inventory and accommodation data.

Flight + Stay Search MCP (TypeScript)

A TypeScript implementation of a flight & Stay search MCP server that uses the Duffel API to search for flights. This MCP server provides tools to search for one-way, round-trip, and multi-city flights.

[](https://smithery.ai/server/@clockworked247/flights-mcp-ts)

Features

Setup

1. Install dependencies:

   npm install
   

2. Build the project:

   npm run build
   

3. Start the server:

   npm start
   

Environment Variables

Create a .env file with:

DUFFEL_API_KEY=your_duffel_api_key

You can start with a test API key (duffel_test) to try the functionality.

Using with Smithery

To publish this MCP to Smithery:

npx @smithery/cli publish

To run the published MCP:

npx @smithery/cli run @your-username/flights-mcp-ts --config "{\"duffelApiKey\":\"your_duffel_api_key\"}"

Available Tools

This MCP provides the following tools:

1. search_flights - Search for one-way, round-trip, or multi-city flights 2. get_offer_details - Get detailed information about a specific flight offer 3. search_multi_city - A specialized tool for multi-city flight searches 4. search_stays - Search for travel stays (hotels/accommodations) 5. get_stay_reviews - Get guest reviews for a specific stay/hotel

Example Queries

---

Stays/Hotel Search and Reviews

1. Search for Stays (search_stays)

Parameters:

Example Request:

{
  "location": "London",
  "check_in_date": "2025-06-10",
  "check_out_date": "2025-06-12",
  "guests": 2
}

Example Response:

{
  "offers": [
    {
      "offer_id": "off_123",
      "hotel_id": "acc_0000AWr2VsUNIF1Vl91xg0",
      "hotel_name": "The Grand Hotel",
      "address": "1 Main St, London",
      "price": { "amount": "350.00", "currency": "GBP" },
      "room_type": "Deluxe Suite",
      "cancellation_policy": "Free cancellation until 24h before check-in"
    }
  ]
}

Note: Use the hotel_id from the search results as the stay_id for reviews.

---

2. Get Stay Reviews (get_stay_reviews)

Parameters:

Example Request:

{
  "stay_id": "acc_0000AWr2VsUNIF1Vl91xg0"
}

Example Response:

{
  "meta": { "limit": 50, "after": "..." },
  "reviews": [
    {
      "text": "Excellent facilities. Polite staff.\nAir conditioning could use some maintenance.\n",
      "score": 8.4,
      "reviewer_name": "Bessie Coleman",
      "created_at": "2025-01-01"
    }
  ]
}

Local Development

For development with automatic reloading:

npm run dev

License

MIT