faa-traffic-delays-mcp-server

Get the current FAA traffic management status for one or more US airports: a headline status, every active event (ground stop, Ground Delay Program with its delay profile, arrival or departure delay, closure, deicing) with reason and times, and the runway configuration and airport arrival rate. Every row carries the airport's ARTCC, and its coordinates come from the feed when the airport is listed (absent when the feed omits them) and from the NASR directory otherwise; both place a departure airport against a program's includedFacilities and departureScopeNm. Airports are FAA 3-character identifiers (SEA, ORD, JFK) or their ICAO codes (KSEA, PHNL); a code that names no US airport is rejected. The FAA feed lists only airports with an active event, so a known airport absent from it returns status no_active_events, and runway configuration is available only for listed airports.

{
  "type": "object",
  "properties": {
    "airports": {
      "description": "1–25 US airports, each a 3-character FAA location identifier (SEA, ORD, 0S9) or its ICAO code (KSEA, PHNL, TJSJ), case-insensitive; a comma-separated string is also accepted. City and airport names are not accepted.",
      "minItems": 1,
      "maxItems": 25,
      "type": "array",
      "items": {
        "description": "US airport: 3-character FAA identifier (SEA) or its ICAO code (KSEA); trimmed and uppercased before validation.",
        "type": "string",
        "pattern": "^[A-Z0-9]{3,4}$"
      }
    }
  },
  "required": [
    "airports"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "fetchedAt": {
      "type": "string",
      "description": "When this server fetched the snapshot from the FAA (UTC ISO); with the 60 s cache it can trail the call by up to a minute."
    },
    "airports": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "airportId": {
            "type": "string",
            "description": "Normalized 3-character FAA identifier."
          },
          "requestedAs": {
            "description": "The code as submitted (an ICAO code), present only when it differs from airportId.",
            "type": "string"
          },
          "airportName": {
            "type": "string",
            "description": "Airport name: the feed name when listed, else the FAA NASR directory name. It shows which airport the requested code resolved to."
          },
          "city": {
            "description": "City from the NASR directory.",
            "type": "string"
          },
          "state": {
            "description": "State or territory code from the NASR directory.",
            "type": "string"
          },
          "artcc": {
            "description": "Air Route Traffic Control Center responsible for the airport, from the NASR directory (ZSE), in the form a program's includedFacilities lists ARTCCs. A few airports belong to a foreign or oceanic facility (ZVR, NZZO); faa_delays_list_reference topic artccs decodes every code.",
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "closed",
              "ground_stop",
              "ground_delay_program",
              "delays",
              "restrictions_only",
              "no_active_events"
            ],
            "description": "Headline status, first match wins: closed (airport closure) → ground_stop → ground_delay_program → delays (arrival or departure delay) → restrictions_only (listed with only a closure NOTAM, deicing, or runway configuration) → no_active_events (absent from the feed: no FAA program, which does not guarantee on-time flights)."
          },
          "listedInFeed": {
            "type": "boolean",
            "description": "Whether the FAA feed lists this airport; it lists only airports with an active event."
          },
          "latitude": {
            "description": "Latitude in decimal degrees: the feed's value for a listed airport, else the NASR directory's (4 decimal places).",
            "type": "number"
          },
          "longitude": {
            "description": "Longitude in decimal degrees: the feed's value for a listed airport, else the NASR directory's (4 decimal places).",
            "type": "number"
          },
          "isPacingAirport": {
            "description": "Whether the FAA tracks this as a pacing airport; omitted when that list could not be read.",
            "type": "boolean"
          },
          "timezone": {
            "description": "IANA-style time zone the FAA assigns to a pacing airport (US/Pacific).",
            "type": "string"
          },
          "runwayConfiguration": {
            "description": "Runway configuration and arrival rate; reported only for airports the feed lists.",
            "type": "object",
            "properties": {
              "arrivalRunways": {
                "description": "Arrival runways in use (FAA-authored text).",
                "type": "string"
              },
              "departureRunways": {
                "description": "Departure runways in use (FAA-authored text).",
                "type": "string"
              },
              "arrivalRatePerHour": {
                "description": "Airport arrival rate (AAR): arrivals the airport accepts per hour.",
                "type": "number"
              },
              "reportedAt": {
                "description": "When the FAA recorded this configuration (UTC ISO).",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "groundStop": {
            "description": "Active ground stop: flights to this airport are held at their departure airports.",
            "type": "object",
            "properties": {
              "reason": {
                "description": "Stated cause (FAA-authored text).",
                "type": "string"
              },
              "startTime": {
                "description": "Start (UTC ISO).",
                "type": "string"
              },
              "endTime": {
                "description": "Scheduled end (UTC ISO).",
                "type": "string"
              },
              "probabilityOfExtension": {
                "description": "Likelihood the stop is extended: low <30 %, medium 30–60 %, high >60 % per the FAA.",
                "type": "string",
                "enum": [
                  "low",
                  "medium",
                  "high"
                ]
              },
              "includedFacilities": {
                "description": "Departure facilities in scope: ARTCC codes for a tier-scoped stop, in the form of each row's artcc, and 4-character ICAO codes for named airports.",
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "ARTCC code, as in artcc, or 4-character ICAO airport code."
                }
              },
              "updatedAt": {
                "description": "Last FAA update (UTC ISO).",
                "type": "string"
              },
              "advisory": {
                "type": "object",
                "properties": {
                  "number": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "ATCSCC advisory number; numbers restart at 1 each UTC day."
                  },
                  "date": {
                    "type": "string",
                    "description": "Advisory UTC date, YYYY-MM-DD."
                  },
                  "url": {
                    "type": "string",
                    "description": "Server-built advisory URL, the page faa_delays_get_advisory reads for this number and date."
                  }
                },
                "required": [
                  "number",
                  "date",
                  "url"
                ],
                "additionalProperties": false,
                "description": "Reference to the ATCSCC advisory behind this item, absent when the FAA feed links none. For the full text, call faa_delays_get_advisory with number as advisory_number and date as date."
              },
              "includedFlights": {
                "description": "Flights included, such as ALL CONTIGUOUS US DEP (FAA-authored text).",
                "type": "string"
              },
              "controllingCenter": {
                "description": "Controlling ARTCC code (ZSE).",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "groundDelayProgram": {
            "description": "Active Ground Delay Program: flights to this airport receive assigned departure delays.",
            "type": "object",
            "properties": {
              "reason": {
                "description": "Stated cause (FAA-authored text).",
                "type": "string"
              },
              "averageDelayMinutes": {
                "description": "Average assigned delay in minutes.",
                "type": "number"
              },
              "maximumDelayMinutes": {
                "description": "Maximum assigned delay in minutes.",
                "type": "number"
              },
              "startTime": {
                "description": "Start of the current revision's arrival window (UTC ISO); a revised program keeps its earlier start in programStartTime.",
                "type": "string"
              },
              "programStartTime": {
                "description": "When the program began, before any revision (UTC ISO).",
                "type": "string"
              },
              "endTime": {
                "description": "Program end (UTC ISO).",
                "type": "string"
              },
              "updatedAt": {
                "description": "Last FAA update (UTC ISO).",
                "type": "string"
              },
              "controllingCenter": {
                "description": "Controlling ARTCC code (ZSE).",
                "type": "string"
              },
              "departureScopeNm": {
                "description": "Departure scope: departures within this many nautical miles are included.",
                "type": "number"
              },
              "includedFacilities": {
                "description": "Departure facilities in scope: ARTCC codes, in the form of each row's artcc, and 4-character ICAO codes for named airports, such as Canadian airports.",
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "ARTCC code, as in artcc, or 4-character ICAO airport code."
                }
              },
              "includedFlights": {
                "description": "Flights included, such as ALL CONTIGUOUS US DEP (FAA-authored text).",
                "type": "string"
              },
              "delayProfile": {
                "type": "object",
                "properties": {
                  "startTime": {
                    "type": "string",
                    "description": "UTC ISO start of the first 15-minute interval. The FAA aligns intervals to the quarter hour, so it can precede the program start by up to 14 minutes."
                  },
                  "intervalMinutes": {
                    "type": "number",
                    "const": 15,
                    "description": "Length of each interval in minutes; always 15."
                  },
                  "averageDelayMinutes": {
                    "type": "array",
                    "items": {
                      "type": "number",
                      "description": "Average delay in minutes for one 15-minute arrival interval."
                    },
                    "description": "Average assigned delay per consecutive 15-minute arrival interval, in order."
                  }
                },
                "required": [
                  "startTime",
                  "intervalMinutes",
                  "averageDelayMinutes"
                ],
                "additionalProperties": false,
                "description": "Delay trend: average assigned delay for each 15-minute arrival interval of the program."
              },
              "advisory": {
                "type": "object",
                "properties": {
                  "number": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "ATCSCC advisory number; numbers restart at 1 each UTC day."
                  },
                  "date": {
                    "type": "string",
                    "description": "Advisory UTC date, YYYY-MM-DD."
                  },
                  "url": {
                    "type": "string",
                    "description": "Server-built advisory URL, the page faa_delays_get_advisory reads for this number and date."
                  }
                },
                "required": [
                  "number",
                  "date",
                  "url"
                ],
                "additionalProperties": false,
                "description": "Reference to the ATCSCC advisory behind this item, absent when the FAA feed links none. For the full text, call faa_delays_get_advisory with number as advisory_number and date as date."
              }
            },
            "additionalProperties": false
          },
          "arrivalDelay": {
            "description": "Active arrival delay (airborne holding).",
            "type": "object",
            "properties": {
              "reason": {
                "description": "Stated cause (FAA-authored text), e.g. \"RWY:Construction\".",
                "type": "string"
              },
              "minMinutes": {
                "description": "Lower bound of the delay band in minutes (the FAA reports delays in 15-minute bands).",
                "type": "number"
              },
              "maxMinutes": {
                "description": "Upper bound of the delay band in minutes.",
                "type": "number"
              },
              "trend": {
                "description": "Direction the delay is moving.",
                "type": "string",
                "enum": [
                  "increasing",
                  "decreasing"
                ]
              },
              "updatedAt": {
                "description": "When the FAA last updated this delay (UTC ISO); an entry can outlive the delay.",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "departureDelay": {
            "description": "Active departure delay (taxi or gate holds).",
            "type": "object",
            "properties": {
              "reason": {
                "description": "Stated cause (FAA-authored text), e.g. \"RWY:Construction\".",
                "type": "string"
              },
              "minMinutes": {
                "description": "Lower bound of the delay band in minutes (the FAA reports delays in 15-minute bands).",
                "type": "number"
              },
              "maxMinutes": {
                "description": "Upper bound of the delay band in minutes.",
                "type": "number"
              },
              "trend": {
                "description": "Direction the delay is moving.",
                "type": "string",
                "enum": [
                  "increasing",
                  "decreasing"
                ]
              },
              "updatedAt": {
                "description": "When the FAA last updated this delay (UTC ISO); an entry can outlive the delay.",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "closure": {
            "description": "Airport closed to all operations; text lists exceptions.",
            "type": "object",
            "properties": {
              "text": {
                "description": "Closure detail and exceptions (FAA-authored text).",
                "type": "string"
              },
              "startTime": {
                "description": "Start (UTC ISO).",
                "type": "string"
              },
              "endTime": {
                "description": "End (UTC ISO).",
                "type": "string"
              },
              "updatedAt": {
                "description": "Last FAA update (UTC ISO).",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "closureNotam": {
            "description": "NOTAM-worded closure or restriction, often narrow (for example closed to transient GA).",
            "type": "object",
            "properties": {
              "notamText": {
                "description": "Full NOTAM text (FAA-authored).",
                "type": "string"
              },
              "text": {
                "description": "The restriction wording (FAA-authored).",
                "type": "string"
              },
              "notamNumber": {
                "description": "NOTAM number.",
                "type": "number"
              },
              "issuedAt": {
                "description": "NOTAM issue time (UTC ISO).",
                "type": "string"
              },
              "startTime": {
                "description": "Start (UTC ISO).",
                "type": "string"
              },
              "endTime": {
                "description": "End (UTC ISO).",
                "type": "string"
              },
              "updatedAt": {
                "description": "Last FAA update (UTC ISO).",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "deicing": {
            "description": "A formal deicing program is in effect.",
            "type": "object",
            "properties": {
              "startedAt": {
                "description": "When deicing began (UTC ISO).",
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "airportId",
          "airportName",
          "status",
          "listedInFeed"
        ],
        "additionalProperties": false,
        "description": "Status of one requested airport."
      },
      "description": "One row per requested airport, in request order, duplicates dropped."
    },
    "notice": {
      "description": "Guidance on quiet results, stale delay entries, or partial data.",
      "type": "string"
    },
    "error": {
      "description": "Present when the call failed. Absent on success.",
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "JSON-RPC error code for this failure."
        },
        "message": {
          "type": "string",
          "description": "Human-readable description of what went wrong."
        },
        "data": {
          "type": "object",
          "properties": {
            "reason": {
              "type": "string",
              "description": "Machine-readable failure mode. Declared by this tool: `unknown_airport`: A requested code is not a 3-character identifier in the FAA NASR airport directory, or a 4-character code that is not the ICAO code of one. `feed_unavailable`: NAS Status unreachable, 5xx, an attempt timeout, or an HTML maintenance page, after retries. `upstream_rate_limited`: The FAA returned 429 after retries, or this server's queue to the FAA would wait past 10 s while backing off from an FAA 429. `retry_deadline_exceeded`: The 20 s retry budget ran out. `pacer_shed`: This server's own queue to the FAA would wait past 10 s with no FAA 429 backoff in effect. `feed_contract_changed`: The feed path returned 404/410, or a body whose shape this server no longer recognizes. Other values are possible when a failure originates below the handler.",
              "examples": [
                "unknown_airport",
                "feed_unavailable",
                "upstream_rate_limited",
                "retry_deadline_exceeded",
                "pacer_shed",
                "feed_contract_changed"
              ]
            },
            "recovery": {
              "description": "Actionable next step for the caller.",
              "type": "object",
              "properties": {
                "hint": {
                  "type": "string"
                }
              },
              "required": [
                "hint"
              ],
              "additionalProperties": {}
            },
            "retryable": {
              "description": "Whether retrying may succeed.",
              "type": "boolean"
            }
          },
          "additionalProperties": {}
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": {}
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "anyOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "required": [
        "fetchedAt",
        "airports"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}

List every active FAA traffic management event across the National Airspace System in one call: ground stops, Ground Delay Programs, Airspace Flow Programs, arrival and departure delays, airport closures, closure NOTAMs, and deicing. Rows are sorted by severity (closures, ground stops, then GDPs and then AFPs each by average delay, arrival/departure delays by band maximum, closure NOTAMs, deicing) and carry the reason, delay figures, times, and an advisory reference for faa_delays_get_advisory. Use faa_delays_get_airport_status for the full detail of one airport, including its GDP delay profile and runway configuration.

{
  "type": "object",
  "properties": {
    "event_types": {
      "description": "Only these event types: ground_stop, ground_delay_program, airspace_flow_program, arrival_delay, departure_delay, airport_closure, closure_notam, deicing. Also accepts gs, gdp, afp, spelled-out names such as \"departure delay\", and a comma-separated string; case-insensitive. Omit for every type. countsByType always covers the whole feed.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "airport_closure",
          "ground_stop",
          "ground_delay_program",
          "airspace_flow_program",
          "arrival_delay",
          "departure_delay",
          "closure_notam",
          "deicing"
        ],
        "description": "FAA traffic management event type."
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "fetchedAt": {
      "type": "string",
      "description": "When this server fetched the airport events from the FAA (UTC ISO); with the 60 s cache it can trail the call by up to a minute."
    },
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "eventType": {
            "type": "string",
            "enum": [
              "airport_closure",
              "ground_stop",
              "ground_delay_program",
              "airspace_flow_program",
              "arrival_delay",
              "departure_delay",
              "closure_notam",
              "deicing"
            ],
            "description": "FAA traffic management event type."
          },
          "location": {
            "type": "string",
            "description": "FAA airport identifier, or the AFP name for airspace_flow_program (FAA-authored)."
          },
          "locationName": {
            "description": "Airport name (FAA-authored).",
            "type": "string"
          },
          "reason": {
            "description": "Stated cause (FAA-authored text).",
            "type": "string"
          },
          "averageDelayMinutes": {
            "description": "Average assigned delay in minutes (ground_delay_program, airspace_flow_program).",
            "type": "number"
          },
          "maximumDelayMinutes": {
            "description": "Maximum assigned delay in minutes (ground_delay_program).",
            "type": "number"
          },
          "delayRangeMinutes": {
            "description": "Delay band for arrival_delay and departure_delay (the FAA reports 15-minute bands); absent when the FAA reported neither bound.",
            "type": "object",
            "properties": {
              "min": {
                "description": "Lower bound in minutes; absent when the FAA reported only the upper bound.",
                "type": "number"
              },
              "max": {
                "description": "Upper bound in minutes; absent when the FAA reported only the lower bound.",
                "type": "number"
              }
            },
            "additionalProperties": false
          },
          "trend": {
            "description": "Direction an arrival or departure delay is moving.",
            "type": "string",
            "enum": [
              "increasing",
              "decreasing"
            ]
          },
          "probabilityOfExtension": {
            "description": "Ground stop extension likelihood: low <30 %, medium 30–60 %, high >60 % per the FAA.",
            "type": "string",
            "enum": [
              "low",
              "medium",
              "high"
            ]
          },
          "startTime": {
            "description": "Start (UTC ISO). For ground_delay_program, the start of the current revision's arrival window; for deicing, when it began.",
            "type": "string"
          },
          "programStartTime": {
            "description": "When a ground_delay_program began, before any revision (UTC ISO); absent on other types.",
            "type": "string"
          },
          "endTime": {
            "description": "End (UTC ISO).",
            "type": "string"
          },
          "updatedAt": {
            "description": "Last FAA update (UTC ISO).",
            "type": "string"
          },
          "closureText": {
            "description": "airport_closure exceptions, or the closure_notam NOTAM text (FAA-authored).",
            "type": "string"
          },
          "advisory": {
            "type": "object",
            "properties": {
              "number": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "ATCSCC advisory number; numbers restart at 1 each UTC day."
              },
              "date": {
                "type": "string",
                "description": "Advisory UTC date, YYYY-MM-DD."
              },
              "url": {
                "type": "string",
                "description": "Server-built advisory URL, the page faa_delays_get_advisory reads for this number and date."
              }
            },
            "required": [
              "number",
              "date",
              "url"
            ],
            "additionalProperties": false,
            "description": "Reference to the ATCSCC advisory behind this item, absent when the FAA feed links none. For the full text, call faa_delays_get_advisory with number as advisory_number and date as date."
          },
          "afp": {
            "description": "Airspace Flow Program detail; present only on airspace_flow_program rows.",
            "type": "object",
            "properties": {
              "constrainedArea": {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "enum": [
                      "airport",
                      "artcc",
                      "sector",
                      "tracon",
                      "special_use_airspace",
                      "fix",
                      "fca"
                    ],
                    "description": "Kind of Flow Constrained Area; fca when the FAA names no specific element."
                  },
                  "name": {
                    "description": "Name of the constrained element (FAA-authored).",
                    "type": "string"
                  }
                },
                "required": [
                  "type"
                ],
                "additionalProperties": false,
                "description": "The airspace the program meters."
              },
              "altitudeFloor": {
                "description": "Lower altitude bound as the FAA reports it.",
                "type": "string"
              },
              "altitudeCeiling": {
                "description": "Upper altitude bound as the FAA reports it.",
                "type": "string"
              },
              "departsFrom": {
                "description": "Departure facilities included (FAA-authored).",
                "type": "string"
              },
              "arrivesTo": {
                "description": "Arrival facilities included (FAA-authored).",
                "type": "string"
              },
              "excludedDepartures": {
                "description": "Departure facilities excluded (FAA-authored).",
                "type": "string"
              },
              "excludedArrivals": {
                "description": "Arrival facilities excluded (FAA-authored).",
                "type": "string"
              },
              "headingDirection": {
                "description": "Direction of flights included, e.g. westbound (FAA-authored).",
                "type": "string"
              },
              "filtersMatchAny": {
                "description": "true: departs OR arrives filters apply; false: both must match.",
                "type": "boolean"
              },
              "comments": {
                "description": "Program comments (FAA-authored).",
                "type": "string"
              },
              "delayProfile": {
                "type": "object",
                "properties": {
                  "startTime": {
                    "type": "string",
                    "description": "UTC ISO start of the first 15-minute interval. The FAA aligns intervals to the quarter hour, so it can precede the program start by up to 14 minutes."
                  },
                  "intervalMinutes": {
                    "type": "number",
                    "const": 15,
                    "description": "Length of each interval in minutes; always 15."
                  },
                  "averageDelayMinutes": {
                    "type": "array",
                    "items": {
                      "type": "number",
                      "description": "Average delay in minutes for one 15-minute arrival interval."
                    },
                    "description": "Average assigned delay per consecutive 15-minute arrival interval, in order."
                  }
                },
                "required": [
                  "startTime",
                  "intervalMinutes",
                  "averageDelayMinutes"
                ],
                "additionalProperties": false,
                "description": "Delay trend: average assigned delay for each 15-minute arrival interval of the program."
              }
            },
            "required": [
              "constrainedArea"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "eventType",
          "location"
        ],
        "additionalProperties": false,
        "description": "One active event."
      },
      "description": "Active events matching event_types, sorted by severity."
    },
    "totalActive": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Every active event read, before the event_types filter; excludes AFPs when the en-route feed could not be read."
    },
    "shown": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Events returned after the event_types filter."
    },
    "countsByType": {
      "type": "object",
      "properties": {
        "ground_stop": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "Active ground stops."
        },
        "ground_delay_program": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "Active Ground Delay Programs."
        },
        "airspace_flow_program": {
          "description": "Active Airspace Flow Programs; absent when the en-route feed could not be read.",
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "arrival_delay": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "Active arrival delays."
        },
        "departure_delay": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "Active departure delays."
        },
        "airport_closure": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "Airport closures."
        },
        "closure_notam": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "Closure NOTAMs."
        },
        "deicing": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "Airports deicing."
        }
      },
      "required": [
        "ground_stop",
        "ground_delay_program",
        "arrival_delay",
        "departure_delay",
        "airport_closure",
        "closure_notam",
        "deicing"
      ],
      "additionalProperties": false,
      "description": "Active events per type across the whole feed, counted before the event_types filter so types the filter excluded stay visible. airspace_flow_program is absent when the en-route feed could not be read."
    },
    "appliedEventTypes": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "airport_closure",
          "ground_stop",
          "ground_delay_program",
          "airspace_flow_program",
          "arrival_delay",
          "departure_delay",
          "closure_notam",
          "deicing"
        ],
        "description": "FAA traffic management event type."
      },
      "description": "The event_types filter as the server normalized it, or every type when omitted."
    },
    "enRouteFeed": {
      "type": "string",
      "enum": [
        "ok",
        "unavailable",
        "format_changed"
      ],
      "description": "Whether Airspace Flow Programs were read: ok, unavailable (the en-route feed failed), or format_changed (it returned a format this server does not read)."
    },
    "notice": {
      "description": "Guidance on empty or partial results, stale delay entries, and how to get the missing data.",
      "type": "string"
    },
    "error": {
      "description": "Present when the call failed. Absent on success.",
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "JSON-RPC error code for this failure."
        },
        "message": {
          "type": "string",
          "description": "Human-readable description of what went wrong."
        },
        "data": {
          "type": "object",
          "properties": {
            "reason": {
              "type": "string",
              "description": "Machine-readable failure mode. Declared by this tool: `feed_unavailable`: NAS Status unreachable, 5xx, an attempt timeout, or an HTML maintenance page, after retries. `upstream_rate_limited`: The FAA returned 429 after retries, or this server's queue to the FAA would wait past 10 s while backing off from an FAA 429. `retry_deadline_exceeded`: The 20 s retry budget ran out. `pacer_shed`: This server's own queue to the FAA would wait past 10 s with no FAA 429 backoff in effect. `feed_contract_changed`: The feed path returned 404/410, or a body whose shape this server no longer recognizes. Other values are possible when a failure originates below the handler.",
              "examples": [
                "feed_unavailable",
                "upstream_rate_limited",
                "retry_deadline_exceeded",
                "pacer_shed",
                "feed_contract_changed"
              ]
            },
            "recovery": {
              "description": "Actionable next step for the caller.",
              "type": "object",
              "properties": {
                "hint": {
                  "type": "string"
                }
              },
              "required": [
                "hint"
              ],
              "additionalProperties": {}
            },
            "retryable": {
              "description": "Whether retrying may succeed.",
              "type": "boolean"
            }
          },
          "additionalProperties": {}
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": {}
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "anyOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "required": [
        "fetchedAt",
        "events",
        "totalActive",
        "shown",
        "countsByType",
        "appliedEventTypes",
        "enRouteFeed"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}

Get the FAA Command Center's current operations plan: terminal programs (possible ground stops and delay programs by airport) and en-route initiatives (route closures, severe-weather avoidance plans) expected later in the day, each with its planned UTC time and stated likelihood, plus current ATCSCC announcements. The advisory reference opens the full plan text with faa_delays_get_advisory, including active constraints and runway closures this summary omits.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "fetchedAt": {
      "type": "string",
      "description": "When this server fetched the operations plan from the FAA (UTC ISO); with the 60 s cache it can trail the call by up to a minute."
    },
    "advisory": {
      "type": "object",
      "properties": {
        "number": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "ATCSCC advisory number; numbers restart at 1 each UTC day."
        },
        "date": {
          "type": "string",
          "description": "Advisory UTC date, YYYY-MM-DD."
        },
        "url": {
          "type": "string",
          "description": "Server-built advisory URL, the page faa_delays_get_advisory reads for this number and date."
        }
      },
      "required": [
        "number",
        "date",
        "url"
      ],
      "additionalProperties": false,
      "description": "Reference to the ATCSCC advisory behind this item, absent when the FAA feed links none. For the full text, call faa_delays_get_advisory with number as advisory_number and date as date."
    },
    "terminalPlanned": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string",
            "description": "The planned item as the FAA wrote it, tabs flattened and the leading dash removed (FAA-authored)."
          },
          "timeQualifier": {
            "description": "How the planned time bounds the item, parsed from the start of the text; for between, timeUtc is the start of the window and its end stays in text.",
            "type": "string",
            "enum": [
              "after",
              "until",
              "by",
              "between"
            ]
          },
          "timeUtc": {
            "description": "Planned time as HHMM UTC, with no date. Its day comes from the plan's event window (the EVENT TIME line of the plan advisory, read with faa_delays_get_advisory), which can start on the UTC day after the advisory date.",
            "type": "string"
          },
          "likelihood": {
            "description": "The FAA's stated likelihood: possible (<30 %), probable (30–60 %), or expected (most likely). Absent when the text states none.",
            "type": "string",
            "enum": [
              "possible",
              "probable",
              "expected"
            ]
          }
        },
        "required": [
          "text"
        ],
        "additionalProperties": false,
        "description": "One planned program or initiative."
      },
      "description": "Terminal programs the FAA expects later today: possible ground stops and delay programs by airport, in plan order."
    },
    "enRoutePlanned": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string",
            "description": "The planned item as the FAA wrote it, tabs flattened and the leading dash removed (FAA-authored)."
          },
          "timeQualifier": {
            "description": "How the planned time bounds the item, parsed from the start of the text; for between, timeUtc is the start of the window and its end stays in text.",
            "type": "string",
            "enum": [
              "after",
              "until",
              "by",
              "between"
            ]
          },
          "timeUtc": {
            "description": "Planned time as HHMM UTC, with no date. Its day comes from the plan's event window (the EVENT TIME line of the plan advisory, read with faa_delays_get_advisory), which can start on the UTC day after the advisory date.",
            "type": "string"
          },
          "likelihood": {
            "description": "The FAA's stated likelihood: possible (<30 %), probable (30–60 %), or expected (most likely). Absent when the text states none.",
            "type": "string",
            "enum": [
              "possible",
              "probable",
              "expected"
            ]
          }
        },
        "required": [
          "text"
        ],
        "additionalProperties": false,
        "description": "One planned program or initiative."
      },
      "description": "En-route initiatives the FAA expects later today: route closures, severe-weather avoidance plans (SWAP), and coded departure routes (CDRs), in plan order."
    },
    "announcements": {
      "description": "Current ATCSCC announcements; [] when there are none, absent when that FAA list could not be read.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string",
            "description": "Announcement text (FAA-authored)."
          }
        },
        "required": [
          "text"
        ],
        "additionalProperties": false,
        "description": "One ATCSCC announcement."
      }
    },
    "notice": {
      "description": "Guidance on an empty plan, a missing advisory link, or partial data.",
      "type": "string"
    },
    "error": {
      "description": "Present when the call failed. Absent on success.",
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "JSON-RPC error code for this failure."
        },
        "message": {
          "type": "string",
          "description": "Human-readable description of what went wrong."
        },
        "data": {
          "type": "object",
          "properties": {
            "reason": {
              "type": "string",
              "description": "Machine-readable failure mode. Declared by this tool: `feed_unavailable`: NAS Status unreachable, 5xx, an attempt timeout, or an HTML maintenance page, after retries. `upstream_rate_limited`: The FAA returned 429 after retries, or this server's queue to the FAA would wait past 10 s while backing off from an FAA 429. `retry_deadline_exceeded`: The 20 s retry budget ran out. `pacer_shed`: This server's own queue to the FAA would wait past 10 s with no FAA 429 backoff in effect. `feed_contract_changed`: The feed path returned 404/410, or a body whose shape this server no longer recognizes. Other values are possible when a failure originates below the handler.",
              "examples": [
                "feed_unavailable",
                "upstream_rate_limited",
                "retry_deadline_exceeded",
                "pacer_shed",
                "feed_contract_changed"
              ]
            },
            "recovery": {
              "description": "Actionable next step for the caller.",
              "type": "object",
              "properties": {
                "hint": {
                  "type": "string"
                }
              },
              "required": [
                "hint"
              ],
              "additionalProperties": {}
            },
            "retryable": {
              "description": "Whether retrying may succeed.",
              "type": "boolean"
            }
          },
          "additionalProperties": {}
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": {}
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "anyOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "required": [
        "fetchedAt",
        "terminalPlanned",
        "enRoutePlanned"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}

Get the full text of one ATCSCC advisory by its number and UTC date. faa_delays_list_advisories lists the advisories issued on a date with their numbers, and the advisory reference that faa_delays_list_active_events and faa_delays_get_airport_status return on program rows and faa_delays_get_operations_plan returns for the plan names one directly. Advisory text carries what the status feed omits: program rate by hour, delay assignment mode, scope, comments, and the operations plan's active constraints and runway closures. Advisory numbers restart at 1 each UTC day, and older advisories remain available.

{
  "type": "object",
  "properties": {
    "advisory_number": {
      "description": "ATCSCC advisory number, 1–999: number from a faa_delays_list_advisories row, or advisory.number from an advisory reference on faa_delays_list_active_events, faa_delays_get_airport_status, or faa_delays_get_operations_plan. The printed forms \"ADVZY 082\" and \"082\" are also accepted.",
      "type": "integer",
      "minimum": 1,
      "maximum": 999
    },
    "date": {
      "description": "UTC date the advisory was issued, YYYY-MM-DD: date from the same faa_delays_list_advisories row or advisory reference. MM/DD/YYYY, as advisory titles print it, and M/D/YYYY are also accepted.",
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    }
  },
  "required": [
    "advisory_number",
    "date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean",
      "description": "Whether the FAA advisories database holds this advisory number on this UTC date."
    },
    "advisoryNumber": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "The advisory number read."
    },
    "date": {
      "type": "string",
      "description": "The advisory UTC date read, YYYY-MM-DD."
    },
    "url": {
      "type": "string",
      "description": "Server-built advisory URL this tool read; it also opens in a browser."
    },
    "title": {
      "description": "Advisory title line as the FAA prints it (FAA-authored), e.g. ATCSCC ADVZY 082 DCC 09/29/2026 OPERATIONS PLAN.",
      "type": "string"
    },
    "controlElement": {
      "description": "Airport/ARTCC pair or facility the advisory concerns, parsed from the title (SEA/ZSE, DCC); absent when the title has another form.",
      "type": "string"
    },
    "subject": {
      "description": "Advisory subject parsed from the title (CDM GROUND DELAY PROGRAM, OPERATIONS PLAN); absent when the title has another form.",
      "type": "string"
    },
    "effectiveTime": {
      "description": "Effective period as the FAA prints it, DDHHMM-DDHHMM in UTC.",
      "type": "string"
    },
    "sentAt": {
      "description": "When the advisory was signed, as the FAA prints it: YY/MM/DD HH:MM in UTC.",
      "type": "string"
    },
    "text": {
      "description": "Full advisory text (FAA-authored), cut at 50,000 characters when longer; truncated then reports the cut.",
      "type": "string"
    },
    "guidance": {
      "description": "Present when found is false: where to get a valid advisory number and date.",
      "type": "string"
    },
    "truncated": {
      "description": "True when the advisory text was cut at the 50,000-character ceiling; absent otherwise.",
      "type": "boolean"
    },
    "shown": {
      "description": "Characters of advisory text returned; present only when the text was cut.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "cap": {
      "description": "The character ceiling applied; present only when the text was cut.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "totalChars": {
      "description": "Full length of the advisory text in characters; present only when the text was cut.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "notice": {
      "description": "Guidance on a cut advisory text; present only when the text was cut.",
      "type": "string"
    },
    "error": {
      "description": "Present when the call failed. Absent on success.",
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "JSON-RPC error code for this failure."
        },
        "message": {
          "type": "string",
          "description": "Human-readable description of what went wrong."
        },
        "data": {
          "type": "object",
          "properties": {
            "reason": {
              "type": "string",
              "description": "Machine-readable failure mode. Declared by this tool: `advisory_service_unavailable`: FAA advisories database unreachable, 5xx, an attempt timeout, or an error page, after retries. `upstream_rate_limited`: The advisories host returned 429 after retries, or this server's queue to it would wait past 10 s while backing off from that host's 429. `retry_deadline_exceeded`: The 20 s retry budget ran out. `pacer_shed`: This server's queue to the advisories host would wait past 10 s with no 429 backoff in effect. `advisory_contract_changed`: Advisory page found (title present) but its text block is missing, or the path returned 404/410. Other values are possible when a failure originates below the handler.",
              "examples": [
                "advisory_service_unavailable",
                "upstream_rate_limited",
                "retry_deadline_exceeded",
                "pacer_shed",
                "advisory_contract_changed"
              ]
            },
            "recovery": {
              "description": "Actionable next step for the caller.",
              "type": "object",
              "properties": {
                "hint": {
                  "type": "string"
                }
              },
              "required": [
                "hint"
              ],
              "additionalProperties": {}
            },
            "retryable": {
              "description": "Whether retrying may succeed.",
              "type": "boolean"
            }
          },
          "additionalProperties": {}
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": {}
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "anyOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "required": [
        "found",
        "advisoryNumber",
        "date",
        "url"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}

