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
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
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
duckduckgo-search MCP Server
zhsama
DuckDuckGo Search MCP Server
nickclydeA Model Context Protocol (MCP) server that provides web search capabilities through DuckDuckGo, with additional features for content fetching and parsing.
Web Scout MCP Server
pinkpixel-devA powerful MCP server extension providing web search and content extraction capabilities. Integrates DuckDuckGo search functionality and URL content extraction into your MCP environment, enabling AI assistants to search the web and extract webpage content programmatically.
Baidu AI Search
baidubceappbuilder-sdk, 千帆AppBuilder-SDK帮助开发者灵活、快速的搭建AI原生应用
Version 2.0 is here!!
mixelpixxMCP Server built for use with Claude Code, Claude Desktop, VS Code, Cline - enable google search and ability to follow links and research websites
Comments