Advertise
MCP.so
Sign In

Flight + Stay Search MCP (TypeScript)

@clockworked247

Repository

Basic information

Category

Search

Transports

stdio

Author

clockworked247

About Flight + Stay Search MCP

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.

#flights-mcp#flight-search#travel-assistant

Flight + Stay Search MCP config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "flights-mcp-ts": {
      "command": "npx",
      "args": [
        "@smithery/cli",
        "publish"
      ]
    }
  }
}

Flight + Stay Search MCP tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

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.

3

Can I paginate review results?

Yes, `get_stay_reviews` accepts optional `after`, `before`, and `limit` (1–200) parameters for pagination.

4

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.

5

Are there any known limits?

The review limit parameter is capped at 200 per request. Otherwise, limits depend on the Duffel API.

Comments

More Search MCP servers

FlexQueries SEO MCP

CybrCoast LLC

Hosted SEO MCP server for Claude, ChatGPT, Cursor, and Codex. Keyword research, current and historical SERPs, rank tracking, backlinks, site audits, and AI visibility, plus free Google Search Console and GA4 reads. Pay p

3

3GPP Scout

3gppscout

Hosted 3GPP MCP server: cited search across Rel-15 through Rel-20 TS/TR specs, recent TDocs, company proposals and meeting decisions. OAuth 2.1; no local index required.

Theyond

theyond

If it's here, it's on their board. Search live verified jobs from employer career pages.

VerifyAPI

Circuit Savers LLC

Fact-check any claim with live web sources. Ed25519-signed receipts. Catches hallucinations.

Fitralo

Fitralo

Search Europe's road freight carriers from your AI assistant: find carriers by route, equipment and certificates among 15,700+ checked carriers in 32 countries, in 14 languages. Read-only, no account needed for searching

Advertise