Find Flights
Enables searching and retrieving detailed flight information using the Duffel API, supporting various flight types and flexible search parameters for efficient travel planning.
What is Find Flights?
Find Flights is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables searching and retrieving detailed flight information using the duffel api, supporting various flight types and flexible search parameters for efficient travel planning.
Enables searching and retrieving detailed flight information using the Duffel API, supporting various flight types and flexible search parameters for efficient travel planning.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables searching and retrieving detailed flight information
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx find-flights-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Find Flights
The Find Flights MCP Server connects AI assistants to the Duffel travel API, enabling natural-language flight search for one-way, round-trip, and multi-city itineraries with full control over dates, cabin class, passenger counts, and departure times. It exposes three focused tools — search_flights, get_offer_details, and search_multi_city — that return real-time pricing and availability data so AI assistants can act as a capable travel planning agent. You need a Duffel API key to use the server; Duffel provides test keys for development that return sandboxed results.
Prerequisites
- Python 3.10 or higher installed
- uv package manager installed (recommended) or pip
- A Duffel API key — sign up at duffel.com to get a test key (DUFFEL_API_KEY_LIVE)
- An MCP-compatible client (Claude Desktop, Claude Code, or similar)
Clone the repository
Clone the flights-mcp repository since the package is not distributed on PyPI.
git clone https://github.com/ravinahp/flights-mcp
cd flights-mcpInstall dependencies with uv
Use uv to sync the project dependencies. If you do not have uv, install it with `pip install uv` first.
uv syncObtain a Duffel API key
Sign up at https://duffel.com and navigate to the API Keys section of your dashboard. Create a test key — it starts with 'duffel_test' and returns sandboxed results. For production use, complete Duffel's verification process to get a live key.
Add the server to your MCP client configuration
Open your Claude Desktop config file and add the flights-mcp entry. Set the directory path to where you cloned the repository and provide your Duffel API key in the env block.
{
"mcpServers": {
"flights-mcp": {
"command": "uv",
"args": ["--directory", "/path/to/flights-mcp", "run", "flights-mcp"],
"env": {
"DUFFEL_API_KEY_LIVE": "your_duffel_api_key_here"
}
}
}
}Restart your client and test a flight search
Restart Claude Desktop. Try a simple one-way flight search to verify connectivity to the Duffel API. With a test key, results will be simulated but structurally identical to live results.
Find Flights Examples
Client configuration
Claude Desktop configuration block for the Find Flights MCP server using uv to run from the cloned repository.
{
"mcpServers": {
"flights-mcp": {
"command": "uv",
"args": ["--directory", "/Users/yourname/flights-mcp", "run", "flights-mcp"],
"env": {
"DUFFEL_API_KEY_LIVE": "your_duffel_api_key_here"
}
}
}
}Prompts to try
Example prompts that use the three Duffel API tools for real-time flight search and planning.
- "Find a one-way flight from SFO to JFK on January 15th in economy class for 1 adult"
- "Search for round-trip flights from LAX to London, departing January 20 and returning January 27"
- "What's the cheapest direct flight from New York to Miami next week?"
- "Plan a multi-city trip: New York to Paris on March 1, Paris to Rome on March 5, Rome back to New York on March 10"
- "Compare business class options from SFO to Tokyo in the next two weeks"
- "Get full details and baggage allowances for offer ID duffel_offer_abc123"Troubleshooting Find Flights
Authentication error: DUFFEL_API_KEY_LIVE invalid or missing
Ensure the environment variable is named exactly DUFFEL_API_KEY_LIVE (not DUFFEL_API_KEY). Copy the key directly from your Duffel dashboard. Test keys begin with 'duffel_test' — they work the same way but return sandboxed data.
uv command not found when starting the server
Install uv with `pip install uv` or `curl -LsSf https://astral.sh/uv/install.sh | sh`. Alternatively, you can replace `"command": "uv"` with `"command": "python"` and `"args": ["-m", "flights_mcp"]` after running `pip install -e .` in the repository.
No flights found for valid routes and dates
Duffel test keys have limited route coverage. Try major hub routes (SFO-JFK, LAX-LHR) which are more reliably available in the sandbox. For production, verify your Duffel account is fully activated and you are using a live key.
Frequently Asked Questions about Find Flights
What is Find Flights?
Find Flights is a Model Context Protocol (MCP) server that enables searching and retrieving detailed flight information using the duffel api, supporting various flight types and flexible search parameters for efficient travel planning. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Find Flights?
Follow the installation instructions on the Find Flights GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Find Flights?
Find Flights works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Find Flights free to use?
Yes, Find Flights is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Find Flights Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Find Flights? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Find Flights in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Find Flights?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.