--- name: stabletravel.dev description: stabletravel.dev provides flight data via FlightAware, covering live departures, airport delay conditions, flight status lookups, and scheduled route listings for specific airport pairs. It exposes both parameterized endpoints (by airport code or flight number) and hardcoded endpoints for fixed routes and airports. All data is near-real-time; no historical analytics or fare/pricing is available. host: stabletravel.dev --- # stabletravel.dev stabletravel.dev is a flight-information host built on top of FlightAware data, targeting agents that need operational flight intelligence: departure boards, delay checks, flight status by number, and route listings for a small set of fixed city pairs (CGK→KNO, JFK→LAX) plus a hardcoded AA95 status feed and Madrid airport reference data. It is not a booking or pricing platform, and its fixed-endpoint skills limit general-purpose route coverage. ## When to use this host Use stabletravel.dev when an agent needs live FlightAware departure boards, current airport delay conditions, or flight status and schedule data by flight number. The fixed-route skills (CGK→KNO, JFK→LAX) and the hardcoded AA95 and MAD endpoints are only useful if those exact routes or airports are relevant. Do not use this host for: arrival flight data (no arrivals endpoint exists), historical flight analytics, fare or pricing lookups, real-time aircraft position tracking, or arbitrary route searches beyond the two hardcoded pairs. For broader route coverage or arrivals data, a general-purpose flight search API (e.g., direct FlightAware or OAG integrations) would be more appropriate. For travel booking or pricing, use a dedicated GDS or fare aggregator host. ## Capabilities ### Airport Reference & Catalog Provides static and enumerable airport data: full details for a specific airport and a paginated catalog of all FlightAware airports, useful for building selection lists or resolving airport identifiers. - **`fetch-airport-info`** — Returns FlightAware airport details for a given airport code, including ICAO/IATA identifiers, name, location coordinates, elevation, timezone, and related links. - **`fetch-flightaware-airports`** — Returns a paginated list of airports from FlightAware, each with an airport code and info URL, supporting cursor-based pagination. ### Airport Operational Status Returns live operational conditions at airports, including current departure activity for a given airport and system-wide delay alerts with severity and cause. - **`fetch-airport-departures`** — Returns live departure flight records for a specified airport using FlightAware data, including flight identifiers, origin/destination, runway, timing, status, aircraft type, and route. - **`fetch-airport-delays`** — Returns current flight delay data for airports worldwide, including delay duration in seconds, category, severity color, and human-readable reasons sourced from FlightAware. ### Flight Lookup & Counting Supports looking up details for a specific flight number, counting flights matching a search expression, and retrieving status for the hardcoded AA95 flight. - **`fetch-flightaware-flight-details`** — Returns FlightAware flight records for a given flight number, including origin, destination, schedule times, status, aircraft type, and codeshares. - **`fetch-flightaware-flight-count`** — Returns the total number of flights matching a FlightAware search query string. - **`fetch-flight-status`** — Returns FlightAware flight status data for American Airlines flight AA95, including scheduled/estimated times, aircraft, origin, destination, codeshares, and route for recent flight instances. ### Fixed-Route Flight Listings Returns scheduled and active flight listings for two hardcoded airport pairs (CGK→KNO and JFK→LAX), including segment-level timing, aircraft type, and gate info. - **`fetch-cgk-to-kno-flights`** — Returns scheduled and active flight data for airline routes from Jakarta Soekarno-Hatta (CGK) to Kuala Namu International (KNO), including segment identifiers, timing, aircraft type, and status. - **`fetch-jfk-to-lax-flights`** — Returns FlightAware flight data for scheduled and active flights from John F. Kennedy International (KJFK) to Los Angeles International (KLAX), including per-segment identifiers, times, aircraft type, route, and gate info. ## Workflows ### Airport Departure Board with Delay Context *Use when an agent needs to present a live departures board for an airport alongside any active delay warnings affecting that airport.* 1. **`fetch-airport-delays`** — Check whether the target airport is currently experiencing delays, capturing severity and cause for display alongside flight data. 2. **`fetch-airport-departures`** — Fetch the live departure list for the same airport, annotating results with the delay context retrieved in the prior step. ### Flight Number Deep Dive *Use when an agent needs to understand how many flights match a search expression and then retrieve full details on a specific flight number from those results.* 1. **`fetch-flightaware-flight-count`** — Run a FlightAware search query to confirm how many flights match the criteria (e.g., by airline or route) before committing to a detail lookup. 2. **`fetch-flightaware-flight-details`** — Retrieve full schedule, status, aircraft, and codeshare details for the specific flight number of interest. ### Airport Discovery to Departure Check *Use when an agent needs to enumerate available airports and then pull live departure data for a selected one.* 1. **`fetch-flightaware-airports`** — Paginate through the FlightAware airport catalog to identify or confirm the target airport code. 2. **`fetch-airport-departures`** — Use the resolved airport code to fetch current departure records for that airport. ## Skill reference ### `fetch-airport-departures` **FlightAware Departures** — Returns live departure flight records for a specified airport using FlightAware data, including flight identifiers, origin/destination, runway, timing, status, aircraft type, and route. *Use when:* Use when an agent needs current or recent departure flight data for a specific airport, such as checking flight status, departure delays, runway usage, or building a live departures board. *Not for:* Do not use for arrival flight data; use a separate arrivals endpoint instead. Not suitable for historical flight analytics or fare/pricing lookups. **Inputs:** - `airport` (string, required) — ICAO airport code embedded in the URL path (e.g. KMIA). Determines which airport's departures are returned. **Returns:** Returns a departures array where each element contains full FlightAware flight data including ident, origin/destination airport objects, scheduled and actual off/on times, delay values, aircraft type, route string, runway used, and flight status. **Example:** `GET https://stabletravel.dev/api/flightaware/airports/KMIA/flights/departures` --- ### `fetch-cgk-to-kno-flights` **CGK to KNO Flights** — Returns scheduled and active flight data for airline routes from Jakarta Soekarno-Hatta (CGK) to Kuala Namu International (KNO), including segment identifiers, timing, aircraft type, and status. *Use when:* Use when an agent needs to list upcoming or current flights operating between Jakarta CGK and Medan KNO, including departure/arrival times, flight numbers, operators, aircraft types, delays, and route distance. *Not for:* Do not use for flights on other route pairs; the origin and destination are fixed to CGK and KNO. Not suitable for real-time position tracking or historical flight records. **Returns:** Returns a flights array where each entry contains a segments array with full flight details including IATA/ICAO identifiers, operator, aircraft type, scheduled and estimated gate times in UTC, delay values, route distance in nautical miles, and origin/destination airport objects. **Example:** `GET https://stabletravel.dev/api/flightaware/airports/cgk/flights/to/kno` --- ### `fetch-airport-delays` **Airport Delay Feed** — Returns current flight delay data for airports worldwide, including delay duration in seconds, category, severity color, and human-readable reasons sourced from FlightAware. *Use when:* Use when an agent needs to check whether specific airports are currently experiencing flight delays, including the cause category (weather, other), severity, and average delay duration in seconds. *Not for:* Do not use for historical delay statistics or future delay forecasts; this endpoint returns only current real-time delay conditions. **Returns:** Returns a delays array with per-airport objects containing ICAO code, category, color severity, delay_secs, and a reasons array with human-readable delay descriptions, plus num_pages and links fields. **Example:** `GET https://stabletravel.dev/api/flightaware/airports/delays` --- ### `fetch-flightaware-flight-count` **FlightAware Flight Count** — Returns the total number of flights matching a FlightAware search query string. *Use when:* Use when an agent needs to know how many flights match a given FlightAware search expression, such as counting flights by route, airline, aircraft type, or other search criteria. *Not for:* Do not use to retrieve individual flight details or route information; use a flight search listing endpoint instead. **Inputs:** - `query` (string, required) — FlightAware search query string used to filter and count matching flights. **Returns:** Returns a JSON object with a single field 'count' containing the integer number of flights matching the query (e.g., {"count":11196}). **Example:** `GET https://stabletravel.dev/api/flightaware/flights/search/count?query=airline%20UNITED%20origin%20KSFO` --- ### `fetch-flightaware-flight-details` **FlightAware Flight Lookup** — Returns FlightAware flight records for a given flight number, including origin, destination, schedule times, status, aircraft type, and codeshares. *Use when:* Use when an agent needs live or scheduled flight details for a specific flight number, including departure/arrival airports, scheduled and estimated times, flight status, aircraft type, seat counts, and codeshare partners. *Not for:* Do not use for searching flights by route or date range; this endpoint requires a specific flight number. Not suitable for real-time position tracking or historical analytics across multiple flights. **Inputs:** - `flight_number` (string, required) — IATA or ICAO flight number embedded in the URL path (e.g. UX1503 or AEA1503). Determines which flight's records are returned. **Returns:** Returns a flights array where each element contains full schedule times, status, origin/destination airport objects, aircraft type, seat counts, codeshares, and delay values for each operated leg matching the flight number. **Example:** `GET https://stabletravel.dev/api/flightaware/flights/UX1503` --- ### `fetch-flight-status` **AA95 Flight Status** — Returns FlightAware flight status data for American Airlines flight AA95, including scheduled/estimated times, aircraft, origin, destination, codeshares, and route for recent flight instances. *Use when:* Use when an agent needs current or recent flight status, timing, aircraft registration, gate/terminal info, or route details for American Airlines flight AA95 (MAD→JFK). *Not for:* Do not use for arbitrary flight numbers; this endpoint is hardcoded to AA95. For other flights, use a parameterized flight status API. **Returns:** Returns a flights array with multiple recent AA95 (MAD→JFK) flight instances, each containing status, scheduled/estimated/actual gate times, aircraft type, registration, codeshares, route, terminal, and gate details. **Example:** `GET https://stabletravel.dev/api/flightaware/flights/AA95` --- ### `fetch-airport-info` **Madrid Airport Info** — Returns FlightAware airport details for a given airport code, including ICAO/IATA identifiers, name, location coordinates, elevation, timezone, and related links. *Use when:* Use when an agent needs static airport reference data for MAD (Madrid-Barajas), such as ICAO/IATA codes, geographic coordinates, elevation, timezone, or a Wikipedia link. *Not for:* Do not use for live flight status, schedules, or delays; use a flight-tracking endpoint instead. Not suitable for airports other than MAD as this endpoint is hardcoded to that airport. **Returns:** Returns a JSON object with ICAO/IATA codes, full airport name, city, country, coordinates, elevation, timezone, Wikipedia URL, and a relative flights URL for Madrid-Barajas Airport. **Example:** `GET https://stabletravel.dev/api/flightaware/airports/MAD` --- ### `fetch-flightaware-airports` **Airport Lookup** — Returns a paginated list of airports from FlightAware, each with an airport code and info URL, supporting cursor-based pagination. *Use when:* Use when an agent needs to enumerate airports available in FlightAware for travel planning, flight search, or building airport selection lists, and requires paginated traversal of the full airport catalog. *Not for:* Do not use for detailed per-airport data such as name, location, or elevation; this endpoint returns only airport codes and info URLs in the real response. Do not use for flight status or scheduling lookups. **Inputs:** - `max_pages` (number) — Maximum number of pages to return in a single request. - `cursor` (string) — Pagination cursor returned from a previous response to fetch the next page of results. **Returns:** Returns an airports array of objects with code and airport_info_url, a links.next cursor URL for pagination, and num_pages count. **Example:** `GET https://stabletravel.dev/api/flightaware/airports?max_pages=1` --- ### `fetch-jfk-to-lax-flights` **JFK to LAX Flights** — Returns FlightAware flight data for scheduled and active flights from John F. Kennedy International (KJFK) to Los Angeles International (KLAX), including per-segment identifiers, times, aircraft type, route, and gate info. *Use when:* Use when an agent needs current or upcoming flight listings between JFK and LAX, including scheduled departure/arrival times, airline identifiers, aircraft type, flight status, codeshares, and gate/terminal assignments. *Not for:* Do not use for flights between any other airport pair; the origin and destination are hardcoded to KJFK and KLAX. Not suitable for real-time position tracking or historical flight records. **Returns:** Returns a flights array where each entry contains a segments array with full FlightAware flight details including identifiers, scheduled/estimated times, aircraft type, route, codeshares, gate/terminal info, and status for JFK-to-LAX flights. **Example:** `GET https://stabletravel.dev/api/flightaware/airports/KJFK/flights/to/KLAX` ---