AirLabs MCP Server

AirLabs MCP Server

This Model Context Protocol (MCP) server provides access to the AirLabs aviation data API. It lets AI assistants such as Claude Desktop and Cursor access real-time flight data, airport schedules, delays, and reference databases for airlines, airports, aircraft fleets and routes — directly through natural-language questions.

The entire server lives in a single file (index.ts): tool definitions, the AirLabs HTTP client, request handling and the stdio transport.

Features

• Live flight status — look up any flight by number and get status, gate, terminal and delay.
• Airport schedules — departures and arrivals boards for any airport.
• Delay monitoring — find flights delayed beyond a threshold at an airport or airline.
• Real-time positions — live aircraft coordinates, altitude, speed and heading by area, airline or registration.
• Nearest airport — closest airports to any coordinate.
• Reference databases — airlines, airports, aircraft fleets (by tail number or ICAO24 hex) and route networks.
• Code resolution — turn a place or airline name into its IATA/ICAO code.

Prerequisites

1. Node.js 18.0.0 or higher.
2. AirLabs API key — get a free key at https://airlabs.co/signup.

Installation

Via npm

npm install -g @airlabs-co/airlabs-mcp

Configuration

Claude Desktop Integration

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "airlabs": {
      "command": "npx",
      "args": ["@airlabs-co/airlabs-mcp@latest"],
      "env": {
        "AIRLABS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Notes:

• Replace your_api_key_here with your actual AirLabs API key.
• Restart Claude Desktop after editing the config.
• If you build from source locally, use "command": "node", "args": ["/path/to/build/index.js"].

Other MCP Clients

Run the server directly over stdio:

AIRLABS_API_KEY=your_api_key_here npx @airlabs/airlabs-mcp

Available Tools

Tool	AirLabs endpoint	Purpose
get_flight_status	/flight	Live status of one flight by IATA/ICAO number
get_airport_schedule	/schedules	Departures / arrivals board for an airport
monitor_delays	/delays	Flights delayed beyond a threshold
track_live_flights	/flights	Live aircraft positions by area, airline or registration
find_nearest_airport	/nearby	Closest airports to a coordinate
search_airport_code	/suggest	Resolve a name to an IATA/ICAO code
get_airline_info	/airlines	Airline details by code
get_airport_info	/airports	Airport details by code
lookup_aircraft	/fleets	Aircraft by registration or ICAO24 hex
find_routes	/routes	Which airlines fly a given route

All tools accept an optional _fields parameter (where the endpoint supports it) to return only selected fields and keep responses compact.

Usage Examples

Once configured, just ask your assistant:

• "Is flight BA117 on time?" → get_flight_status
• "What flights are leaving JFK today?" → get_airport_schedule
• "Are arrivals delayed at LAX by more than 30 minutes?" → monitor_delays
• "Show me planes flying over New York." → track_live_flights
• "What aircraft is registration N790AN?" → lookup_aircraft
• "Which airlines fly from London to Tokyo?" → find_routes

Development

Building from source

git clone https://github.com/airlabs-co/airlabs-mcp.git
cd airlabs-mcp
npm install
npm run build

Contributing

1. Fork the repository.
2. Create a feature branch.
3. Make your changes.
4. Submit a pull request.

Support

• Documentation: https://airlabs.co/docs
• Issues: GitHub Issues
• API support: https://airlabs.co/faq#Contact

License

MIT License — see LICENSE.