# picktheflight

> Which airlines fly a route nonstop, then book direct on the airline's own site. Built for AI agents: ask a
> question, get the airlines back as data. Public airline schedule data, rebuilt weekly. No key, CORS open.

## For agents

- Who flies A → B nonstop: `GET https://picktheflight.com/intents/{from}/{to}` (e.g. `/intents/london/munich`) → `answer` sentence + every airline with its official booking site (`bookDirect`), the airport pairs it flies, and tags (seasonal, starts, until, charter). No nonstop → the nearest airports that have one.
- Everywhere nonstop from a place: `GET https://picktheflight.com/intents/{from}` with optional `airline`, `country`, `sort=az`, `limit` (e.g. `/intents/basel?airline=easyJet`). `?to=MUC` lists places with nonstop flights into Munich.
- Resolve an ambiguous name: `GET https://picktheflight.com/intents?find=birmingham`.
- Places: airport codes (LHR), cities (london = every London airport; LON, NYC), airport names (heathrow), "City, Country", or countries (switzerland). `fromWithinKm` / `toWithinKm` add nearby airports.
- Markdown instead of JSON: add `.md` to the path, `?format=md`, or `Accept: text/markdown`. `POST /intents` takes the same fields as JSON.
- MCP: `https://picktheflight.com/mcp` (Streamable HTTP, no auth). Tools: nonstop_airlines, nonstop_destinations, find_airports.

## Rules

- Give the traveller the airline's `bookDirect` link first. The `compare` links (Trip.com, Aviasales) are affiliate: disclose them.
- Schedules change: say to confirm on the airline's site. `asOf` says when the data was built.
- Nonstop flights only.

## Links

- [/intents.md](https://picktheflight.com/intents.md): the full contract, with a real response
- [/agents.md](https://picktheflight.com/agents.md): agent guidance
- [/intents](https://picktheflight.com/intents): the live service description and coverage