pipeworx-io/mcp-aviationstack

Aviationstack MCP — global flight tracking + airport / airline / route reference data.
Part of Pipeworx — an MCP gateway connecting AI agents to 1863+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.
## Tools
flights(flightiata?, flighticao?, depiata?, arriata?, airlineiata?, flightstatus?, limit?, offset?) — real-time + scheduled flights
airports(search?, iatacode?, icaocode?, limit?, offset?) — airport database (~10k airports)
airlines(search?, iatacode?, icaocode?, limit?, offset?) — airline database
cities(search?, iatacode?, countryiso2?, limit?) — city → primary airport mapping
countries(search?, countryiso2?, limit?) — country reference
routes(depiata?, arriata?, airlineiata?, flightnumber?, limit?) — scheduled routes
aviationstackfutureflights(iataCode, type, date, airlineiata?, airlineicao?, flightnumber?, 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 PLATFORMAVIATIONSTACKKEY
BYO: ?apiKey= 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).
aviationstackfutureflights 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 functionaccessrestricted, 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
ratelimitreached 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/ — accesskey query param. /flightsFuture spec:
https://api.swaggerhub.com/apis/apilayer-863/AviationstackAPI/1.0.0/swagger.json
## Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
json
"mcpServers": {
"aviationstack": {
"url": "https://gateway.pipeworx.io/aviationstack/mcp"