Skiplagged Flights Search

Skiplagged MCP Server for flight search, hotel booking, and travel planning

View on github.io

Documentation

mcp

Skiplagged Travel Search

Description

Skiplagged Travel Search connects AI assistants to Skiplagged for flight, award (miles and points), hotel, and rental-car searches.

With this server enabled, tools like Claude, ChatGPT, Cursor, and VS Code can search Skiplagged directly from a chat—no browser needed.

It uses the open Model Context Protocol (MCP), which lets AI applications call external tools through a standard HTTP interface.

Features

  • Flight search: Look up one‑way or round‑trip flights between up to three origin and three destination cities or airports, with various filters.
  • Flexible date calendars: Explore departure and return‑date calendars to find cheaper days to travel.
  • “Anywhere” destination discovery: See low‑fare destinations from a chosen origin when you’re flexible on where to go.
  • Hotel search and details: Search hotels by city and dates, then retrieve room‑level pricing, amenities, and availability.
  • Local currency: Show flight, hotel, calendar, and destination prices in one of 25 currencies (see Prices and currency).
  • Rental car search: Find rental cars at or near your destination for specific pickup and drop‑off times.
  • Award search (miles and points): Find award seats bookable with airline miles or points (Aeroplan, Alaska Mileage Plan, Flying Blue, Delta SkyMiles, United MileagePlus, Virgin Atlantic and more), with miles and taxes per traveler. Search several airports, a metro code, or a whole region such as Europe, on one date, a date window, a few days either side, or any date in about the next two months.

Setup

HTTP request bodies are limited to 64 KiB. Tool arguments are limited to 1,000 object keys and array items in total. Split larger requests into separate calls.

This server works with any client that supports remote MCP over HTTP.

  1. Add the Skiplagged MCP URL (https://mcp.skiplagged.com/mcp) in your client’s MCP or “Connectors” settings.
  2. Enable the server for the project or chat where you want to use it.
  3. Ask travel questions in plain language; your assistant will call MCP tools when needed.

Client‑specific setup guides

The snippets below show how to add the MCP server in common tools and editors.

Cursor Installation link
Add to Cursor

Manual installation
Add the following to your mcp.json file:

{
  "mcpServers": {
    "skiplagged": {
      "url": "https://mcp.skiplagged.com/mcp"
    }
  }
}

VS Code Installation link
Install in VS Code

Manual installation
Open a terminal and run:

code --add-mcp '{"type":"http","name":"skiplagged","url":"https://mcp.skiplagged.com/mcp"}'

Then, from inside VS Code, open the .vscode/mcp.json file and click "Start server". Claude Code Run the following command in your terminal:

claude mcp add --transport http "skiplagged" https://mcp.skiplagged.com/mcp

From within Claude Code, use the /mcp command to get more information about the server. Claude Desktop Steps:

1. Navigate to Settings > Connectors.
2. Locate the "Connectors" section.
3. Click "Add custom connector" at the bottom of the section.
4. Add your connector's remote MCP server URL: https://mcp.skiplagged.com/mcp
5. Finish configuring your connector by clicking "Add."

ChatGPT

1. Navigate to Settings > Connectors.
2. Add a custom connector with the server URL "https://mcp.skiplagged.com/mcp".
3. Verify that it appears in the Composer > tools.
4. Add the server as a source if needed.

Gemini CLI Add the following JSON to your Gemini CLI configuration file (~/.gemini/settings.json):

{
  "mcpServers": {
    "skiplagged": {
      "httpUrl": "https://mcp.skiplagged.com/mcp"
    }
  }
}

Codex Manual installation

Add the following to your Codex config file (~/.codex/config.toml):

[mcp_servers.skiplagged]
url = "https://mcp.skiplagged.com/mcp"

Authentication

No authentication required. Skiplagged MCP is a public server that does not require user accounts, API keys, or OAuth. Simply connect using the server URL and start searching.

Examples

The following examples show realistic prompts and what the server does behind the scenes.

Example 1: Search for flights

User prompt: “Find the cheapest flights from San Francisco to New York in late October for one adult in economy class.”

What happens:

  1. The server calls sk_flights_search with origin SFO, destination JFK, additional destinations EWR and LGA, dates in late October, 1 adult, economy class
  2. Skiplagged returns available itineraries including standard fares and hidden‑city deals
  3. Results show prices, airlines, layovers, and durations—with links to book on Skiplagged

Example 2: Explore flexible dates to save money

User prompt: “Show me a fare calendar for round‑trip flights from Chicago to Miami around March 15. I can leave a few days earlier or later.”

What happens:

  1. The server calls sk_flex_departure_calendar to get one‑way fares for nearby departure dates
  2. Then calls sk_flex_return_calendar to find the cheapest return dates that maintain a similar trip length
  3. Results display a calendar view of prices so you can pick the cheapest travel window

Example 3: Discover cheap destinations anywhere

User prompt: “I’m in Boston and want to fly somewhere warm and cheap in February. Where should I go?”

What happens:

  1. The server calls sk_destinations_anywhere with origin BOS and dates in February
  2. Skiplagged returns the cheapest destinations sorted by price
  3. Results include destination cities, lowest fares, and average temperatures—helping you discover budget‑friendly trips

Example 4: Search hotels and get room details

User prompt: “Find hotels in Barcelona for 3 nights starting January 10 for two adults. Then show me details for the best‑reviewed option.”

What happens:

  1. The server calls sk_hotels_search with location Barcelona, check‑in January 10, check‑out January 13, 2 adults
  2. Results return available hotels with nightly rates, ratings, and amenities
  3. For a selected hotel, the server calls sk_hotel_details to retrieve room‑level pricing, cancellation policies, and photos

Example 5: Find award seats with miles or points

User prompt: “I have Aeroplan points. Where in Europe can I fly business class from New York in early December?”

What happens:

  1. The server calls sk_award_search with origins NYC, destinations europe, departure dates December 1 to 10, cabin business, and program aeroplan
  2. Skiplagged returns award seats with the miles and taxes for each date, route, and program, plus the cheapest award to each destination
  3. Results include a link to the same search on Skiplagged’s award search; you book the award on the program’s site

Prices and currency

Skiplagged search prices are in US dollars. These tools take an optional currency (an ISO 4217 code, default USD): sk_flights_search, sk_hotels_search, sk_hotel_details, both flexible-date calendars, and the “anywhere” destination search. Your assistant can pass your local currency when it knows it, for example GBP in the UK or EUR in Germany.

Supported currencies: USD, AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, IDR, INR, JPY, KRW, MXN, MYR, PLN, RON, SEK, SGD, TRY, TWD, UAH, VND.

  • Prices in other currencies are approximate. They are converted once from the USD price with Skiplagged’s exchange rate, which the server refreshes about every hour. The final charge on the booking site may differ.
  • Results are still sorted by the USD price, and booking links do not change.
  • Each card’s price includes amount, currency, and the original usdAmount (calendar points have price and usdPrice). The result’s pricing field gives the rate and when it was fetched.
  • sk_hotel_details keeps its structured prices in USD and shows converted prices in its text output, with the rate in pricing.
  • If the exchange rate cannot be loaded, prices are shown in USD and the response says so.
  • Rental car prices are in USD.
  • sk_award_search prices awards in miles. Its taxes and fees are shown in the requested currency (default USD) with usdAmount; when the program charges another currency (for example CAD for Aeroplan), fees.charged gives that amount.

Privacy Policy

When your assistant calls these tools:

  • Only request-specific travel inputs are sent to Skiplagged APIs. Depending on the tool, these can include travel locations, dates and times, passenger or room counts, search filters, or a selected hotel identifier. FAQ question text is processed through OpenAI embeddings and Supabase retrieval to find relevant support articles.
  • Optional coarse location is used only to suggest an origin airport. When the client supplies coarse location metadata, the server uses its latitude and longitude for that lookup. The tool does not ask the user or model to provide coordinates, and coordinates are not returned in its response.
  • Results come from Skiplagged. Pricing, availability, and deal information are provided by Skiplagged and its partners. Always confirm details on skiplagged.com before booking.
  • Links use static attribution tags. Skiplagged links may include utm_source=mcp, utm_medium=ai, and utm_campaign=skiplagged_mcp; these tags do not identify the user or client.
  • The MCP server does not require an account. Tool responses do not include user identifiers, account data, ChatGPT conversation history, session identifiers, request identifiers, or telemetry.
  • Operational monitoring is limited. The MCP server uses Sentry for errors and performance monitoring with default collection of personally identifiable information disabled. Tool arguments are not intentionally written to application logs.

For MCP-specific data practices, retention, sharing, and user controls, see the Skiplagged Travel Search Privacy Notice. It supplements Skiplagged’s Privacy Policy. Service terms are available in the Terms of Service.

Limits and reliability

  • Rate limits: The MCP server does not currently enforce strict per‑user rate limits, but very heavy automated usage may be throttled or blocked to protect the service.
  • Data freshness: Flight, hotel, and car prices change frequently. Treat results as indicative only and always open the Skiplagged link to confirm the latest price and conditions before booking.