Transport
Data source: OpenSky Network API
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/opensky/
claude_desktop_config.json
{
"mcpServers": {
"gnist-opensky": {
"url": "https://context.gnist.ai/mcp/opensky/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/opensky/" \
-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_track", "arguments": {"icao24": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/opensky/
4 endpoints available:
GET /rest/opensky/get_aircraft_statesGET /rest/opensky/get_flight_trackGET /rest/opensky/search_aircraftGET /rest/opensky/report_feedback
Shell
curl "https://context.gnist.ai/rest/opensky/get_flight_track?icao24=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/opensky/get_flight_track",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"icao24": "example"
},
)
print(resp.json())
Command Line
Command
gc opensky
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (4)
get_aircraft_statesGet live aircraft positions from the OpenSky Network.
| Parameter | Type | Required | Description |
|---|---|---|---|
lamin | any | optional | Lower latitude bound (WGS-84 degrees, e.g. 45.0). All four bbox params required together. |
lamax | any | optional | Upper latitude bound (e.g. 50.0). |
lomin | any | optional | Lower longitude bound (e.g. -5.0). |
lomax | any | optional | Upper longitude bound (e.g. 5.0). |
icao24 | any | optional | ICAO24 hex addresses to filter (e.g. ["3c6444", "a1b2c3"]). Max 10. |
limit | integer | optional | Maximum aircraft to return (1-2000, default 200). (default: 200) |
get_flight_trackGet the flight trajectory (waypoints) for an aircraft.
| Parameter | Type | Required | Description |
|---|---|---|---|
icao24 | string | required | ICAO24 hex address of the aircraft (e.g. "3c6444"). Use search_aircraft to find addresses. |
time_value | integer | optional | Unix timestamp within the flight. Use 0 for current/live track. (default: 0) |
search_aircraftSearch for a specific aircraft by ICAO24 address or callsign.
| Parameter | Type | Required | Description |
|---|---|---|---|
icao24 | any | optional | ICAO24 hex address to look up (e.g. "3c6444"). Directly queries the aircraft. |
callsign | any | optional | Callsign to search for (e.g. "DLH9MT", "RYR1234"). Requires bounding box. |
lamin | any | optional | Lower latitude bound (required for callsign search). |
lamax | any | optional | Upper latitude bound. |
lomin | any | optional | Lower longitude bound. |
lomax | any | optional | Upper longitude bound. |
limit | integer | optional | Maximum results (1-200, default 50). (default: 50) |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |