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 .

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

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:
• Issues: GitHub Issues
• API support:

License

MIT License — see LICENSE.