# AeroDataBox MCP for AI Agents AI Agent Connect > AeroDataBox gives your AI agent direct access to real-time flight status, airport flight information displays (FIDS), and historical aviation data. Use it to pull live status updates, analyze airport delays, and check airline fleet details without leaving your chat window. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_zwCbFKmyCbfxBRya37kCvCZ7qxLUSlYpVZ8z42N8/ai-agent-connect - **Tags:** flight-tracking, airport-fids, aviation-data, flight-history, airport-delays ## Description AeroDataBox connects your AI agent to the world of aviation data. It lets you pull live flight status, airport schedules, and delay metrics without jumping between different websites. If you're coordinating a supply chain and need to know if a plane is actually on the ground, you can just ask your agent to check. It handles the heavy lifting of fetching real-time data, so you can focus on the logistics instead of the busy work. You can also look into the past to see how airports have performed over certain dates or find out exactly what an airline's active fleet looks like. This is especially useful for anyone who needs to move past manual data entry and start getting answers in a single chat window. You can find this in the Vinkius catalog to get your agent set up with these capabilities quickly. It's a way to turn your AI into a specialized aviation assistant that knows the current state of the skies. Instead of copying numbers from a flight board into a spreadsheet, you can ask your agent to summarize the delays at a specific hub or tell you the estimated flight time between two cities. It takes the guesswork out of aviation data by providing direct access to real-time and historical records. ## Tools ### get_airport_delays See current airport delay statistics. Use this to check how busy an airport is right now. ### get_nearest_flight Find the real-time status of the flight closest to you by number. It's perfect for quick status checks. ### get_airport_routes_stats Check the frequency of routes for a specific airport. This helps with hub analysis. ### get_airport_runways Get physical and operational details for airport runways. Use this for technical infrastructure data. ### get_airports_by_ip Find the nearest airports based on an IP address. This is useful for location-aware queries. ### get_alert_balance Check your remaining flight alert credit balance. Use this to manage your subscription limits. ### get_distance_time Calculate the distance and estimated time between two airports. This helps with travel planning. ### get_fids_absolute Get airport departure and arrival info for a specific time range. Use this for fixed schedule windows. ### get_fids_relative Get airport departure and arrival info for a relative time window. This is perfect for next 4 hours queries. ### get_flight_by_date Check the status of a flight on a specific date. Use this to look back at specific past flights. ### get_flight_delays Get historical punctuality stats for a specific flight number. Use this to see a flight's reliability. ### get_flight_history Pull flight history and scheduled movement data. You can search by flight number or registration. ### list_alert_subscriptions See a list of all your current flight alert webhook subscriptions. Use this to keep track of your alerts. ### refill_alert_balance Add credits to your flight alert balance. This keeps your automated alerts running. ### get_global_delays Get the current status of global flight delays. It helps you see the bigger picture of aviation traffic. ### get_alert_subscription View the details of a specific flight alert subscription. This lets you manage your active notifications. ### convert_alert_subscription Move an old subscription over to the credit-based system. Use this to update your account type. ### create_flight_alert Set up a new flight alert webhook subscription. This sends you updates when a flight changes. ### delete_alert_subscription Remove a flight alert webhook subscription. Use this to clean up your active alerts. ### get_airline_fleet See the active aircraft currently operated by a specific airline. It's great for fleet auditing. ### get_airport_delays_historical Look up historical airport delays for a specific date. Use this for past performance reviews. ### get_airport_delays_period Get historical airport delay data for a specific time period. This is useful for long-term trend analysis. ### get_global_delays_historical Access historical global delay statistics. Use this to see how global travel has changed. ## Prompt Examples **Prompt:** ``` Is flight AA100 on time? ``` **Response:** ``` I've checked the status for flight AA100. Here is the current information: * **Status:** On Time * **Departure:** Scheduled for 2:30 PM * **Aircraft:** Boeing 737-800 * **Gate:** B12 Everything looks clear for this flight. ``` **Prompt:** ``` Show me the departures for Heathrow for the next 4 hours. ``` **Response:** ``` Here are the upcoming departures at London Heathrow (EGLL) for the next 4 hours: | Flight | Destination | Scheduled | Gate | | :--- | :--- | :--- | :--- | | BA209 | New York (JFK) | 14:15 | A12 | | Virgin | Los Angeles (LAX) | 14:40 | B05 | | Lufthansa | Frankfurt (FRA) | 15:05 | C02 | *Note: Times are local.* ``` **Prompt:** ``` What are the current delays at JFK? ``` **Response:** ``` I've pulled the current delay statistics for John F. Kennedy International Airport (KJFK): * **Average Delay:** 22 minutes * **Status:** Moderate traffic * **Impacted Gates:** High activity in Terminal 4 Would you like me to check the historical delays for a specific date to see if this is a trend? ``` ## Capabilities ### Track live flight status Get the current location and status of a specific flight by its number. ### Pull airport arrival and departure boards Retrieve full flight information displays for any airport within a specific time window. ### Fetch historical flight movements Look up past flight records using registration numbers, callsigns, or hex codes. ### Analyze airport delay statistics Get current or historical data on how much delays are affecting specific airports. ### View active airline fleet details See a list of all aircraft currently operated by a specific airline. ### Calculate flight distances and times Get the estimated travel time and distance between any two airports. ### Create flight alert webhooks Set up automated notifications for specific flight status changes. ## Use Cases ### Checking cargo flight status A logistics manager asks their agent for the status of flight AA100. The agent uses get_nearest_flight to report the current location and delay status. ### Analyzing hub performance An analyst wants to see if an airport is getting slower. The agent uses get_airport_delays to provide current operational statistics. ### Planning corporate travel A travel planner needs to know the runway layout for a specific destination. The agent uses get_airport_runways to pull the technical data. ### Auditing airline assets A researcher wants to know which planes an airline owns. The agent uses get_airline_fleet to list all active aircraft. ## Benefits - Stop refreshing flight boards by using get_fids_relative to see arrivals and departures instantly. - Analyze past performance with get_airport_delays_period to see how airports handle traffic over time. - Automate your monitoring by using create_flight_alert to send webhook notifications when flights change. - Save time on logistics planning with get_distance_time to calculate travel duration between hubs. - Get a bird's eye view of the industry using get_global_delays to see current worldwide aviation trends. ## How It Works The bottom line is you get real-time aviation data in your chat window without the manual searching. 1. Subscribe to the AeroDataBox MCP through the Vinkius catalog. 2. Enter your AeroDataBox API key into your AI client configuration. 3. Ask your agent for flight status, airport schedules, or delay statistics. ## Frequently Asked Questions **Can AeroDataBox help me track flights in real-time?** Yes, it provides live status updates for specific flights, including current location and departure/arrival details. **Does AeroDataBox provide airport departure boards?** It can pull full flight information displays (FIDS) for any airport, showing arrivals and departures for specific time windows. **Can I use AeroDataBox for historical flight data?** Absolutely. You can query past flight movements using flight numbers, registration codes, or ICAO24 hex codes. **How does AeroDataBox handle airport delays?** It provides both current operational delay stats and historical delay data for specific dates or periods to help you analyze performance. **Can I set up alerts with AeroDataBox?** Yes, you can create flight alert webhook subscriptions to get notified automatically when flight statuses change. **Does AeroDataBox work for international airports?** Yes, it handles global aviation data, allowing you to check flights and airport stats worldwide. **How can I check the real-time status of a flight using its flight number?** You can use the `get_nearest_flight` tool by passing the flight number (e.g., 'DL47'). The agent will retrieve the real-time flight status, including departure/arrival times and aircraft details. **How do I list upcoming departures and arrivals for a specific airport?** Use the `get_fids_relative` tool with the airport's ICAO code (e.g., 'KLGA') and optional offset/duration parameters. This returns a list of scheduled flights within that relative time window. **Can I retrieve historical delay statistics for an airport?** Yes, you can use the `get_airport_delays_historical` tool by providing the airport's ICAO code and a specific date (YYYY-MM-DD) to analyze past operational performance.