# FlightDB MCP

Connect your AI assistant to [FlightDB](https://flightdb.org) — aircraft registry search, flight history, and analytics via the Model Context Protocol.

FlightDB aggregates flight data from **ADS-B Exchange**, one of the largest unfiltered ADS-B data sources, combined with official aircraft registry records. Unlike FlightRadar24, FlightAware, or Planefinder — which filter or suppress certain flights — FlightDB gives you unfiltered access to full flight histories with deep per-aircraft analytics you won't find elsewhere.

## Connect

```
https://flightdb.org/mcp
```

Add this URL as a custom MCP connector in Claude, Cursor, or any MCP-compatible client. Sign in with Google when prompted.

- Transport: Streamable HTTP
- Auth: Google OAuth (sign in once, stays authorized)
- Docs: [flightdb.org/mcp/connect](https://flightdb.org/mcp/connect)

## Tools

| Tool | Description |
|---|---|
| `Flight_list_flights` | Paginated flights with filters: aircraft, airport, country, date range |
| `Flight_list_aircraft` | Paginated aircraft directory with registration, country, ICAO filters |
| `Flight_get_aircraft_from_list` | Single aircraft header by id |
| `Flight_get_aircraft_detail` | Full aircraft profile with all flights and aggregates |
| `Flight_flights_by_year` | Per-year flight counts for an aircraft |
| `Flight_flights_by_distance` | Per-year flights binned by trip distance (Short / Medium / Long) |
| `Flight_flights_by_country` | Per-year arrival-country breakdown for an aircraft |
| `Flight_airport_visits` | Per-airport visit and stay aggregates by year |
| `Flight_visit_history` | Visit timeline for an aircraft |
| `Flight_get_airport` | Airport details by IATA or ICAO code |

## Example prompts

- *"How many flights did N12345 make in 2023?"*
- *"Which airports has G-ABCD visited most in the last 3 years?"*
- *"List all Airbus A320s registered in Indonesia"*
- *"What countries did this aircraft fly to last year?"*

## Setup — Claude

1. Go to [claude.ai/customize/connectors](https://claude.ai/customize/connectors)
2. Click **Add custom connector**
3. Name it **FlightDB** and paste `https://flightdb.org/mcp`
4. Save and sign in with Google when prompted

## Setup — Cursor / other MCP clients

Add to your MCP config:

```json
{
  "mcpServers": {
    "flightdb": {
      "url": "https://flightdb.org/mcp"
    }
  }
}
```