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
- Author
- clockworked247
- Downloads
- 299
- Categories
- Search
Jump to
- 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
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
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.
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"
]
}
}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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
