UBOS Asset Marketplace: Revolutionizing Travel with the Flight + Stay Search MCP Server

In the dynamic world of AI-driven solutions, the UBOS Asset Marketplace is proud to present a game-changing tool for travel and transportation: the Flight + Stay Search MCP (Model Context Protocol) Server. Built with TypeScript and leveraging the robust Duffel API, this MCP server is engineered to streamline and enhance the search experience for flights and accommodations. This innovative server embodies the future of travel tech, offering unparalleled flexibility and precision in travel planning.

Understanding MCP Servers and Their Significance

Before diving into the specifics of the Flight + Stay Search MCP Server, it’s crucial to understand the role and significance of MCP (Model Context Protocol) Servers. An MCP server acts as a crucial bridge between AI models and external data sources. In essence, it standardizes how applications provide context to Large Language Models (LLMs). This standardization allows AI agents to access, interpret, and utilize real-world data, which is pivotal for creating intelligent and context-aware applications.

The UBOS platform champions the use of MCP servers to enhance the capabilities of AI Agents. By integrating MCP servers, UBOS empowers these agents to perform complex tasks with greater accuracy and efficiency. This is particularly valuable in industries like travel, where real-time data and precise contextual understanding are essential for delivering optimal results.

The Flight + Stay Search MCP Server: A Deep Dive

The Flight + Stay Search MCP Server is a TypeScript implementation designed to interact with the Duffel API. Duffel provides a comprehensive suite of tools for airlines and travel providers, making it an ideal partner for this MCP server. This server allows users to search for:

• One-way flights: Perfect for travelers with flexible plans.
• Round-trip flights: Catering to the traditional travel needs of returning to the origin.
• Multi-city flights: Suited for complex itineraries with multiple destinations.

Key Features and Functionalities

1. Comprehensive Flight Search: The server provides a robust tool to search flights based on various criteria, including origin, destination, dates, and passenger details. This feature is indispensable for travel agents and individual travelers alike.
2. Detailed Flight Offer Information: Beyond basic search, the server offers detailed insights into specific flight offers. Users can access information on flight times, layovers, and included amenities, ensuring informed decision-making.
3. Advanced Filtering Options: The server allows users to specify preferences such as cabin class, the number of passengers, and connection preferences. This granular control ensures that search results align perfectly with individual requirements.
4. Time Window Filtering: Users can refine their search by specifying departure and arrival time windows. This feature is particularly useful for those with tight schedules or specific timing requirements.
5. Travel Stay Search: Recognizing that flights are just one part of the travel equation, the server includes functionality to search for travel stays, including hotels and other accommodations. This integration simplifies the planning process, allowing users to find both flights and stays in one place.
6. Guest Reviews: To provide a holistic view of potential accommodations, the server provides access to guest reviews for hotels and stays. This feature enables users to make informed decisions based on the experiences of others.

Use Cases: Transforming the Travel Industry

The Flight + Stay Search MCP Server unlocks a myriad of use cases, each designed to enhance and streamline the travel planning process:

• Travel Agencies: Agents can leverage the server to quickly find the best flight and stay options for their clients, saving time and improving customer satisfaction.
• Online Travel Platforms: Online platforms can integrate the server to offer users a comprehensive search experience, allowing them to find flights and accommodations in one seamless process.
• Corporate Travel Management: Businesses can use the server to manage employee travel, ensuring cost-effective and convenient travel arrangements.
• Personal Travel Planning: Individual travelers can use the server to plan their own trips, finding the best deals and accommodations for their specific needs.

Getting Started with the Flight + Stay Search MCP Server

Integrating the Flight + Stay Search MCP Server into your workflow is straightforward. Here’s a step-by-step guide:

1. Installation: Begin by installing the necessary dependencies using npm:

   bash npm install

2. Build the Project: Next, build the project using the following command:

   bash npm run build

3. Start the Server: Start the server with:

   bash npm start

Environment Variables

To configure the server, create a .env file with your Duffel API key:

DUFFEL_API_KEY=your_duffel_api_key

You can use a test API key (duffel_test) to explore the server’s functionality.

Integration with UBOS Platform

To fully harness the power of the Flight + Stay Search MCP Server, consider integrating it with the UBOS platform. UBOS provides a comprehensive environment for developing and deploying AI Agents. By connecting the MCP server to UBOS, you can create intelligent agents that automate and enhance travel planning tasks.

Publishing to Smithery

To publish this MCP to Smithery, a platform that is part of the UBOS ecosystem, use the following command:

bash npx @smithery/cli publish

To run the published MCP:

bash npx @smithery/cli run @your-username/flights-mcp-ts --config ‘{“duffelApiKey”:“your_duffel_api_key”}’

Available Tools: Empowering AI Agents

This MCP server provides a suite of tools designed to empower AI Agents and streamline travel planning:

1. search_flights: Search for one-way, round-trip, or multi-city flights.
2. get_offer_details: Retrieve detailed information about specific flight offers.
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: Access guest reviews for hotels and stays.

Example Queries: Real-World Applications

Here are some example queries to illustrate the server’s capabilities:

• “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]”

Deep Dive: 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: Enhancing the Server

For local development with automatic reloading, use the following command:

bash npm run dev

UBOS: The Full-Stack AI Agent Development Platform

The UBOS platform is more than just a marketplace; it’s a comprehensive ecosystem designed to bring AI Agents to every business department. Focused on orchestrating AI Agents, connecting them with enterprise data, building custom AI Agents with your LLM model, and facilitating Multi-Agent Systems, UBOS provides the tools and infrastructure needed to revolutionize business operations.

By leveraging the UBOS platform, businesses can:

• Orchestrate AI Agents: Manage and coordinate multiple AI Agents to work together seamlessly.
• Connect to Enterprise Data: Integrate AI Agents with your existing data sources, ensuring access to real-time information.
• Build Custom AI Agents: Create AI Agents tailored to your specific needs and requirements.
• Utilize Multi-Agent Systems: Implement complex systems that leverage the collective intelligence of multiple AI Agents.

License

The Flight + Stay Search MCP Server is released under the MIT License, ensuring flexibility and freedom for developers.

Conclusion: Embracing the Future of Travel Tech

The Flight + Stay Search MCP Server on the UBOS Asset Marketplace represents a significant advancement in travel technology. By leveraging the power of AI and the flexibility of the Duffel API, this server offers unparalleled capabilities for flight and accommodation search. Whether you are a travel agency, an online platform, or an individual traveler, this MCP server can transform the way you plan and manage travel. Embrace the future of travel tech with the Flight + Stay Search MCP Server and the UBOS platform.