All Flights MCP

A federated Model Context Protocol server that searches multiple flight inventory sources concurrently and returns one normalized, deduplicated result set.

Providers

No provider guarantees complete global inventory. Configure more than one source for better coverage. Provider errors are isolated: one failed or slow source does not discard results from the others.

Related MCP server: Find Flights MCP Server

MCP tools

• list_providers: reports configured and unavailable providers.

• search_flights: searches providers concurrently, normalizes offers, and groups equivalent itineraries with provider-specific alternatives.

• search_date_range: scans up to 60 outbound-date/stay-length combinations.

• get_offer: retrieves a recent offer and its alternatives from the in-memory cache.

Quick start

Requires Node.js 22 or newer.

npm install
cp .env.example .env
npm run build
npm start

The server automatically loads .env. The default transport is stdio. Set MCP_TRANSPORT=http to expose stateless Streamable HTTP at http://127.0.0.1:3000/mcp. The HTTP server also exposes GET /health.

Local MCP client

{
  "mcpServers": {
    "all-flights": {
      "command": "node",
      "args": ["C:\\Repos\\all-flights-mcp\\dist\\index.js"],
      "env": {
        "ITA_MCP_URL": "https://your-ita-mcp.example/mcp",
        "ITA_MCP_BEARER_TOKEN": "${input:ita-token}",
        "DUFFEL_ACCESS_TOKEN": "${input:duffel-token}"
      }
    }
  }
}

Configuration

Copy .env.example and enable any providers for which you have access:

• ITA_MCP_URL and optional ITA_MCP_BEARER_TOKEN

• or ITA_MCP_COMMAND and optional ITA_MCP_ARGS_JSON for a local stdio server

• GOOGLE_FLIGHTS_MCP_URL or GOOGLE_FLIGHTS_MCP_COMMAND=fli-mcp

• DUFFEL_ACCESS_TOKEN

• SKYSCANNER_API_KEY plus market and locale

Skyscanner, Sabre, and Travelport generally require commercial approval. Credentials are never returned in tool output or written to disk by this server.

Additional MCP providers

UPSTREAM_MCP_PROVIDERS_JSON adds providers that expose a normalized search_flights tool compatible with this repository:

[
  {
    "id": "partner",
    "name": "Partner inventory",
    "url": "https://partner.example/mcp",
    "tokenEnv": "PARTNER_MCP_TOKEN",
    "toolName": "search_flights"
  }
]

tokenEnv names an environment variable; do not place secrets directly in the JSON configuration.

HTTP deployment

cp .env.example .env
# Edit .env and set MCP_TRANSPORT=http and MCP_BEARER_TOKEN.
docker compose up -d --build

When MCP_BEARER_TOKEN is set, /mcp requires Authorization: Bearer <token>. Use TLS in front of the container.

HomeAssistant OCI deployment

The repository includes the deployment used by HomeAssistant. It runs beside the existing ITA MCP container and a pinned Fli Google Flights container, publishes https://flights.159-54-184-44.sslip.io/mcp through Caddy, stores the bearer token in Azure Key Vault, and registers the server in the agent's MCP registry. The OCI Fli container uses the existing residential SOCKS tunnel because Google returns empty inventory from the datacenter address.

.\deploy-oci.ps1

Provider credentials can be added to /opt/n8n/all-flights-mcp.env before restarting the service. ITA is reached over the private Compose network.

Normalization and deduplication

Each offer retains its source, provider offer ID, total price, currency, segments, carriers, booking URL or booking-item links, and expiry. Equivalent itineraries are grouped by segment airports, times, carriers, and flight numbers. The cheapest alternative in the requested currency becomes the primary result; every provider alternative remains attached.

Prices are not currency-converted. ITA Matrix results are marked non-bookable because ITA does not return durable booking links. Always revalidate a selected offer before purchase. Google Flights support uses an unofficial reverse-engineered interface provided by Fli; it may change without notice.

Development

npm run check

The test suite uses Node's built-in test runner and does not call live provider APIs.