Flight + Stay Search MCP (TypeScript)
@clockworked247
About Flight + Stay Search MCP (TypeScript)
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.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"flights-mcp-ts": {
"command": "npx",
"args": [
"@smithery/cli",
"publish"
]
}
}
}Tools
No tools detected
Fetch the live tool list by running this server in a temporary sandbox using the button above.
Overview
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.
Frequently asked questions
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.
Basic information
More Search MCP servers
Google Search Console MCP server for SEOs
AminForouGoogle Search Console Insights with Claude AI for SEOs
patent-literature-search-mcp
patsnapA professional tool for searching Patsnap’s global patent and literature databases using natural language, semantic, or keyword queries. It supports precise filtering and retrieves bibliographic data in Markdown format.
Tavily Mcp
tavily-aiProduction ready MCP server with real-time search, extract, map & crawl.
Serper Search and Scrape MCP Server
marcopesaniSerper MCP Server supporting search and webpage scraping
Google News MCP Server
ChanMeng666【Star-crossed coders unite!⭐️】Model Context Protocol (MCP) server implementation providing Google News search capabilities via SerpAPI, with automatic news categorization and multi-language support.
Comments