# AeroDataBox MCP > AeroDataBox provides access to global aviation data through your AI agent. Get real-time flight tracking, current airport departures and arrivals (FIDS), historical delay statistics, and detailed information on aircraft fleets and runway operations. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** flight-tracking, airport-fids, aviation-data, flight-history, airport-delays ## Description Use this MCP to pull massive amounts of global aviation data using natural language instructions. You can ask your agent for the nearest flight status or check what's happening at a major hub right now, pulling current arrivals and departures. Need to analyze how bad the delays were last month? You can look up historical airport performance across specific date ranges or even compare delay statistics year over year. It handles everything from simple real-time queries to complex statistical deep dives on things like route frequencies or aircraft types. Connecting this via Vinkius means you get immediate access to this entire dataset, letting your agent handle the heavy lifting so you don't have to manually export spreadsheets. ## Tools ### get_global_delays Retrieves current global operational delay statistics. ### get_alert_subscription Gets specific details about an existing flight alert subscription. ### convert_alert_subscription Changes an old style of flight alert subscription to the current credit-based system. ### create_flight_alert Sets up a new webhook subscription that triggers when a specific flight event occurs. ### delete_alert_subscription Removes an existing flight alert webhook subscription entirely. ### get_airline_fleet Fetches a list of currently active aircraft types used by a specified airline. ### get_airport_delays_historical Retrieves historical airport delay statistics for an entire day. ### get_airport_delays_period Gathers historical airport delay data covering a specific date range. ### get_flight_history Searches and returns detailed records of past or scheduled flight movements based on identifying codes. ### get_global_delays_historical Retrieves historical data showing global delay patterns over time. ### get_nearest_flight Provides the current real-time status for a flight that is closest to a specified location using its number. ### list_alert_subscriptions Shows all active flight alert webhook subscriptions linked to your account. ### refill_alert_balance Adds credit balance to the account used for flight alerts. ### get_airport_delays Checks the current operational delay statistics at a specific airport. ### get_airport_routes_stats Calculates and returns statistical data on how often certain routes are used at an airport. ### get_airport_runways Gets detailed technical specifications and operational details for the runways at a given airport. ### get_airports_by_ip Identifies the closest airports to your current geographical location using an IP address lookup. ### get_alert_balance Checks the remaining credit balance for flight alerts. ### get_distance_time Calculates the straight-line distance and estimated travel time between two different airports. ### get_fids_absolute Retrieves a full list of scheduled departures and arrivals at an airport for an exact start and end date/time. ### get_fids_relative Gets the schedule board data (FIDS) showing departures and arrivals within a relative time frame (e.g., next 3 hours). ### get_flight_by_date Checks the general flight status for a specific date, regardless of current real-time location. ### get_flight_delays Provides historical data on punctuality specifically for one given flight number. ## Prompt Examples **Prompt:** ``` Get the real-time status of flight AA100. ``` **Response:** ``` I will query the real-time status for flight AA100 using the `get_nearest_flight` tool. Let me fetch the current departure, arrival, and aircraft details for you. ``` **Prompt:** ``` Show me the departures and arrivals at EGLL for the next 6 hours. ``` **Response:** ``` I will retrieve the flight information display (FIDS) for London Heathrow (EGLL) using the `get_fids_relative` tool with a duration of 360 minutes. Here are the scheduled flights... ``` **Prompt:** ``` What are the current delays at JFK airport? ``` **Response:** ``` I will check the current operational delays at John F. Kennedy International Airport (KJFK) using the `get_airport_delays` tool to provide you with statistical insights. ``` ## Capabilities ### Track live flight status Find out the current location and schedule details for a specific nearby flight number. ### Get airport schedules (FIDS) Retrieve lists of expected arrivals and departures at an airport, filtering by absolute or relative time frames. ### Analyze historical delays Look up operational performance metrics for airports or global flight paths over specified periods or single dates. ### Search past flight movements Gather detailed records of flights that have already flown, searchable by callsign, registration, or date. ### Determine airport physical details Access specific operational information like runway configurations and statistical route frequency data for any major airport. ## Use Cases ### Airlines needing rapid incident response An agent detects an unusual cluster of late flights. The user asks it to 'What were the average delays at LAX over the last two weeks?' The agent uses get_airport_delays_period and presents a summary, allowing the ops team to immediately identify systemic issues. ### Travel agents planning complex itineraries The user asks for travel options between three cities. The agent first calls get_distance_time to calculate optimal travel windows, then uses get_nearest_flight to verify the current status of connecting legs. ### Developers building smart airport assistants The system needs a daily dashboard update. It automatically triggers a call to get_fids_relative for the next 4 hours at the local hub, ensuring the information is fresh and ready when staff arrive. ### Financial analysts tracking economic activity The analyst needs proof of traffic volume. They ask the agent to compile all historical flight movements (using get_flight_history) for a specific month, providing data points for market analysis. ## Benefits - Stop checking multiple websites for delays. Use get_airport_delays to pull current operational status at any major hub directly into your agent's response. - Need flight schedules? Instead of browsing an airport website, use get_fids_relative or get_fids_absolute to pull precise departure and arrival lists for a specific time window. - Analyzing performance doesn't mean manual exports. Run historical reports using get_airport_delays_period or get_global_delays_historical to build trend data instantly. - Go beyond simple tracking. Use get_airport_routes_stats or get_airline_fleet to understand the underlying operational capacity and types of traffic an airport handles. - It saves time on routine checks. Use get_nearest_flight to check status without knowing the exact coordinates, just by providing a flight number. ## How It Works The bottom line is that your agent handles complex API calls, so you just talk about flights and get accurate data back. 1. Subscribe to this MCP and input your unique AeroDataBox API key. 2. Tell your AI client exactly what aviation data you need, like 'Show me all departures at JFK in the next three hours.' 3. The agent calls the necessary tool, retrieves the structured flight information, and presents it directly to you. ## Frequently Asked Questions **Can AeroDataBox give me the real-time status of a flight using get_nearest_flight?** Yes, get_nearest_flight checks the current operational status for any nearby flight number. It provides the up-to-the-minute details on departure and arrival times. **How do I check historical airport delays with AeroDataBox?** You use get_airport_delays_historical or get_airport_delays_period. These tools let you pull performance data for a full day or an entire range of days. **What is the difference between get_fids_absolute and get_fids_relative?** get_fids_absolute requires you to provide exact start and end times, while get_fids_relative lets you check departures and arrivals within a timeframe like 'the next four hours'. **How can I find out what aircraft an airline operates?** You use the get_airline_fleet tool. Just provide the airline's name, and it returns a list of currently active aircraft types they run. **Does AeroDataBox help me plan routes between airports?** Yes, you can use get_distance_time to calculate both the physical distance and the estimated travel time connecting any two major airports.