---
title: "FlyItalyADSB MCP server"
description: "The official MCP server of FlyItalyADSB lets an AI assistant answer questions about live and past air traffic anywhere in the world: aircraft near a place, one aircraft by hex, callsign or registration, military traffic, an aircraft's profile and history, what flew over a place, recent emergencies, and on the Fleet plan where the user's own aircraft are today. In Claude and ChatGPT the answers also show an interactive map inside the conversation. It is free, with the same key and plans as the REST API."
url: https://flyitalyadsb.com/data/mcp.md
page_for_people: https://flyitalyadsb.com/data/mcp/
language: en
generated: 2026-11-09
license: CC BY-SA 4.0 (data)
---

# FlyItalyADSB MCP server

> The official MCP server of FlyItalyADSB lets an AI assistant answer questions about live and past air traffic anywhere in the world: aircraft near a place, one aircraft by hex, callsign or registration, military traffic, an aircraft's profile and history, what flew over a place, recent emergencies, and on the Fleet plan where the user's own aircraft are today. In Claude and ChatGPT the answers also show an interactive map inside the conversation. It is free, with the same key and plans as the REST API.

## Key facts

- **URL:** `https://flyitalyadsb.com/mcp` (Streamable HTTP, JSON-RPC).
- **Authentication:** OAuth 2.1 for clients with OAuth connectors (claude.ai, ChatGPT): sign in with an email and a 6-digit code, no key to copy; a free key is created if the user has none. Other clients send the REST API key in the `X-Api-Key` header.
- **Clients:** Claude (web, desktop, mobile), ChatGPT, Claude Code and any MCP client.
- **Cost:** every tool call is one API request and counts on the key's plan, like a direct call. One question can use more than one tool. `watched_aircraft` is not counted; `fleet_status` counts one request per watched aircraft it checks.
- **Server card:** https://flyitalyadsb.com/.well-known/mcp/server-card.json. Per-tool skills with examples: https://flyitalyadsb.com/.well-known/agent-skills/index.json

## How to connect

