MCP ready

MCP Server, connect AI to live flight data

Integrate FlightLabs with Claude Desktop, ChatGPT or any MCP-compatible assistant. Query live flights, schedules, delays, prices, airlines, routes, and airports in your AI conversations.

Ask Claude:

"Where is flight AA217 right now?"

AI calls MCP tool:
{
"tool": "flights.realtime",
"params": {
"flightIata": "AA217"
}
}

What is MCP and why does it matter?

The Model Context Protocol (MCP) lets AI assistants access external data in real time. Instead of outdated training data, your AI can fetch live flight data from FlightLabs — just by asking a question.

Example: Ask Claude "Where is flight AA217 right now?" and it will call our flights.realtime tool automatically.

Real-time flights

Live positions, status, airline and airport filters via /flights.

Natural language

Ask questions like "Show American Airlines flights departing JFK" and get accurate answers.

Same API quota

MCP calls use your existing FlightLabs plan. Each AI request counts as one API call.

Available MCP tools

Ten tools mapped to core FlightLabs REST endpoints. Authenticate with OAuth or Authorization: Bearer — not a key in the URL.

flights.realtime Flights

Get real-time flight positions and status. Filter by flight IATA/ICAO, airline, departure or arrival airport, registration, and more. Maps to GET /flights.

Useful params: flightIata, airlineIata, depIata, arrIata, limit, and more.

flights.historical Flights

Historical departures or arrivals for an airport by date or date range. Maps to GET /historical.

Useful params: flightIata, airlineIata, depIata, arrIata, limit, and more.

flights.prices Flights

Search flight prices between airports (oneway or roundtrip). Maps to GET /retrieveFlights.

Useful params: flightIata, airlineIata, depIata, arrIata, limit, and more.

flights.delays Flights

Find delayed flights above a minimum delay threshold. Maps to GET /flight_delays.

Useful params: flightIata, airlineIata, depIata, arrIata, limit, and more.

flights.schedules Flights

Airport timetable of scheduled departures or arrivals. Maps to GET /advanced-flights-schedules.

Useful params: flightIata, airlineIata, depIata, arrIata, limit, and more.

flights.by_number Flights

Flight info by flight number (e.g. LH811), optionally for a date or range. Maps to GET /flight.

Useful params: flightIata, airlineIata, depIata, arrIata, limit, and more.

flights.by_airline Flights

Live flights operated by a given airline ICAO code. Maps to GET /flights-by-airline.

Useful params: flightIata, airlineIata, depIata, arrIata, limit, and more.

airlines.list Airlines

Airline directory with optional IATA or country filter. Maps to GET /airlines.

Useful params: flightIata, airlineIata, depIata, arrIata, limit, and more.

airlines.routes Airlines

Airline routes between airports, filterable by airline or flight. Maps to GET /routes.

Useful params: flightIata, airlineIata, depIata, arrIata, limit, and more.

airports.by_filter Airports

Look up airports by IATA, ICAO, city, or country code. Maps to GET /airports-by-filter.

Useful params: flightIata, airlineIata, depIata, arrIata, limit, and more.

Set up in one step

Paste this line into your AI agent (Claude Code, Cursor, Codex, Gemini CLI, VS Code or Windsurf). It reads the instructions, adds the FlightLabs server and checks that it works.

Paste into your agent

No API key and no Client ID needed: the agent adds the server and you sign in to FlightLabs once in the browser. You need a trial or paid account — start a free trial if you do not have one.

Using ChatGPT or the Claude app? They connect by signing in, with nothing to paste: see Claude and ChatGPT below.

MCP endpoint

Same URL for every client. Sign in with OAuth, or send Authorization: Bearer YOUR_ACCESS_KEY. Do not put the key in the URL — Claude Desktop and claude.ai reject tokens in the query string.

Connect to Claude

The steps are the same on claude.ai and in the Claude Desktop app. The connector is saved on your Claude account, so adding it in one place makes it appear in the other.

1. Add a custom connector

User menu → Settings → Customize → Connectors → Add custom connector. FlightLabs is not in the official connector directory.

2. Name and URL

Name: for example FlightLabs

Remote server URL: https://mcp.goflightlabs.com/mcp

Leave the OAuth client ID and secret empty. Claude registers itself.

3. Connect and sign in

Click Add, then Connect. Sign in to FlightLabs — or create an account (a trial or paid plan is required) — and click Authorize.

