faa-traffic-delays-mcp-server
An MCP server that provides real-time US air traffic status from the FAA Command Center. It allows agents to check airports for ground stops, delay programs, closures, and deicing; list every active event nationwide sorted by severity; retrieve the current operations plan with planned initiatives; and access full ATCSCC advisory text.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://faa-traffic-delays.caseyjhand.com/mcpWhat its tools do
6 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Check current FAA traffic management status for specific US airports
- List every active FAA traffic management event across the National Airspace System
- Get the FAA Command Center's current operations plan and initiatives
- Retrieve full text of ATCSCC advisories by number and date
Source and maintenance
Community listingRegistry 0.3.0
- Maintenance checked
Protocol and capabilities
- Server
- faa-traffic-delays-mcp-server 0.3.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 6 advertised
- Resources
- 1 advertised
- Resource templates
- 1 advertised
- Prompts
- 0 advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
},
"logging": {},
"prompts": {
"listChanged": true
},
"resources": {
"subscribe": true,
"listChanged": true
},
"extensions": {
"io.modelcontextprotocol/skills": {
"directoryRead": true
}
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
6 advertised
faa_delays_get_airport_status — Get FAA Airport Status
Advertised read-onlyOpen-world
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. Each row also carries plannedPrograms, the current operations plan's terminal ground-stop and delay-program items that name the airport, with the plan's times as written. 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.
faa_delays_get_airport_status input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"airports"
],
"properties": {
"airports": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z0-9]{3,4}$",
"description": "US airport: 3-character FAA identifier (SEA) or its ICAO code (KSEA); trimmed and uppercased before validation."
},
"maxItems": 100,
"minItems": 1,
"description": "1–100 submitted US airport codes, 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. Validates every code, deduplicates FAA/ICAO equivalents, and processes the first 25 distinct airports with the canonical remainder returned as omittedAirports. City and airport names are not accepted."
}
},
"additionalProperties": false
}faa_delays_get_airport_status output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"fetchedAt",
"airports",
"cap",
"processedCount",
"omittedAirports"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Maximum distinct airports processed: 25."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"unknown_airport",
"feed_unavailable",
"upstream_rate_limited",
"retry_deadline_exceeded",
"pacer_shed",
"feed_contract_changed"
],
"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."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"notice": {
"type": "string",
"description": "Guidance on quiet results, stale delay entries, or partial data."
},
"airports": {
"type": "array",
"items": {
"type": "object",
"required": [
"airportId",
"airportName",
"status",
"listedInFeed"
],
"properties": {
"city": {
"type": "string",
"description": "City from the NASR directory."
},
"artcc": {
"type": "string",
"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."
},
"state": {
"type": "string",
"description": "State or territory code from the NASR directory."
},
"status": {
"enum": [
"closed",
"ground_stop",
"ground_delay_program",
"delays",
"restrictions_only",
"no_active_events"
],
"type": "string",
"description": "Headline status, first match wins: closed (an airport closure in effect; one outside its daily window, closure.inEffect false, is skipped) → ground_stop → ground_delay_program → delays (arrival or departure delay) → restrictions_only (listed with only a closure NOTAM, deicing, runway configuration, or an airport closure outside its daily window) → no_active_events (absent from the feed: no FAA program, which does not guarantee on-time flights)."
},
"closure": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "The NOTAM wording without its header and effective period: the restriction or the closure exceptions (FAA-authored)."
},
"endTime": {
"type": "string",
"description": "End (UTC ISO)."
},
"inEffect": {
"type": "boolean",
"description": "Whether the closure applies at fetchedAt: between startTime and endTime and inside dailyWindowUtc. Present only with dailyWindowUtc; when false, the notice names the next window."
},
"issuedAt": {
"type": "string",
"description": "NOTAM issue time (UTC ISO)."
},
"notamText": {
"type": "string",
"description": "Full NOTAM text (FAA-authored)."
},
"startTime": {
"type": "string",
"description": "Start (UTC ISO)."
},
"updatedAt": {
"type": "string",
"description": "Last FAA update (UTC ISO)."
},
"notamNumber": {
"type": "number",
"description": "NOTAM number."
},
"dailyWindowUtc": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"description": "Window end, HHMM UTC; earlier than start when the window crosses 0000Z."
},
"start": {
"type": "string",
"description": "Window start, HHMM UTC."
}
},
"description": "The daily window the NOTAM schedules (a DLY HHMM-HHMM closing its text, with startTime on the first window start and endTime on the last window end): the closure applies only inside it, every day from startTime to endTime. Absent when the text states no such schedule.",
"additionalProperties": false
}
},
"description": "Airport closed to all operations, with its NOTAM; text lists the exceptions. A closure scheduled daily is closed only inside dailyWindowUtc, and inEffect says whether it is at fetchedAt.",
"additionalProperties": false
},
"deicing": {
"type": "object",
"properties": {
"startedAt": {
"type": "string",
"description": "When deicing began (UTC ISO)."
}
},
"description": "A formal deicing program is in effect.",
"additionalProperties": false
},
"latitude": {
"type": "number",
"description": "Latitude in decimal degrees: the feed's value for a listed airport, else the NASR directory's (4 decimal places)."
},
"timezone": {
"type": "string",
"description": "Effective IANA time zone; PHX reported as US/Mountain is corrected to America/Phoenix."
},
"airportId": {
"type": "string",
"description": "Normalized 3-character FAA identifier."
},
"longitude": {
"type": "number",
"description": "Longitude in decimal degrees: the feed's value for a listed airport, else the NASR directory's (4 decimal places)."
},
"groundStop": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Stated cause (FAA-authored text)."
},
"endTime": {
"type": "string",
"description": "Scheduled end (UTC ISO)."
},
"advisory": {
"type": "object",
"required": [
"number",
"date",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Server-built advisory URL, the page faa_delays_get_advisory reads for this number and date."
},
"date": {
"type": "string",
"description": "Advisory UTC date, YYYY-MM-DD."
},
"number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "ATCSCC advisory number; numbers restart at 1 each UTC day."
}
},
"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
},
"startTime": {
"type": "string",
"description": "Start (UTC ISO)."
},
"updatedAt": {
"type": "string",
"description": "Last FAA update (UTC ISO)."
},
"includedFlights": {
"type": "string",
"description": "Flights included, such as ALL CONTIGUOUS US DEP (FAA-authored text)."
},
"controllingCenter": {
"type": "string",
"description": "Controlling ARTCC code (ZSE)."
},
"includedFacilities": {
"type": "array",
"items": {
"type": "string",
"description": "ARTCC code, as in artcc, or 4-character ICAO airport code."
},
"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."
},
"probabilityOfExtension": {
"enum": [
"low",
"medium",
"high"
],
"type": "string",
"description": "Likelihood the stop is extended: low <30 %, medium 30–60 %, high >60 % per the FAA."
}
},
"description": "Active ground stop: flights to this airport are held at their departure airports.",
"additionalProperties": false
},
"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."
},
"requestedAs": {
"type": "string",
"description": "The code as submitted (an ICAO code), present only when it differs from airportId."
},
"arrivalDelay": {
"type": "object",
"properties": {
"trend": {
"enum": [
"increasing",
"decreasing"
],
"type": "string",
"description": "Direction the delay is moving."
},
"reason": {
"type": "string",
"description": "Stated cause (FAA-authored text), e.g. \"RWY:Construction\"."
},
"updatedAt": {
"type": "string",
"description": "When the FAA last updated this delay (UTC ISO); an entry can outlive the delay."
},
"maxMinutes": {
"type": "number",
"description": "Upper bound of the delay band in minutes."
},
"minMinutes": {
"type": "number",
"description": "Lower bound of the delay band in minutes (the FAA reports delays in 15-minute bands)."
}
},
"description": "Active arrival delay (airborne holding).",
"additionalProperties": false
},
"closureNotam": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "The NOTAM wording without its header and effective period: the restriction or the closure exceptions (FAA-authored)."
},
"endTime": {
"type": "string",
"description": "End (UTC ISO)."
},
"inEffect": {
"type": "boolean",
"description": "Whether the closure applies at fetchedAt: between startTime and endTime and inside dailyWindowUtc. Present only with dailyWindowUtc; when false, the notice names the next window."
},
"issuedAt": {
"type": "string",
"description": "NOTAM issue time (UTC ISO)."
},
"notamText": {
"type": "string",
"description": "Full NOTAM text (FAA-authored)."
},
"startTime": {
"type": "string",
"description": "Start (UTC ISO)."
},
"updatedAt": {
"type": "string",
"description": "Last FAA update (UTC ISO)."
},
"notamNumber": {
"type": "number",
"description": "NOTAM number."
},
"dailyWindowUtc": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"description": "Window end, HHMM UTC; earlier than start when the window crosses 0000Z."
},
"start": {
"type": "string",
"description": "Window start, HHMM UTC."
}
},
"description": "The daily window the NOTAM schedules (a DLY HHMM-HHMM closing its text, with startTime on the first window start and endTime on the last window end): the closure applies only inside it, every day from startTime to endTime. Absent when the text states no such schedule.",
"additionalProperties": false
}
},
"description": "NOTAM-worded closure or restriction, often narrow (for example closed to transient GA).",
"additionalProperties": false
},
"listedInFeed": {
"type": "boolean",
"description": "Whether the FAA feed lists this airport; it lists only airports with an active event."
},
"departureDelay": {
"type": "object",
"properties": {
"trend": {
"enum": [
"increasing",
"decreasing"
],
"type": "string",
"description": "Direction the delay is moving."
},
"reason": {
"type": "string",
"description": "Stated cause (FAA-authored text), e.g. \"RWY:Construction\"."
},
"updatedAt": {
"type": "string",
"description": "When the FAA last updated this delay (UTC ISO); an entry can outlive the delay."
},
"maxMinutes": {
"type": "number",
"description": "Upper bound of the delay band in minutes."
},
"minMinutes": {
"type": "number",
"description": "Lower bound of the delay band in minutes (the FAA reports delays in 15-minute bands)."
}
},
"description": "Active departure delay (taxi or gate holds).",
"additionalProperties": false
},
"isPacingAirport": {
"type": "boolean",
"description": "Whether the FAA tracks this as a pacing airport; omitted when that list could not be read."
},
"plannedPrograms": {
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "The planned item as the FAA wrote it, tabs flattened and the leading dash removed (FAA-authored)."
},
"timeUtc": {
"type": "string",
"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."
},
"advisory": {
"type": "object",
"required": [
"number",
"date",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Server-built advisory URL, the page faa_delays_get_advisory reads for this number and date."
},
"date": {
"type": "string",
"description": "Advisory UTC date, YYYY-MM-DD."
},
"number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "ATCSCC advisory number; numbers restart at 1 each UTC day."
}
},
"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
},
"likelihood": {
"enum": [
"possible",
"probable",
"expected"
],
"type": "string",
"description": "The FAA's stated likelihood: possible (<30 %), probable (30–60 %), or expected (most likely). Absent when the text states none."
},
"timeQualifier": {
"enum": [
"after",
"until",
"by",
"between"
],
"type": "string",
"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."
}
},
"description": "One terminal item of the current operations plan that names this airport, with the advisory reference of the plan.",
"additionalProperties": false
},
"description": "The current operations plan's terminal ground-stop and delay-program items that name this airport, each identical item once, with times as the plan states them (see timeUtc; an item past its time is not filtered out). [] when the plan names the airport nowhere, which does not mean no trouble is expected: en-route items, constraints, and runway closures stay in faa_delays_get_operations_plan and the plan advisory. Absent when the operations plan could not be read. Never changes status."
},
"reportedTimezone": {
"type": "string",
"description": "Original FAA time zone when a verified correction was applied."
},
"groundDelayProgram": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Stated cause (FAA-authored text)."
},
"endTime": {
"type": "string",
"description": "Program end (UTC ISO)."
},
"advisory": {
"type": "object",
"required": [
"number",
"date",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Server-built advisory URL, the page faa_delays_get_advisory reads for this number and date."
},
"date": {
"type": "string",
"description": "Advisory UTC date, YYYY-MM-DD."
},
"number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "ATCSCC advisory number; numbers restart at 1 each UTC day."
}
},
"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
},
"startTime": {
"type": "string",
"description": "Start of the current revision's arrival window (UTC ISO); a revised program keeps its earlier start in programStartTime."
},
"updatedAt": {
"type": "string",
"description": "Last FAA update (UTC ISO)."
},
"delayProfile": {
"type": "object",
"required": [
"startTime",
"intervalMinutes",
"averageDelayMinutes"
],
"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."
}
},
"description": "Delay trend: average assigned delay for each 15-minute arrival interval of the program.",
"additionalProperties": false
},
"includedFlights": {
"type": "string",
"description": "Flights included, such as ALL CONTIGUOUS US DEP (FAA-authored text)."
},
"departureScopeNm": {
"type": "number",
"description": "Departure scope: departures within this many nautical miles are included."
},
"programStartTime": {
"type": "string",
"description": "When the program began, before any revision (UTC ISO)."
},
"controllingCenter": {
"type": "string",
"description": "Controlling ARTCC code (ZSE)."
},
"includedFacilities": {
"type": "array",
"items": {
"type": "string",
"description": "ARTCC code, as in artcc, or 4-character ICAO airport code."
},
"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."
},
"averageDelayMinutes": {
"type": "number",
"description": "Average assigned delay in minutes."
},
"maximumDelayMinutes": {
"type": "number",
"description": "Maximum assigned delay in minutes."
}
},
"description": "Active Ground Delay Program: flights to this airport receive assigned departure delays.",
"additionalProperties": false
},
"runwayConfiguration": {
"type": "object",
"properties": {
"reportedAt": {
"type": "string",
"description": "When the FAA recorded this configuration (UTC ISO)."
},
"arrivalRunways": {
"type": "string",
"description": "Arrival runways in use (FAA-authored text)."
},
"departureRunways": {
"type": "string",
"description": "Departure runways in use (FAA-authored text)."
},
"arrivalRatePerHour": {
"type": "number",
"description": "Airport arrival rate (AAR): arrivals the airport accepts per hour."
}
},
"description": "Runway configuration and arrival rate; reported only for airports the feed lists.",
"additionalProperties": false
}
},
"description": "Status of one requested airport.",
"additionalProperties": false
},
"description": "One row per processed airport, in first-seen request order, up to 25 distinct FAA identifiers."
},
"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."
},
"processedCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Distinct airports processed in this response."
},
"omittedAirports": {
"type": "array",
"items": {
"type": "string"
},
"description": "Canonical FAA identifiers left after the first 25 distinct airports, in first-seen order; empty when all were processed."
}
},
"additionalProperties": false
}faa_delays_get_airport_status annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}faa_delays_list_active_events — List Active FAA Delay Events
Advertised read-onlyOpen-world
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 (airport closures in effect, ground stops, then GDPs and then AFPs each by average delay, arrival/departure delays by band maximum, closure NOTAMs and airport closures outside their daily window, 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.
faa_delays_list_active_events input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"event_types": {
"type": "array",
"items": {
"enum": [
"airport_closure",
"ground_stop",
"ground_delay_program",
"airspace_flow_program",
"arrival_delay",
"departure_delay",
"closure_notam",
"deicing"
],
"type": "string",
"description": "FAA traffic management event type."
},
"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."
}
},
"additionalProperties": false
}faa_delays_list_active_events output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"fetchedAt",
"events",
"totalActive",
"shown",
"countsByType",
"appliedEventTypes",
"enRouteFeed"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"feed_unavailable",
"upstream_rate_limited",
"retry_deadline_exceeded",
"pacer_shed",
"feed_contract_changed"
],
"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."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"shown": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Events returned after the event_types filter."
},
"events": {
"type": "array",
"items": {
"type": "object",
"required": [
"eventType",
"location"
],
"properties": {
"afp": {
"type": "object",
"required": [
"constrainedArea"
],
"properties": {
"comments": {
"type": "string",
"description": "Program comments (FAA-authored)."
},
"arrivesTo": {
"type": "string",
"description": "Arrival facilities included (FAA-authored)."
},
"departsFrom": {
"type": "string",
"description": "Departure facilities included (FAA-authored)."
},
"delayProfile": {
"type": "object",
"required": [
"startTime",
"intervalMinutes",
"averageDelayMinutes"
],
"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."
}
},
"description": "Delay trend: average assigned delay for each 15-minute arrival interval of the program.",
"additionalProperties": false
},
"altitudeFloor": {
"type": "string",
"description": "Lower altitude bound as the FAA reports it."
},
"altitudeCeiling": {
"type": "string",
"description": "Upper altitude bound as the FAA reports it."
},
"constrainedArea": {
"type": "object",
"required": [
"type"
],
"properties": {
"name": {
"type": "string",
"description": "Name of the constrained element (FAA-authored)."
},
"type": {
"enum": [
"airport",
"artcc",
"sector",
"tracon",
"special_use_airspace",
"fix",
"fca"
],
"type": "string",
"description": "Kind of Flow Constrained Area; fca when the FAA names no specific element."
}
},
"description": "The airspace the program meters.",
"additionalProperties": false
},
"filtersMatchAny": {
"type": "boolean",
"description": "true: departs OR arrives filters apply; false: both must match."
},
"excludedArrivals": {
"type": "string",
"description": "Arrival facilities excluded (FAA-authored)."
},
"headingDirection": {
"type": "string",
"description": "Direction of flights included, e.g. westbound (FAA-authored)."
},
"excludedDepartures": {
"type": "string",
"description": "Departure facilities excluded (FAA-authored)."
}
},
"description": "Airspace Flow Program detail; present only on airspace_flow_program rows.",
"additionalProperties": false
},
"trend": {
"enum": [
"increasing",
"decreasing"
],
"type": "string",
"description": "Direction an arrival or departure delay is moving."
},
"reason": {
"type": "string",
"description": "Stated cause (FAA-authored text)."
},
"endTime": {
"type": "string",
"description": "End (UTC ISO)."
},
"advisory": {
"type": "object",
"required": [
"number",
"date",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Server-built advisory URL, the page faa_delays_get_advisory reads for this number and date."
},
"date": {
"type": "string",
"description": "Advisory UTC date, YYYY-MM-DD."
},
"number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "ATCSCC advisory number; numbers restart at 1 each UTC day."
}
},
"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
},
"inEffect": {
"type": "boolean",
"description": "Whether the closure applies at fetchedAt: between startTime and endTime and inside dailyWindowUtc. Present only with dailyWindowUtc; when false, the notice names the next window."
},
"location": {
"type": "string",
"description": "FAA airport identifier, or the AFP name for airspace_flow_program (FAA-authored)."
},
"eventType": {
"enum": [
"airport_closure",
"ground_stop",
"ground_delay_program",
"airspace_flow_program",
"arrival_delay",
"departure_delay",
"closure_notam",
"deicing"
],
"type": "string",
"description": "FAA traffic management event type."
},
"startTime": {
"type": "string",
"description": "Start (UTC ISO). For ground_delay_program, the start of the current revision's arrival window; for deicing, when it began."
},
"updatedAt": {
"type": "string",
"description": "Last FAA update (UTC ISO)."
},
"closureText": {
"type": "string",
"description": "The NOTAM text of an airport_closure or closure_notam row, or its wording without the NOTAM header when the FAA sends no NOTAM text (FAA-authored)."
},
"locationName": {
"type": "string",
"description": "Airport name (FAA-authored)."
},
"dailyWindowUtc": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"description": "Window end, HHMM UTC; earlier than start when the window crosses 0000Z."
},
"start": {
"type": "string",
"description": "Window start, HHMM UTC."
}
},
"description": "The daily window the NOTAM schedules (a DLY HHMM-HHMM closing its text, with startTime on the first window start and endTime on the last window end): the closure applies only inside it, every day from startTime to endTime. Absent when the text states no such schedule.",
"additionalProperties": false
},
"programStartTime": {
"type": "string",
"description": "When a ground_delay_program began, before any revision (UTC ISO); absent on other types."
},
"delayRangeMinutes": {
"type": "object",
"properties": {
"max": {
"type": "number",
"description": "Upper bound in minutes; absent when the FAA reported only the lower bound."
},
"min": {
"type": "number",
"description": "Lower bound in minutes; absent when the FAA reported only the upper bound."
}
},
"description": "Delay band for arrival_delay and departure_delay (the FAA reports 15-minute bands); absent when the FAA reported neither bound.",
"additionalProperties": false
},
"averageDelayMinutes": {
"type": "number",
"description": "Average assigned delay in minutes (ground_delay_program, airspace_flow_program)."
},
"maximumDelayMinutes": {
"type": "number",
"description": "Maximum assigned delay in minutes (ground_delay_program)."
},
"probabilityOfExtension": {
"enum": [
"low",
"medium",
"high"
],
"type": "string",
"description": "Ground stop extension likelihood: low <30 %, medium 30–60 %, high >60 % per the FAA."
}
},
"description": "One active event.",
"additionalProperties": false
},
"description": "Active events matching event_types, sorted by severity."
},
"notice": {
"type": "string",
"description": "Guidance on empty or partial results, stale delay entries, and how to get the missing data."
},
"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."
},
"enRouteFeed": {
"enum": [
"ok",
"unavailable",
"format_changed"
],
"type": "string",
"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)."
},
"totalActive": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Every active event read, before the event_types filter; excludes AFPs when the en-route feed could not be read."
},
"countsByType": {
"type": "object",
"required": [
"ground_stop",
"ground_delay_program",
"arrival_delay",
"departure_delay",
"airport_closure",
"closure_notam",
"deicing"
],
"properties": {
"deicing": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Airports deicing."
},
"ground_stop": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Active ground stops."
},
"arrival_delay": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Active arrival delays."
},
"closure_notam": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Closure NOTAMs."
},
"airport_closure": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Airport closures, including any outside its daily window (inEffect false)."
},
"departure_delay": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Active departure delays."
},
"ground_delay_program": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Active Ground Delay Programs."
},
"airspace_flow_program": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Active Airspace Flow Programs; absent when the en-route feed could not be read."
}
},
"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.",
"additionalProperties": false
},
"appliedEventTypes": {
"type": "array",
"items": {
"enum": [
"airport_closure",
"ground_stop",
"ground_delay_program",
"airspace_flow_program",
"arrival_delay",
"departure_delay",
"closure_notam",
"deicing"
],
"type": "string",
"description": "FAA traffic management event type."
},
"description": "The event_types filter as the server normalized it, or every type when omitted."
}
},
"additionalProperties": false
}faa_delays_list_active_events annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}faa_delays_get_operations_plan — Get FAA Operations Plan
Advertised read-onlyOpen-world
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.
faa_delays_get_operations_plan input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
}faa_delays_get_operations_plan output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"fetchedAt",
"terminalPlanned",
"enRoutePlanned"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"feed_unavailable",
"upstream_rate_limited",
"retry_deadline_exceeded",
"pacer_shed",
"feed_contract_changed"
],
"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."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"notice": {
"type": "string",
"description": "Guidance on an empty plan, a missing advisory link, or partial data."
},
"advisory": {
"type": "object",
"required": [
"number",
"date",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Server-built advisory URL, the page faa_delays_get_advisory reads for this number and date."
},
"date": {
"type": "string",
"description": "Advisory UTC date, YYYY-MM-DD."
},
"number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "ATCSCC advisory number; numbers restart at 1 each UTC day."
}
},
"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
},
"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."
},
"announcements": {
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "Announcement text (FAA-authored)."
}
},
"description": "One ATCSCC announcement.",
"additionalProperties": false
},
"description": "Current ATCSCC announcements; [] when there are none, absent when that FAA list could not be read."
},
"enRoutePlanned": {
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "The planned item as the FAA wrote it, tabs flattened and the leading dash removed (FAA-authored)."
},
"timeUtc": {
"type": "string",
"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."
},
"likelihood": {
"enum": [
"possible",
"probable",
"expected"
],
"type": "string",
"description": "The FAA's stated likelihood: possible (<30 %), probable (30–60 %), or expected (most likely). Absent when the text states none."
},
"timeQualifier": {
"enum": [
"after",
"until",
"by",
"between"
],
"type": "string",
"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."
}
},
"description": "One planned program or initiative.",
"additionalProperties": false
},
"description": "En-route initiatives the FAA expects later today: route closures, severe-weather avoidance plans (SWAP), and coded departure routes (CDRs), in plan order."
},
"terminalPlanned": {
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "The planned item as the FAA wrote it, tabs flattened and the leading dash removed (FAA-authored)."
},
"timeUtc": {
"type": "string",
"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."
},
"airports": {
"type": "array",
"items": {
"type": "string",
"description": "FAA 3-character airport identifier."
},
"description": "Airports this item names, in text order: the identifier group before GROUND (SEA/BFI gives SEA and BFI), each a code in the bundled FAA NASR directory, as faa_delays_get_airport_status accepts it. Absent when the item names none the directory lists, such as a metro area or an ARTCC."
},
"likelihood": {
"enum": [
"possible",
"probable",
"expected"
],
"type": "string",
"description": "The FAA's stated likelihood: possible (<30 %), probable (30–60 %), or expected (most likely). Absent when the text states none."
},
"timeQualifier": {
"enum": [
"after",
"until",
"by",
"between"
],
"type": "string",
"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."
}
},
"description": "One planned terminal program.",
"additionalProperties": false
},
"description": "Terminal programs the FAA expects later today: possible ground stops and delay programs by airport, in plan order."
}
},
"additionalProperties": false
}faa_delays_get_operations_plan annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}faa_delays_get_advisory — Get ATCSCC Advisory
Advertised read-onlyOpen-world
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.
faa_delays_get_advisory input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"advisory_number",
"date"
],
"properties": {
"date": {
"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])))$",
"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."
},
"advisory_number": {
"type": "integer",
"maximum": 999,
"minimum": 1,
"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."
}
},
"additionalProperties": false
}faa_delays_get_advisory output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"found",
"advisoryNumber",
"date",
"url"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The character ceiling applied; present only when the text was cut."
},
"url": {
"type": "string",
"description": "Server-built advisory URL this tool read; it also opens in a browser."
},
"date": {
"type": "string",
"description": "The advisory UTC date read, YYYY-MM-DD."
},
"text": {
"type": "string",
"description": "Full advisory text (FAA-authored), cut at 50,000 characters when longer; truncated then reports the cut."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"advisory_service_unavailable",
"upstream_rate_limited",
"retry_deadline_exceeded",
"pacer_shed",
"advisory_contract_changed"
],
"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."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"found": {
"type": "boolean",
"description": "Whether the FAA advisories database holds this advisory number on this UTC date."
},
"shown": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Characters of advisory text returned; present only when the text was cut."
},
"title": {
"type": "string",
"description": "Advisory title line as the FAA prints it (FAA-authored), e.g. ATCSCC ADVZY 082 DCC 09/29/2026 OPERATIONS PLAN."
},
"notice": {
"type": "string",
"description": "Guidance on a cut advisory text; present only when the text was cut."
},
"sentAt": {
"type": "string",
"description": "When the advisory was signed, ISO 8601 UTC, as faa_delays_list_advisories gives its send time. Absent when the page prints no signature or it names no real minute."
},
"subject": {
"type": "string",
"description": "Advisory subject parsed from the title (CDM GROUND DELAY PROGRAM, OPERATIONS PLAN); absent when the title has another form."
},
"guidance": {
"type": "string",
"description": "Present when found is false: where to get a valid advisory number and date."
},
"truncated": {
"type": "boolean",
"description": "True when the advisory text was cut at the 50,000-character ceiling; absent otherwise."
},
"totalChars": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Full length of the advisory text in characters; present only when the text was cut."
},
"effectiveEnd": {
"type": "string",
"description": "End of the effective period, ISO 8601 UTC: the first date at or after effectiveStart with the printed end day of month, in its month or the next. Present with effectiveStart."
},
"effectiveTime": {
"type": "string",
"description": "Effective period as the FAA prints it, DDHHMM-DDHHMM in UTC (day of month, hour, minute); effectiveStart and effectiveEnd give it as ISO 8601."
},
"advisoryNumber": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The advisory number read."
},
"controlElement": {
"type": "string",
"description": "Airport/ARTCC pair or facility the advisory concerns, parsed from the title (SEA/ZSE, DCC); absent when the title has another form."
},
"effectiveStart": {
"type": "string",
"description": "Start of the effective period, ISO 8601 UTC: the date nearest the advisory date with the printed start day of month (previous, same, or next month). Absent when effectiveTime is absent or names no real time."
}
},
"additionalProperties": false
}faa_delays_get_advisory annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}faa_delays_list_advisories — List ATCSCC Advisories
Advertised read-onlyOpen-world
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, control_element (an airport, its ICAO code, an ARTCC, or DCC for national advisories), or query (literal case-insensitive subject/details text, such as an FCA name); filters combine before limit and offset paging.
faa_delays_list_advisories input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"date": {
"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])))$",
"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."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Advisories per page (default 50). A UTC date lists at most 999 advisories, so 999 returns any date whole."
},
"query": {
"type": "string",
"description": "Literal case-insensitive substring of subject or any details line, such as FCA005; combined with categories and control_element before paging. Omit to match every title."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Matching advisories to skip, for paging: nextOffset from the previous page."
},
"categories": {
"type": "array",
"items": {
"enum": [
"ground_stop",
"ground_delay_program",
"airspace_flow_program",
"ctop",
"route",
"other"
],
"type": "string",
"description": "ATCSCC advisory index category."
},
"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."
},
"control_element": {
"type": "string",
"maxLength": 64,
"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."
}
},
"additionalProperties": false
}faa_delays_list_advisories output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"date",
"advisories",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The limit applied; present only when more advisories remain."
},
"date": {
"type": "string",
"description": "The UTC date read, YYYY-MM-DD; today (UTC) when date was omitted."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"advisory_service_unavailable",
"upstream_rate_limited",
"retry_deadline_exceeded",
"pacer_shed",
"advisory_contract_changed"
],
"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."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"shown": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Advisories on this page; present only when more remain."
},
"notice": {
"type": "string",
"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."
},
"truncated": {
"type": "boolean",
"description": "True when matching advisories remain past this page; absent otherwise."
},
"advisories": {
"type": "array",
"items": {
"type": "object",
"required": [
"number",
"date"
],
"properties": {
"date": {
"type": "string",
"description": "Advisory UTC date, YYYY-MM-DD; pass it as date to faa_delays_get_advisory."
},
"number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "ATCSCC advisory number; pass it as advisory_number to faa_delays_get_advisory for the full text."
},
"sentAt": {
"type": "string",
"description": "When the advisory was sent, ISO 8601 UTC."
},
"details": {
"type": "array",
"items": {
"type": "string"
},
"description": "Further brief-title lines (FAA-authored): a reroute's or flow constrained area's name, constrained area, and valid period."
},
"subject": {
"type": "string",
"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."
},
"controlElement": {
"type": "string",
"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."
}
},
"description": "One advisory from the index.",
"additionalProperties": false
},
"description": "Advisories issued on date that match categories, control_element, and query, newest first: up to limit of them, starting at offset."
},
"nextOffset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "offset of the next page; present while matching advisories remain past this one."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Advisories on date that match categories, control_element, and query, before paging."
},
"appliedQuery": {
"type": "string",
"description": "Trimmed text query matched against subjects and details; absent when unset."
},
"appliedCategories": {
"type": "array",
"items": {
"enum": [
"ground_stop",
"ground_delay_program",
"airspace_flow_program",
"ctop",
"route",
"other"
],
"type": "string",
"description": "ATCSCC advisory index category."
},
"description": "The categories filter as the server normalized it; absent when omitted, which reads every advisory, uncategorized ones included."
},
"appliedControlElement": {
"type": "string",
"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."
}
},
"additionalProperties": false
}faa_delays_list_advisories annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}faa_delays_list_reference — List FAA Delay Reference Data
Advertised read-onlyOpen-world
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.
faa_delays_list_reference input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"topic"
],
"properties": {
"topic": {
"enum": [
"event_types",
"terms",
"artccs",
"pacing_airports",
"identifiers"
],
"type": "string",
"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."
}
},
"additionalProperties": false
}faa_delays_list_reference output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"topic"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"feed_unavailable",
"upstream_rate_limited",
"retry_deadline_exceeded",
"pacer_shed",
"feed_contract_changed"
],
"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."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"terms": {
"type": "array",
"items": {
"type": "object",
"required": [
"term",
"meaning"
],
"properties": {
"term": {
"type": "string",
"description": "Abbreviation or term."
},
"meaning": {
"type": "string",
"description": "What it means in FAA traffic management."
}
},
"description": "One term.",
"additionalProperties": false
},
"description": "Present for topic terms, alphabetical."
},
"topic": {
"enum": [
"event_types",
"terms",
"artccs",
"pacing_airports",
"identifiers"
],
"type": "string",
"description": "The topic this result decodes."
},
"artccs": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name"
],
"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."
}
},
"description": "One air traffic control facility.",
"additionalProperties": false
},
"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."
},
"notice": {
"type": "string",
"description": "Unreadable pacing-airport rows omitted from this snapshot."
},
"fetchedAt": {
"type": "string",
"description": "Present for topic pacing_airports: when this server fetched the list from the FAA (UTC ISO)."
},
"eventTypes": {
"type": "array",
"items": {
"type": "object",
"required": [
"eventType",
"label",
"meaning",
"keyFields"
],
"properties": {
"label": {
"type": "string",
"description": "Human-readable name."
},
"meaning": {
"type": "string",
"description": "What the event means, per the FAA NAS Status user guide."
},
"eventType": {
"enum": [
"airport_closure",
"ground_stop",
"ground_delay_program",
"airspace_flow_program",
"arrival_delay",
"departure_delay",
"closure_notam",
"deicing"
],
"type": "string",
"description": "FAA traffic management event type."
},
"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."
}
},
"description": "One event type.",
"additionalProperties": false
},
"description": "Present for topic event_types, in severity order."
},
"identifiers": {
"type": "object",
"required": [
"airportDirectory",
"formats"
],
"properties": {
"formats": {
"type": "array",
"items": {
"type": "object",
"required": [
"identifier",
"format",
"example"
],
"properties": {
"format": {
"type": "string",
"description": "Accepted or returned form."
},
"example": {
"type": "string",
"description": "Example value."
},
"identifier": {
"type": "string",
"description": "What is identified."
}
},
"description": "One identifier format.",
"additionalProperties": false
},
"description": "Identifier and time formats the faa_delays tools accept and return."
},
"airportDirectory": {
"type": "object",
"required": [
"source",
"effectiveDate",
"airportCount"
],
"properties": {
"source": {
"type": "string",
"description": "FAA dataset the directory is built from."
},
"airportCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "US airports the directory lists."
},
"effectiveDate": {
"type": "string",
"description": "NASR cycle effective date, YYYY-MM-DD."
}
},
"description": "The bundled FAA NASR airport directory that validates airport codes. An identifier assigned after this cycle is rejected until the next refresh.",
"additionalProperties": false
}
},
"description": "Present for topic identifiers.",
"additionalProperties": false
},
"pacingAirports": {
"type": "array",
"items": {
"type": "object",
"required": [
"airportId"
],
"properties": {
"latitude": {
"type": "number",
"description": "Latitude in decimal degrees."
},
"timezone": {
"type": "string",
"description": "Effective IANA time zone; PHX reported as US/Mountain is corrected to America/Phoenix."
},
"airportId": {
"type": "string",
"description": "FAA 3-character identifier."
},
"longitude": {
"type": "number",
"description": "Longitude in decimal degrees."
},
"reportedTimezone": {
"type": "string",
"description": "Original FAA time zone when a verified correction was applied."
}
},
"description": "One pacing airport.",
"additionalProperties": false
},
"description": "Present for topic pacing_airports: the FAA pacing airports, read live and cached 6 h."
}
},
"additionalProperties": false
}faa_delays_list_reference annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}Prompts
0 advertised
Resources
1 advertised
faa-traffic-delays-guide
Gates and workflows for the faa_delays_* tools over FAA ground stops, delay programs, airport delays and closures, the operations plan, and ATCSCC advisories. Covers whether a program holds a given flight, reading a closure's scope and schedule, dating the operations plan, UTC date crossings, and finding revised, canceled, or past programs in the advisory index. Use when answering US flight-delay or airport-disruption questions.
faa-traffic-delays-guide URI
skill://faa-traffic-delays-guide/SKILL.mdio.modelcontextprotocol/skills
io.modelcontextprotocol/skills URI template
skill://{+path}90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 604 ms
- 95th percentile latency
- 604 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 604 ms · metadata changed · 6 tool(s), 1 resource(s), 1 resource template(s), 0 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http faa-traffic-delays-mcp-server-caseyjhand https://faa-traffic-delays.caseyjhand.com/mcpCodex
Codex configuration
codex mcp add faa-traffic-delays-mcp-server-caseyjhand --url https://faa-traffic-delays.caseyjhand.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"faa-traffic-delays-mcp-server-caseyjhand": {
"url": "https://faa-traffic-delays.caseyjhand.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"faa-traffic-delays-mcp-server-caseyjhand": {
"type": "streamableHttp",
"url": "https://faa-traffic-delays.caseyjhand.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"faa-traffic-delays-mcp-server-caseyjhand": {
"type": "http",
"url": "https://faa-traffic-delays.caseyjhand.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http faa-traffic-delays-mcp-server-caseyjhand https://faa-traffic-delays.caseyjhand.com/mcpClaude Desktop
Claude Desktop configuration
https://faa-traffic-delays.caseyjhand.com/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"faa-traffic-delays-mcp-server-caseyjhand": {
"serverUrl": "https://faa-traffic-delays.caseyjhand.com/mcp"
}
}
}Let your agent find its tools
Find servers like faa-traffic-delays-mcp-server from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.