What is Flights Mcp Ts

flights-mcp-ts is a TypeScript implementation of a flight and stay search MCP server that utilizes the Duffel API to search for flights. It provides tools for searching one-way, round-trip, and multi-city flights.

Use cases

Use cases include searching for flights between cities, retrieving detailed information about specific flight offers, and finding suitable hotels or accommodations for travelers.

How to use

To use flights-mcp-ts, install the dependencies with ‘npm install’, build the project using ‘npm run build’, and start the server with ‘npm start’. Configure your Duffel API key in a .env file.

Key features

Key features include searching for one-way, round-trip, and multi-city flights, obtaining detailed flight offer information, specifying cabin class and passenger numbers, filtering by departure and arrival times, searching for accommodations, and accessing guest reviews.

Where to use

flights-mcp-ts can be used in travel agencies, flight booking platforms, and any application that requires flight and accommodation search functionalities.

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.

Features

• Search for one-way, round-trip, and multi-city flights
• Get detailed information about specific flight offers
• Specify cabin class, number of passengers, and connection preferences
• Filter by departure and arrival time windows
• Search for travel stays (hotels/accommodations)
• Get guest reviews for a specific stay/hotel

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

• “Find flights from SFO to NYC on May 15, 2025”
• “Search for a round-trip flight from LAX to LHR departing June 10 and returning June 20”
• “Find business class flights from Tokyo to Paris for 2 adults”
• “Get details for flight offer [offer_id]”
• “Find hotels in London for 2 guests from 2025-06-10 to 2025-06-12”
• “Get reviews for stay [hotel_id]”

Stays/Hotel Search and Reviews

1. Search for Stays (search_stays)

Parameters:

• location (string): City, airport code, or area to search for stays
• check_in_date (string): Check-in date (YYYY-MM-DD)
• check_out_date (string): Check-out date (YYYY-MM-DD)
• guests (number): Number of guests
• rooms (number, optional): Number of rooms
• radius_km (number, optional): Search radius in kilometers

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:

• stay_id (string): The unique Duffel stay/hotel ID (from the search_stays result)
• after (string, optional): Pagination cursor (after)
• before (string, optional): Pagination cursor (before)
• limit (number, optional): Max reviews to return (1-200)

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