Transport

Data source: Amadeus GDS

MCP MCP Protocol

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

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

claude_desktop_config.json

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

Shell

curl -X POST "https://context.gnist.ai/mcp/flights/" \
  -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": "search_flights", "arguments": {"origin": "example", "destination": "example", "departure_date": "example"}}}'

API REST API

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

7 endpoints available:

GET /rest/flights/search_flights
GET /rest/flights/search_award_flights
GET /rest/flights/list_flight_sources
GET /rest/flights/sas_awards_search
GET /rest/flights/sas_awards_list_destinations
GET /rest/flights/sas_awards_get_config
GET /rest/flights/report_feedback

Shell

curl "https://context.gnist.ai/rest/flights/search_flights?origin=example&destination=example&departure_date=example" \
  -H "Gnist-API-Key: YOUR_API_KEY"

Python

import httpx

resp = httpx.get(
    "https://context.gnist.ai/rest/flights/search_flights",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    params={
        "origin": "example",
        "destination": "example",
        "departure_date": "example"
},
)
print(resp.json())

OpenAPI Spec · Full API Docs

CLI Command Line

Command gc flights

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

Install

pip install gnistai

Available Tools (7)

search_flights

Search for flights across multiple data sources.

Parameter	Type	Required	Description
`origin`	`string`	required	Origin IATA airport code (e.g. 'OSL').
`destination`	`string`	required	Destination IATA airport code (e.g. 'JFK').
`departure_date`	`string`	required	Departure date (YYYY-MM-DD).
`return_date`	`any`	optional	Return date for round-trip (YYYY-MM-DD). Omit for one-way.
`adults`	`integer`	optional	Number of adult passengers. (default: 1)
`cabin_class`	`any`	optional	Cabin class: economy, premium_economy, business, or first.
`mode`	`string`	optional	Search mode: 'revenue' (paid flights), 'award' (points/miles), or 'all'. (default: "all")
`max_results`	`integer`	optional	Maximum number of results to return. (default: 20)

search_award_flights

Search specifically for award flights (points/miles redemptions).

Parameter	Type	Required	Description
`origin`	`string`	required	Origin IATA airport code (e.g. 'OSL').
`destination`	`string`	required	Destination IATA airport code (e.g. 'JFK').
`departure_date`	`string`	required	Departure date (YYYY-MM-DD).
`return_date`	`any`	optional	Return date for round-trip (YYYY-MM-DD). Omit for one-way.
`adults`	`integer`	optional	Number of adult passengers. (default: 1)
`cabin_class`	`any`	optional	Cabin class: economy, premium_economy, business, or first.
`max_results`	`integer`	optional	Maximum number of results to return. (default: 10)

list_flight_sources

List all registered flight data sources and their status.

sas_awards_search

Search for SAS EuroBonus award seat availability on routes from Oslo to North America.

Parameter	Type	Required	Description
`destinations`	`any`	optional	IATA codes to check (e.g. ['MIA', 'LAX']). Omit to check all 11 configured destinations.
`passengers`	`integer`	optional	Number of seats required on both legs. (default: 3)
`min_stay_days`	`integer`	optional	Minimum stay duration in days. (default: 2)
`max_stay_days`	`integer`	optional	Maximum stay duration in days. (default: 10)
`priority_only`	`boolean`	optional	Return only results for priority destinations (MIA, LAX). (default: false)