Skiplagged Flights

- **Server URL:** `https://mcp.skiplagged.com/mcp`
- **Auth:** none (public server)

## Prerequisites

1) Ensure the `mcporter` CLI is available on PATH (this skill declares it as a required binary).

2) Prefer **ad-hoc HTTPS targeting** (no local mcporter config required):

```bash
# Inspect tools + schemas (recommended)
mcporter list https://mcp.skiplagged.com/mcp --schema
````

## Quick start

```bash
mcporter call https://mcp.skiplagged.com/mcp.sk_flights_search origin=WAW destination=LHR departureDate=2026-03-15 --output json
```

> If your environment already has a configured server name `skiplagged`, `mcporter call skiplagged.sk_flights_search ...` is equivalent. Using the explicit HTTPS URL is preferred because it avoids relying on (or enumerating) local MCP config.

## Tools

### sk_flights_search

Search flights between locations.

**Required:** `origin`, `destination`, `departureDate`

**Common options (verify exact names via `--schema`):**

* `returnDate` - round-trip date
* `sort` - `price`, `duration`, `value` (default)
* `limit` - max results (default ~12)
* `maxStops` - `none`, `one`, `many`
* `fareClass` - `basic-economy`, `economy`, `premium`, `business`, `first`
* `preferredAirlines` / `excludedAirlines` - comma-separated IATA codes (e.g., `UA,DL`)
* `departureTimeEarliest` / `departureTimeLatest` - minutes from midnight (`0–1439`)

**Examples:**

```bash
# Cheapest one-way
mcporter call https://mcp.skiplagged.com/mcp.sk_flights_search origin=NYC destination=LAX departureDate=2026-03-15 sort=price limit=5

# Round-trip, nonstop only
mcporter call https://mcp.skiplagged.com/mcp.sk_flights_search origin=WAW destination=CDG departureDate=2026-04-10 returnDate=2026-04-17 maxStops=none limit=5

# Exclude budget airlines, morning only (6am–12pm)
mcporter call https://mcp.skiplagged.com/mcp.sk_flights_search origin=LHR destination=JFK departureDate=2026-05-01 excludedAirlines=F9,NK departureTimeEarliest=360 departureTimeLatest=720 limit=5
```

### sk_flex_departure_calendar

Find cheapest fares around a departure date.

```bash
mcporter call https://mcp.skiplagged.com/mcp.sk_flex_departure_calendar origin=WAW destination=BCN departureDate=2026-06-15 sort=price --output json
```

### sk_flex_return_calendar

Find cheapest round-trip fares for a fixed trip length.

```bash
mcporter call https://mcp.skiplagged.com/mcp.sk_flex_return_calendar origin=WAW destination=NYC departureDate=2026-07-01 returnDate=2026-07-08 --output json
```

### sk_destinations_anywhere

Discover cheap destinations when flexible.

```bash
mcporter call https://mcp.skiplagged.com/mcp.sk_destinations_anywhere from=WAW depart=2026-03-15 --output json
```

## Response formatting

When presenting results to users:

* **Never use markdown tables** — use bullet lists or labeled lines.
* Use **MarkdownV2**-compatible formatting when replying in Telegram-style channels.
* Keep replies **mobile-friendly**: concise, scannable.
* Show **top 3–5** options by default; offer to expand.
* Include booking/deep links when returned.
* If hidden-city itineraries appear, present clear caveats (checked-bag constraints and missed-leg implications).
* Highlight savings, routing insights, and key tradeoffs (stops vs duration vs price).


**Good example:**

```
Found 3 flights WAW → LHR on Mar 15:

• $90 · 2h 35m · nonstop
  LOT
  05:40 WAW → 07:15 LHR
  [Book](link)

• $91 · 4h 20m · 1 stop
  SAS
  06:10 WAW → 09:30 LHR
  [Book](link)
```

## Tips

* Prefer **IATA codes** (e.g., `WAW`, `LHR`, `JFK`) when possible.
* Use `--output json` when you need structured data for post-processing.
* Results often include a `deepLink` (or similar) for booking/verification.
* For failures other than lack of results, suggest using https://skiplagged.com directly.
* Prices/availability change quickly—treat results as point-in-time and encourage users to confirm via the booking link.

## References / provenance

* Skiplagged MCP docs + privacy notes: [https://skiplagged.github.io/mcp/](https://skiplagged.github.io/mcp/)
* MCPorter CLI (call syntax + ad-hoc URLs): [https://raw.githubusercontent.com/steipete/mcporter/main/README.md](https://raw.githubusercontent.com/steipete/mcporter/main/README.md)