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.
"Where is flight AA217 right now?"
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.
Live positions, status, airline and airport filters via /flights.
Ask questions like "Show American Airlines flights departing JFK" and get accurate answers.
MCP calls use your existing FlightLabs plan. Each AI request counts as one API call.
Ten tools mapped to core FlightLabs REST endpoints. Authenticate with OAuth or Authorization: Bearer — not a key in the URL.
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.
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.
Search flight prices between airports (oneway or roundtrip). Maps to GET /retrieveFlights.
Useful params: flightIata, airlineIata, depIata, arrIata, limit, and more.
Find delayed flights above a minimum delay threshold. Maps to GET /flight_delays.
Useful params: flightIata, airlineIata, depIata, arrIata, limit, and more.
Airport timetable of scheduled departures or arrivals. Maps to GET /advanced-flights-schedules.
Useful params: flightIata, airlineIata, depIata, arrIata, limit, and more.
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.
Live flights operated by a given airline ICAO code. Maps to GET /flights-by-airline.
Useful params: flightIata, airlineIata, depIata, arrIata, limit, and more.
Airline directory with optional IATA or country filter. Maps to GET /airlines.
Useful params: flightIata, airlineIata, depIata, arrIata, limit, and more.
Airline routes between airports, filterable by airline or flight. Maps to GET /routes.
Useful params: flightIata, airlineIata, depIata, arrIata, limit, and more.
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.
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.
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.
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.
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.
User menu → Settings → Customize → Connectors → Add custom connector. FlightLabs is not in the official connector directory.
Name: for example FlightLabs
Remote server URL: https://mcp.goflightlabs.com/mcp
Leave the OAuth client ID and secret empty. Claude registers itself.
Click Add, then Connect. Sign in to FlightLabs — or create an account (a trial or paid plan is required) — and click Authorize.
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:
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.
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?"
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.
{
"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.
{
"mcpServers": {
"flightlabs": {
"url": "https://mcp.goflightlabs.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_ACCESS_KEY"
}
}
}
}
After setup, try: "Look up flight BA179"
ChatGPT connects by signing in to FlightLabs. You need a trial or paid account.
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.
Connect, sign in on the FlightLabs screen and click Authorize.
“Where is flight AA217 right now?”
“Show American Airlines flights departing JFK”
“List live flights arriving at LAX”
A complete Python example that fetches real-time data for flight AA217 using the MCP protocol.
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())
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.