List the ATCSCC advisories issued on one UTC date, newest first, from the FAA advisories database's per-date index: ground stops and delay programs as issued, proposed, revised, and canceled, required reroutes, flow constrained areas, operations plans, and CDM compression advisories, including those no longer active and those on past dates, which the NAS Status feed does not carry. Each row gives the advisory number, control element, subject, any further title lines (a reroute's name, constrained area, and valid period), and send time; its number and date open the full text with faa_delays_get_advisory. Narrow by categories or by control_element (an airport, its ICAO code, an ARTCC, or DCC for national advisories), and page with limit and offset.

{
  "type": "object",
  "properties": {
    "date": {
      "description": "UTC date to list, YYYY-MM-DD; MM/DD/YYYY and M/D/YYYY are also accepted. Omit for today (UTC). No later than tomorrow (UTC); past dates remain available.",
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    },
    "categories": {
      "description": "Only advisories the FAA files under these categories: ground_stop, ground_delay_program, airspace_flow_program, ctop, route, other (flow constrained areas and operations plans file under other). Also accepts gs, gdp, afp, spelled-out names such as \"ground stop\", and a comma-separated string; case-insensitive. Omit for every advisory, including CDM compression advisories, which the FAA files under no category.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "ground_stop",
          "ground_delay_program",
          "airspace_flow_program",
          "ctop",
          "route",
          "other"
        ],
        "description": "ATCSCC advisory index category."
      }
    },
    "control_element": {
      "description": "Only advisories whose control element is this facility or lists it as a part: an airport by FAA identifier (ORD) or ICAO code (KORD), an ARTCC (ZAU), a pair (ORD/ZAU or KORD/ZAU), or DCC for national advisories such as reroutes and the operations plan. Case-insensitive. Airports named only in a subject or details do not match.",
      "type": "string",
      "maxLength": 64
    },
    "limit": {
      "default": 50,
      "description": "Advisories per page, 1–200.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "offset": {
      "default": 0,
      "description": "Matching advisories to skip, for paging: nextOffset from the previous page.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "The UTC date read, YYYY-MM-DD; today (UTC) when date was omitted."
    },
    "advisories": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "number": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "ATCSCC advisory number; pass it as advisory_number to faa_delays_get_advisory for the full text."
          },
          "date": {
            "type": "string",
            "description": "Advisory UTC date, YYYY-MM-DD; pass it as date to faa_delays_get_advisory."
          },
          "controlElement": {
            "description": "Airport/ARTCC pair or facility the advisory concerns, as the FAA lists it (BOS/ZBW, DCC for national advisories); absent when the index lists none.",
            "type": "string"
          },
          "subject": {
            "description": "First line of the brief title (FAA-authored) without its ATCSCC ADVZY prefix, e.g. CDM PROPOSED GROUND DELAY PROGRAM or ROUTE RQD /FL.",
            "type": "string"
          },
          "details": {
            "description": "Further brief-title lines (FAA-authored): a reroute's or flow constrained area's name, constrained area, and valid period.",
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "sentAt": {
            "description": "When the advisory was sent, ISO 8601 UTC.",
            "type": "string"
          }
        },
        "required": [
          "number",
          "date"
        ],
        "additionalProperties": false,
        "description": "One advisory from the index."
      },
      "description": "Advisories issued on date that match categories and control_element, newest first: up to limit of them, starting at offset."
    },
    "nextOffset": {
      "description": "offset of the next page; present while matching advisories remain past this one.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "totalCount": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Advisories on date that match categories and control_element, before paging."
    },
    "truncated": {
      "description": "True when matching advisories remain past this page; absent otherwise.",
      "type": "boolean"
    },
    "shown": {
      "description": "Advisories on this page; present only when more remain.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "cap": {
      "description": "The limit applied; present only when more advisories remain.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "appliedCategories": {
      "description": "The categories filter as the server normalized it; absent when omitted, which reads every advisory, uncategorized ones included.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "ground_stop",
          "ground_delay_program",
          "airspace_flow_program",
          "ctop",
          "route",
          "other"
        ],
        "description": "ATCSCC advisory index category."
      }
    },
    "appliedControlElement": {
      "description": "The control_element filter as the server matched it: uppercased, each ICAO airport code in it mapped to its FAA identifier (KORD → ORD, KORD/ZAU → ORD/ZAU); absent when omitted.",
      "type": "string"
    },
    "notice": {
      "description": "Guidance on an empty date, a filter that matched nothing, an offset past the end, more pages, and index rows that could not be read.",
      "type": "string"
    },
    "error": {
      "description": "Present when the call failed. Absent on success.",
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "JSON-RPC error code for this failure."
        },
        "message": {
          "type": "string",
          "description": "Human-readable description of what went wrong."
        },
        "data": {
          "type": "object",
          "properties": {
            "reason": {
              "type": "string",
              "description": "Machine-readable failure mode. Declared by this tool: `advisory_service_unavailable`: FAA advisories database unreachable, 5xx, an attempt timeout, or a page that is not an advisory index (an error page), after retries. `upstream_rate_limited`: The advisories host returned 429 after retries, or this server's queue to it would wait past 10 s while backing off from that host's 429. `retry_deadline_exceeded`: The 20 s retry budget ran out. `pacer_shed`: This server's queue to the advisories host would wait past 10 s with no 429 backoff in effect. `advisory_contract_changed`: Advisory index found (caption present) but no row is readable, or the path returned 404/410. Other values are possible when a failure originates below the handler.",
              "examples": [
                "advisory_service_unavailable",
                "upstream_rate_limited",
                "retry_deadline_exceeded",
                "pacer_shed",
                "advisory_contract_changed"
              ]
            },
            "recovery": {
              "description": "Actionable next step for the caller.",
              "type": "object",
              "properties": {
                "hint": {
                  "type": "string"
                }
              },
              "required": [
                "hint"
              ],
              "additionalProperties": {}
            },
            "retryable": {
              "description": "Whether retrying may succeed.",
              "type": "boolean"
            }
          },
          "additionalProperties": {}
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": {}
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "anyOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "required": [
        "date",
        "advisories",
        "totalCount"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}

