Transport

Data source: AviationStack, OpenSky Network

MCP MCP Protocol

Endpoint https://context.gnist.ai/mcp/aviationstack/

nobloat — strip report_feedback tool URL-based auth (for clients without header support)

claude_desktop_config.json

{
  "mcpServers": {
    "gnist-aviationstack": {
      "url": "https://context.gnist.ai/mcp/aviationstack/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Shell

curl -X POST "https://context.gnist.ai/mcp/aviationstack/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_flight_status", "arguments": {"flight_iata": "example"}}}'

API REST API

API Root https://context.gnist.ai/rest/aviationstack/

5 endpoints available:

GET /rest/aviationstack/get_flight_status
GET /rest/aviationstack/search_flights
GET /rest/aviationstack/get_airport_departures
GET /rest/aviationstack/get_aircraft_position
GET /rest/aviationstack/report_feedback

Shell

curl "https://context.gnist.ai/rest/aviationstack/get_flight_status?flight_iata=example" \
  -H "Gnist-API-Key: YOUR_API_KEY"

Python

import httpx

resp = httpx.get(
    "https://context.gnist.ai/rest/aviationstack/get_flight_status",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    params={
        "flight_iata": "example"
},
)
print(resp.json())

OpenAPI Spec · Full API Docs

CLI Command Line

Command gc aviationstack

CLI documentation will be available when the GnistAI SDK is published.

Install

pip install gnistai

Available Tools (5)

get_flight_status

Get the current status of a flight by IATA flight number.

Parameter	Type	Required	Description
`flight_iata`	`string`	required	IATA flight number, e.g. "BA123" or "SK451".
`date`	`any`	optional	Date in YYYY-MM-DD format. Defaults to today's flights.

search_flights

Search scheduled flights between two airports.

Parameter	Type	Required	Description
`origin`	`string`	required	Departure airport IATA code, e.g. "OSL" (Oslo) or "LHR" (London Heathrow).
`destination`	`string`	required	Arrival airport IATA code, e.g. "JFK" (New York).
`date`	`any`	optional	Date in YYYY-MM-DD format. Defaults to today's flights.

get_airport_departures

Get the live departure board for an airport.

Parameter	Type	Required	Description
`airport_iata`	`string`	required	Airport IATA code, e.g. "OSL" (Oslo Gardermoen) or "AMS" (Amsterdam Schiphol).
`window_hours`	`integer`	optional	Hours ahead to include (1–12, default 2). (default: 2)