{"openapi":"3.0.3","info":{"title":"Gnist Context — AviationStack (Flight Status)","description":"Live flight tracking — departures, arrivals, delays, and airport status.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/aviationstack/`\n- **Toolkit page:** `/toolkits/aviationstack`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/aviationstack/get_flight_status":{"post":{"tags":["Transport"],"summary":"get_flight_status","description":"Get the current status of a flight by IATA flight number.\n\nArgs:\n    flight_iata: IATA flight number, e.g. \"BA123\" or \"SK451\".\n    date: Date in YYYY-MM-DD format. Defaults to today's flights.\n\nReturns:\n    List of matching flights with status, gate, delay, and times.\n    Requires AVIATIONSTACK_API_KEY to be configured.","operationId":"aviationstack_get_flight_status","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"flight_iata":{"description":"IATA flight number, e.g. \"BA123\" or \"SK451\".","type":"string"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date in YYYY-MM-DD format. Defaults to today's flights."}},"required":["flight_iata"],"type":"object"}}}}}},"/rest/aviationstack/search_flights":{"post":{"tags":["Transport"],"summary":"search_flights","description":"Search scheduled flights between two airports.\n\nArgs:\n    origin: Departure airport IATA code, e.g. \"OSL\" (Oslo) or \"LHR\" (London Heathrow).\n    destination: Arrival airport IATA code, e.g. \"JFK\" (New York).\n    date: Date in YYYY-MM-DD format. Defaults to today's flights.\n\nReturns:\n    List of scheduled flights with flight numbers, times, and status.\n    Requires AVIATIONSTACK_API_KEY to be configured.","operationId":"aviationstack_search_flights","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"origin":{"description":"Departure airport IATA code, e.g. \"OSL\" (Oslo) or \"LHR\" (London Heathrow).","type":"string"},"destination":{"description":"Arrival airport IATA code, e.g. \"JFK\" (New York).","type":"string"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date in YYYY-MM-DD format. Defaults to today's flights."}},"required":["origin","destination"],"type":"object"}}}}}},"/rest/aviationstack/get_airport_departures":{"post":{"tags":["Transport"],"summary":"get_airport_departures","description":"Get the live departure board for an airport.\n\nArgs:\n    airport_iata: Airport IATA code, e.g. \"OSL\" (Oslo Gardermoen) or \"AMS\" (Amsterdam Schiphol).\n    window_hours: Hours ahead to include (1–12, default 2).\n\nReturns:\n    List of upcoming departures with flight, destination, times, gate, and delay.\n    Requires AVIATIONSTACK_API_KEY to be configured.","operationId":"aviationstack_get_airport_departures","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"airport_iata":{"description":"Airport IATA code, e.g. \"OSL\" (Oslo Gardermoen) or \"AMS\" (Amsterdam Schiphol).","type":"string"},"window_hours":{"default":2,"description":"Hours ahead to include (1–12, default 2).","type":"integer"}},"required":["airport_iata"],"type":"object"}}}}}},"/rest/aviationstack/get_aircraft_position":{"post":{"tags":["Transport"],"summary":"get_aircraft_position","description":"Get the live ADS-B position of an aircraft by ICAO 24-bit transponder address.\n\nThe ICAO24 address is a 6-character hexadecimal string unique to each aircraft\n(e.g. \"400f86\" for a British Airways 777). It can be found on sites like\nFlightradar24 or OpenSky Explorer.\n\nArgs:\n    icao24: 6-character hex transponder address, e.g. \"400f86\".\n\nReturns:\n    Live position with latitude, longitude, altitude, speed, and heading.\n    Returns not_found: true if the aircraft is not currently transmitting.\n    Uses OpenSky Network (free, no API key required).","operationId":"aviationstack_get_aircraft_position","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"icao24":{"description":"6-character hex transponder address, e.g. \"400f86\".","type":"string"}},"required":["icao24"],"type":"object"}}}}}},"/rest/aviationstack/report_feedback":{"post":{"tags":["Transport"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"aviationstack_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Transport","description":"Data sources: Transport"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}