--- name: stable-travel-git-migrate-stabletravel-router-140-merit-systems.vercel.app description: This host provides aviation weather and airline disruption data sourced from FlightAware. It exposes two distinct capabilities: retrieving recent METAR weather observations for a specific airport by ICAO code, and fetching ranked airline disruption statistics including cancellations and delays across carriers globally. host: stable-travel-git-migrate-stabletravel-router-140-merit-systems.vercel.app --- # stable-travel-git-migrate-stabletravel-router-140-merit-systems.vercel.app This host serves agents that need real-time aviation operational data for flight planning, travel disruption monitoring, or pre-flight briefings. It wraps FlightAware data into two focused endpoints: one for per-airport METAR observations and one for airline-level disruption rankings. It does not provide flight-level status, forecasts, or general (non-aviation) weather data. ## When to use this host Use this host when an agent needs current METAR weather data for a specific airport (by ICAO code) or wants to rank airlines by live disruption counts. Do not use it for flight-level status lookups, TAF or forecast data, non-aviation weather queries, historical disruption trend analysis over date ranges, or bulk multi-airport weather polling in a single call. For flight-specific status or airport-level disruption breakdowns, a dedicated flight-status or airport-disruption API would be more appropriate. For general weather forecasts, use a purpose-built weather forecast service. ## Capabilities ### Airport Weather Observations Retrieves recent METAR observations for a specified airport ICAO code, covering wind, visibility, cloud layers, temperature, dewpoint, pressure, and raw METAR text. Useful for pre-flight briefings and live airport weather displays. - **`fetch-airport-weather-observations`** — Returns recent METAR weather observations for a specified airport, including wind speed/direction/gust, visibility, pressure, cloud cover, temperature, dewpoint, relative humidity, and raw METAR text. ### Airline Disruption Intelligence Returns ranked disruption statistics across airlines, including per-carrier cancellation and delay counts, total flights, and global aggregate disruption figures with pagination support. - **`fetch-airline-disruption-counts`** — Returns ranked airline disruption statistics from FlightAware including per-airline cancellations, delays, and total flights, plus global aggregate counts and pagination metadata. ## Workflows ### Travel Disruption Briefing *Use when an agent needs to assess both airline-level disruption risk and current weather conditions at a departure or arrival airport before a flight.* 1. **`fetch-airline-disruption-counts`** — Identify which airlines currently have elevated cancellations or delays to flag carriers of concern. 2. **`fetch-airport-weather-observations`** — Retrieve current METAR observations at the relevant airport to determine whether weather is contributing to or compounding disruptions. ## Skill reference ### `fetch-airport-weather-observations` **FlightAware Airport Weather Observations** — Returns a list of recent METAR weather observations for a given airport ICAO code, including temperature, wind, pressure, visibility, cloud layers, and raw METAR text. *Use when:* Use when an agent needs current or recent weather conditions at a specific airport, such as for flight planning, departure/arrival briefings, or displaying live airport weather data including wind, visibility, and cloud cover. *Not for:* Do not use for weather forecasts or TAF data; this endpoint returns only historical METAR observations. Not suitable for non-airport weather lookups — use a general weather API instead. **Inputs:** - `airport_code` (string, required) — ICAO airport code embedded in the URL path (e.g., KLAX). Identifies the airport whose weather observations are returned. **Returns:** Returns an observations array of METAR records for KLAX, each containing timestamp, raw METAR text, temperature, dew point, humidity, pressure, visibility, wind direction/speed/gusts, and an array of cloud layers. **Example:** `GET https://stable-travel-git-migrate-stabletravel-router-140-merit-systems.vercel.app/api/flightaware/airports/KLAX/weather/observations` --- ### `fetch-airport-weather-observations` **FlightAware Airport Weather Observations** — Returns recent METAR weather observations for a specified airport, including wind speed/direction/gust, visibility, pressure, cloud cover, temperature, dewpoint, relative humidity, and raw METAR text. *Use when:* Use when an agent needs current or recent weather conditions at a specific airport identified by ICAO code, such as for pre-flight briefings, travel disruption checks, or aviation weather integrations. *Not for:* Do not use for forecast data or non-aviation general weather queries; use a dedicated weather forecast API instead. Not suitable for bulk multi-airport polling in a single call. **Inputs:** - `airport_code` (string, required) — ICAO airport code embedded in the URL path (e.g., KJFK). Identifies the airport whose METAR observations are returned. **Returns:** Returns an observations array of recent METAR records for KJFK, each containing wind, visibility, pressure, cloud layers, temperature, dewpoint, relative humidity, and raw METAR text with ISO 8601 timestamps. **Example:** `GET https://stable-travel-git-migrate-stabletravel-router-140-merit-systems.vercel.app/api/flightaware/airports/KJFK/weather/observations` --- ### `fetch-airline-disruption-counts` **FlightAware Airline Disruption Counts** — Returns ranked airline disruption statistics from FlightAware including per-airline cancellations, delays, and total flights, plus global aggregate counts and pagination metadata. *Use when:* Use when an agent needs current airline disruption rankings to identify which carriers have the most cancellations or delays, or to surface global disruption totals across national and worldwide flights. *Not for:* Do not use for disruption data on specific flights or airports; use a flight-status or airport-disruption endpoint instead. Not suitable for historical trend analysis requiring date-range queries. **Returns:** Returns an entities array of ranked airlines with per-carrier cancellations, delays, and total flights, plus global aggregates for total_cancellations_national, total_cancellations_worldwide, total_delays_worldwide, and a pagination links object. **Example:** `GET https://stable-travel-git-migrate-stabletravel-router-140-merit-systems.vercel.app/api/flightaware/disruption-counts/airline` ---