Decode the vocabulary the other faa_delays tools return: event types and their fields, traffic-management terms (AAR, EDCT, FCA, GDP, SWAP), ARTCC center codes, the FAA pacing airports with time zones, and accepted identifier formats.

{
  "type": "object",
  "properties": {
    "topic": {
      "description": "What to decode: event_types (event types and their key fields), terms (traffic-management abbreviations), artccs (ARTCC center codes and names), pacing_airports (the FAA pacing airports with time zones, read live), or identifiers (accepted airport-code, advisory, and time formats). Case-insensitive; spaces and hyphens read as underscores.",
      "type": "string",
      "enum": [
        "event_types",
        "terms",
        "artccs",
        "pacing_airports",
        "identifiers"
      ]
    }
  },
  "required": [
    "topic"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "enum": [
        "event_types",
        "terms",
        "artccs",
        "pacing_airports",
        "identifiers"
      ],
      "description": "The topic this result decodes."
    },
    "eventTypes": {
      "description": "Present for topic event_types, in severity order.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "eventType": {
            "type": "string",
            "enum": [
              "airport_closure",
              "ground_stop",
              "ground_delay_program",
              "airspace_flow_program",
              "arrival_delay",
              "departure_delay",
              "closure_notam",
              "deicing"
            ],
            "description": "FAA traffic management event type."
          },
          "label": {
            "type": "string",
            "description": "Human-readable name."
          },
          "meaning": {
            "type": "string",
            "description": "What the event means, per the FAA NAS Status user guide."
          },
          "keyFields": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Output field name, with a note where useful."
            },
            "description": "Output fields that carry the detail of this event type."
          }
        },
        "required": [
          "eventType",
          "label",
          "meaning",
          "keyFields"
        ],
        "additionalProperties": false,
        "description": "One event type."
      }
    },
    "terms": {
      "description": "Present for topic terms, alphabetical.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "term": {
            "type": "string",
            "description": "Abbreviation or term."
          },
          "meaning": {
            "type": "string",
            "description": "What it means in FAA traffic management."
          }
        },
        "required": [
          "term",
          "meaning"
        ],
        "additionalProperties": false,
        "description": "One term."
      }
    },
    "artccs": {
      "description": "Present for topic artccs, by code: the 25 US ARTCCs, including the New York and Oakland oceanic centers, plus Anchorage Oceanic, Guam, Auckland Oceanic, Toronto, and Vancouver, the other facilities NASR names as an airport's ARTCC. Every artcc faa_delays_get_airport_status returns is listed.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Facility code: three letters starting with Z (ZSE), or a 4-letter ICAO FIR code (NZZO)."
          },
          "name": {
            "type": "string",
            "description": "Facility name."
          }
        },
        "required": [
          "code",
          "name"
        ],
        "additionalProperties": false,
        "description": "One air traffic control facility."
      }
    },
    "pacingAirports": {
      "description": "Present for topic pacing_airports: the FAA pacing airports, read live and cached 6 h.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "airportId": {
            "type": "string",
            "description": "FAA 3-character identifier."
          },
          "timezone": {
            "description": "IANA-style time zone the FAA assigns (US/Pacific); FAA-supplied text.",
            "type": "string"
          },
          "latitude": {
            "description": "Latitude in decimal degrees.",
            "type": "number"
          },
          "longitude": {
            "description": "Longitude in decimal degrees.",
            "type": "number"
          }
        },
        "required": [
          "airportId"
        ],
        "additionalProperties": false,
        "description": "One pacing airport."
      }
    },
    "fetchedAt": {
      "description": "Present for topic pacing_airports: when this server fetched the list from the FAA (UTC ISO).",
      "type": "string"
    },
    "identifiers": {
      "description": "Present for topic identifiers.",
      "type": "object",
      "properties": {
        "airportDirectory": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string",
              "description": "FAA dataset the directory is built from."
            },
            "effectiveDate": {
              "type": "string",
              "description": "NASR cycle effective date, YYYY-MM-DD."
            },
            "airportCount": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991,
              "description": "US airports the directory lists."
            }
          },
          "required": [
            "source",
            "effectiveDate",
            "airportCount"
          ],
          "additionalProperties": false,
          "description": "The bundled FAA NASR airport directory that validates airport codes. An identifier assigned after this cycle is rejected until the next refresh."
        },
        "formats": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "identifier": {
                "type": "string",
                "description": "What is identified."
              },
              "format": {
                "type": "string",
                "description": "Accepted or returned form."
              },
              "example": {
                "type": "string",
                "description": "Example value."
              }
            },
            "required": [
              "identifier",
              "format",
              "example"
            ],
            "additionalProperties": false,
            "description": "One identifier format."
          },
          "description": "Identifier and time formats the faa_delays tools accept and return."
        }
      },
      "required": [
        "airportDirectory",
        "formats"
      ],
      "additionalProperties": false
    },
    "error": {
      "description": "Present when the call failed. Absent on success.",
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "JSON-RPC error code for this failure."
        },
        "message": {
          "type": "string",
          "description": "Human-readable description of what went wrong."
        },
        "data": {
          "type": "object",
          "properties": {
            "reason": {
              "type": "string",
              "description": "Machine-readable failure mode. Declared by this tool: `feed_unavailable`: NAS Status unreachable, 5xx, an attempt timeout, or an HTML maintenance page, after retries (topic pacing_airports only). `upstream_rate_limited`: The FAA returned 429 after retries, or this server's queue to the FAA would wait past 10 s while backing off from an FAA 429 (topic pacing_airports only). `retry_deadline_exceeded`: The 20 s retry budget ran out (topic pacing_airports only). `pacer_shed`: This server's own queue to the FAA would wait past 10 s with no FAA 429 backoff in effect (topic pacing_airports only). `feed_contract_changed`: The pacing-airports path returned 404/410, or a body whose shape this server no longer recognizes. Other values are possible when a failure originates below the handler.",
              "examples": [
                "feed_unavailable",
                "upstream_rate_limited",
                "retry_deadline_exceeded",
                "pacer_shed",
                "feed_contract_changed"
              ]
            },
            "recovery": {
              "description": "Actionable next step for the caller.",
              "type": "object",
              "properties": {
                "hint": {
                  "type": "string"
                }
              },
              "required": [
                "hint"
              ],
              "additionalProperties": {}
            },
            "retryable": {
              "description": "Whether retrying may succeed.",
              "type": "boolean"
            }
          },
          "additionalProperties": {}
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": {}
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "anyOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "required": [
        "topic"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}