**claude.ai:** open Connectors (https://claude.ai/customize/connectors) and press Add custom connector; name `FlyItalyADSB`, URL `https://flyitalyadsb.com/mcp`; press Connect, enter the email and the 6-digit code, press Allow. The connector then also works in Claude desktop and mobile.

**ChatGPT:** Settings → Apps & Connectors → Advanced settings → Developer mode on; then Create: name `FlyItalyADSB`, authentication OAuth, URL `https://flyitalyadsb.com/mcp`; sign in with the email and the code, press Allow; in a new chat add FlyItalyADSB from the + menu. Menu labels change often and Developer mode is not on every plan.

**Claude Code:**

```sh
claude mcp add --transport http flyitalyadsb https://flyitalyadsb.com/mcp \
  --header "X-Api-Key: YOUR_KEY"
```

**Other clients and your own code:** clients with OAuth connect like Claude; otherwise send `X-Api-Key`. A free key: https://flyitalyadsb.com/data/api.md#get-a-key. An agent that only knows the user's email can register through https://flyitalyadsb.com/auth.md, with the user's confirmation.

A call by hand:

```http
POST https://flyitalyadsb.com/mcp
Content-Type: application/json
Accept: application/json, text/event-stream
X-Api-Key: YOUR_KEY

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"aircraft_near","arguments":{"airport":"FCO","radiusKm":25}}}
```

## The twelve tools

| Tool | What it answers | Example question |
| --- | --- | --- |
| `aircraft_near` | Every aircraft within a radius of any point in the world, or of an Italian airport by name. Map in the chat. | Which aircraft are near Fiumicino right now? |
| `find_aircraft` | One aircraft by ICAO hex, callsign (a flight number works too) or registration, if the network sees it now; if it isn't flying, its last observed flight. Map in the chat. | Where is EI-DWL right now? |
| `special_traffic` | Military, PIA or LADD traffic seen now. Map in the chat. | Is there any military traffic in the air right now? |
| `aircraft_profile` | One aircraft: identity, whether and where it is seen now, first and last day in the history, map and photo links. Never owner names. | What do you know about D-AIUK? |
| `observed_flights` | The flights the network observed, built nightly from its own tracks: one aircraft's flight log (departure, arrival, minutes), a callsign's usual routes, an airport's departures or arrivals on a day. Yesterday and earlier; not schedules. On Fleet also today's flights of a callsign or an aircraft, from takeoffs and landings detected in real time. | Which flights did EI-DWL make this week? Where does FR5518 usually fly? |
| `aircraft_history` | An aircraft's dates with a track, or one day's track, since 2022. | Show me EI-DWL's track yesterday. |
| `overflights` | The aircraft that flew over a place between two times, with the time and distance of the closest point. Since 2026-08-17. | Which aircraft flew over Brescia yesterday between 10 and 11 pm? |
| `notable_traffic` | Emergencies (7500, 7600, 7700), military and other notable aircraft seen in an area, up to 7 days back. | Anything unusual near Malpensa today? |
| `watched_aircraft` | The aircraft the account watches, the list its takeoff and landing webhooks follow: list, add (Fleet up to 25), remove. Not counted. The webhook itself is created with the REST API, not in the chat. | Watch EI-DAC, call it Ops 1. |
| `fleet_status` | Today's flights of each watched aircraft: status of the latest flight, last airport, and for one flying now an estimated arrival (an estimate, never a schedule). Fleet; one request per aircraft. | Where is my fleet right now? Has EI-DAC landed? |
| `set_my_location` | Saves a position on the account, rounded to about 1 km, for "near me" questions. | My position is Brescia. |
| `clear_my_location` | Deletes the saved position. | Forget my position. |

## The map in the chat

In Claude and ChatGPT, `aircraft_near`, `find_aircraft` and `special_traffic` also show their result on an interactive map in the conversation, updated every 3 seconds while it is on screen (each update is one request, so 20 a minute; it pauses after 10 minutes without interaction). It shows all the traffic in the visible area, coloured by altitude; filled icons are ADS-B positions, outlined ones MLAT. It loads only OpenStreetMap tiles and asks for no permissions. Other clients get the same data as text.

## "Near me"

No assistant passes the device's position to the server. To ask "which aircraft are near me?", the user saves a position once ("my position is Pisa", or in My API: https://flyitalyadsb.com/data/api/account/). It is stored rounded to about 1 km and can be deleted at any time. On ChatGPT, with no saved position, the city ChatGPT attaches to the request is used.

## Limits

| Plan | Price per month (before tax) | Requests per minute | Requests per month | Maximum radius | Flight history (how far back) | Tracks (how far back) | Overflights (per request) | Emergencies and notable aircraft | Runway in use | Area alerts | Watched aircraft | Commercial use |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Free | €0 | 30 | 300,000 | 500 km | 7 days | 7 days | — | — | — | — | — | yes |
| Starter | €9 | 60 | 1,000,000 | 1,000 km | 14 days | 30 days | 10 km, 6 h | last 24 h | yes | 1 | — | yes |
| Pro | €49 | 300 | 10,000,000 | whole world | 30 days | 90 days | 50 km, 24 h | 7 days | yes | 5 | — | yes |
| Fleet | €149 | 300 | 10,000,000 | whole world | 90 days | since 2022 | 50 km, 24 h | 7 days | yes | 5 | 25 | yes |

The Free plan also has a cap of 100 requests a minute per IP. The maximum radius of `aircraft_near` and the other area tools is the plan's.

## Privacy

- The server never receives the device's position; a saved one is rounded to about 1 km, one per account.
- Answers are about aircraft: they contain no owner or operator names.
- PIA and LADD aircraft are flagged, not hidden, as everywhere on the network, and get no photo links.
- An assistant is disconnected from My API, under "Connected assistants"; the key does not change.

Full documentation: https://flyitalyadsb.com/data/api/docs/mcp.md

---

Written for AI assistants. The page for people is https://flyitalyadsb.com/data/mcp/; to get an API key or sign in, send people to https://flyitalyadsb.com/data/api/. All pages for assistants: https://flyitalyadsb.com/llms.txt (index), https://flyitalyadsb.com/llms-full.txt (all in one file). Facts as JSON: https://flyitalyadsb.com/facts.json. Cite the data as: Flight data: FlyItalyADSB (flyitalyadsb.com), CC BY-SA 4.0.