@pipeworx/aviationstack

Connect: https://pipeworx.io/mcp — every tool in the catalog, including @pipeworx/aviationstack’s. Install: one-click buttons

No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.

Tools: 0

Aviationstack MCP — global flight tracking + airport / airline / route reference data.

Tools

• flights(flight_iata?, flight_icao?, dep_iata?, arr_iata?, airline_iata?, flight_status?, limit?, offset?) — real-time + scheduled flights
• airports(search?, iata_code?, icao_code?, limit?, offset?) — airport database (~10k airports)
• airlines(search?, iata_code?, icao_code?, limit?, offset?) — airline database
• cities(search?, iata_code?, country_iso2?, limit?) — city → primary airport mapping
• countries(search?, country_iso2?, limit?) — country reference
• routes(dep_iata?, arr_iata?, airline_iata?, flight_number?, limit?) — scheduled routes
• aviationstack_future_flights(iataCode, type, date, airline_iata?, airline_icao?, flight_number?, limit?, offset?) — scheduled future flights at one airport for a specific date (type: departure or arrival). Backed by Aviationstack’s /flightsFuture endpoint, which apilayer’s 2026-10-06 notice opened only for the next 7 days — date must be tomorrow..today+7 (UTC); the pack refuses out-of-window dates itself before calling upstream (fleet #2700).

Auth

• Platform key: gateway env PLATFORM_AVIATIONSTACK_KEY
• BYO: ?_apiKey=<key> after registering at https://aviationstack.com/signup/free

Plan tier

As of 2026-10-06 the shared platform key is on a plan that reaches flights, airports, airlines, cities, countries and routes live (verified: airports/JFK and routes/JFK→LAX both returned non-empty data — neither is free-tier-only any more; an earlier version of this README, written 2026-08-28, said otherwise and was stale). aviationstack_future_flights was added the same day the vendor emailed that they opened /flightsFuture more broadly; whether our specific plan reaches that endpoint was not independently confirmed before this tool shipped (the platform key’s raw value is a Cloudflare/Supabase secret, not available to a pack-authoring session) — if a live call answers HTTP 403 function_access_restricted, that means the plan doesn’t cover this endpoint yet and is a money/plan decision, not a pack bug.

The free plan (if the platform key ever reverts to it) is capped at 100 requests per month, and once that is spent every endpoint answers 429 — including ones the tier would otherwise allow. Free plan is also HTTP-only (no https) — the pack already uses http://.

Reading a 429 here: Aviationstack labels the monthly-allowance refusal with the code rate_limit_reached and only says “monthly” in the message text, so the code name argues for a burst limit that clears in seconds when the truth is a wall that lasts until the plan renews. The pack branches on the message, not the code. Fleet #577.

Data source

http://api.aviationstack.com/v1/ — access_key query param. /flightsFuture spec: https://api.swaggerhub.com/apis/apilayer-863/AviationstackAPI/1.0.0/swagger.json