Connect with Claude Code

If you already added the connector on claude.ai or Claude Desktop with the same account, FlightLabs is already connected. Otherwise, add it from a terminal:

bash
claude mcp add --transport http --scope user flightlabs https://mcp.goflightlabs.com/mcp

Then open claude, type /mcp, choose flightlabs and pick Authenticate. Approve in the browser; back in the terminal the status becomes connected.

Use an access key instead of signing in
bash
claude mcp add --transport http --scope user flightlabs https://mcp.goflightlabs.com/mcp --header "Authorization: Bearer YOUR_ACCESS_KEY"

After setup, try: "Where is flight AA217 right now?"

Connect to Cursor

Add this to ~/.cursor/mcp.json (on Windows, %USERPROFILE%\.cursor\mcp.json; or .cursor/mcp.json inside a project). Keep any servers you already have.

mcp.json
{
  "mcpServers": {
    "flightlabs": {
      "url": "https://mcp.goflightlabs.com/mcp"
    }
  }
}

Then open Cursor Settings → MCP and click the login button next to flightlabs. Sign in to FlightLabs and approve; the server shows a green dot. There is no Client ID to enter.

Prefer the menus? In Cursor Settings, add a new MCP server and paste the URL https://mcp.goflightlabs.com/mcp.

Use an access key instead of signing in
mcp.json
{
  "mcpServers": {
    "flightlabs": {
      "url": "https://mcp.goflightlabs.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_KEY"
      }
    }
  }
}

After setup, try: "Look up flight BA179"

Connect to ChatGPT

ChatGPT connects by signing in to FlightLabs. You need a trial or paid account.

1. Add a custom connector

In ChatGPT, open Settings → Connectors and add a custom MCP connector.

Remote server URL: https://mcp.goflightlabs.com/mcp

Leave the OAuth client ID and secret empty. ChatGPT registers itself.

2. Sign in to FlightLabs

Connect, sign in on the FlightLabs screen and click Authorize.

3. Try it

“Where is flight AA217 right now?”

“Show American Airlines flights departing JFK”

“List live flights arriving at LAX”

Python: track a flight example

A complete Python example that fetches real-time data for flight AA217 using the MCP protocol.

get_flight_ba179.py
import httpx
import json
import asyncio

MCP_SERVER_URL = "https://mcp.goflightlabs.com/mcp"
ACCESS_KEY = "YOUR_ACCESS_KEY"

async def call_mcp_tool(tool_name: str, arguments: dict):
    async with httpx.AsyncClient(timeout=60) as client:
        init_response = await client.post(
            MCP_SERVER_URL,
            headers={"Authorization": f"Bearer {ACCESS_KEY}"},
            json={
                "jsonrpc": "2.0",
                "id": "1",
                "method": "initialize",
                "params": {
                    "protocolVersion": "2024-11-05",
                    "capabilities": {},
                    "clientInfo": {"name": "PythonClient"}
                }
            }
        )
        session_id = init_response.headers.get("Mcp-Session-Id")

        response = await client.post(
            MCP_SERVER_URL,
            headers={"Mcp-Session-Id": session_id, "Authorization": f"Bearer {ACCESS_KEY}"},
            json={
                "jsonrpc": "2.0",
                "id": "2",
                "method": "tools/call",
                "params": {
                    "name": tool_name,
                    "arguments": arguments
                }
            }
        )
        return response.json()

async def main():
    result = await call_mcp_tool(
        "flights.realtime",
        {"flightIata": "AA217"}
    )
    print(json.dumps(result, indent=2))

asyncio.run(main())

Frequently asked questions

Sign in with OAuth — your client registers itself, so there is no Client ID or secret to enter — or send Authorization: Bearer YOUR_ACCESS_KEY. Do not put the key in the MCP URL — Claude Desktop and claude.ai strip query tokens. Start a free trial first.
MCP requests count toward your existing API quota just like REST API calls. Each tool call equals one API request. Check our pricing page for plan details.
Ten tools cover real-time flights, historical data, prices, delays, schedules, flight-by-number, flights-by-airline, airlines, routes, and airports-by-filter. See Available Tools above for the full list and REST mappings.
Yes! Any platform that supports the Model Context Protocol (MCP) specification can connect to our server. This includes Claude Desktop, custom Python clients, ChatGPT connectors, and any future MCP-compatible platforms.