Flight + Stay Search MCP (TypeScript)
About
A TypeScript implementation of a flight 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.
Details
- Transport
- SSE
Explore
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Flight + Stay Search MCP (TypeScript)Command (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Install dependencies:
npm install
2. Build the project:
npm run build
3. Start the server:
npm start
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.
search_flights
get_offer_details
search_multi_city
search_stays
get_stay_reviews
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
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"flight + stay search mcp (typescript)": {
"flights-mcp-ts": {
"command": "npx",
"args": [
"@smithery/cli",
"publish"
]
}
}
}
}McpServers
{
"flights-mcp-ts": {
"command": "npx",
"args": [
"@smithery/cli",
"publish"
]
}
}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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
