# AeroAPI (FlightAware) MCP for AI Agents MCP > AeroAPI connects your AI client directly to FlightAware's real-time global flight data. It lets you audit complex logistics searches, instantly tracking specific flights or auditing the schedules of any major airport worldwide. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** flight-tracking, aviation-data, real-time-logistics, airport-schedules, flight-status ## Description Stop juggling multiple tabs and manual lookups when planning supply chains or monitoring travel. AeroAPI gives your agent authoritative access to live aviation data from FlightAware. Instead of building custom scripts for every flight status check, you just ask your AI client what you need. Your agent can instantly track a specific plane by its ID, audit the entire arrival schedule at an airport, or pull deep metadata about any location—all without you needing to open a dedicated flight tracker website. This capability turns complex logistics research into simple conversation. By connecting AeroAPI through Vinkius, your AI client becomes a real-time aviation consultant, ensuring every data point for departures, arrivals, and airport details is precise and current. ## Tools ### check_api_status Checks the system's operational status to ensure the API connection is live. ### get_airport_details Retrieves metadata and location details for a specific airport using its code. ### get_flight_details Gathers comprehensive details about one specific flight, including status and route data. ### list_airport_flights Lists all scheduled flights—arrived, departing, or enroute—for a given airport. ### search_flights Searches for multiple potential flights using criteria like origin, destination, or identifier. ## Prompt Examples **Prompt:** ``` What are the expected arrivals and departures at LAX today? ``` **Response:** ``` **LAX Daily Schedule Audit** * **Incoming (Arrivals):** * BA214 (From New York): Expected 3:00 PM. Gate status pending. * UA769 (From Denver): Estimated arrival 5:15 PM. Status: In Air. * **Outgoing (Departures):** * DAL123 (To Chicago): Scheduled departure 10:00 AM. Status: On Time. * AA456 (To Dallas): Scheduled departure 1:30 PM. Status: On Schedule. Need more details on any of these? Just ask. ``` **Prompt:** ``` I need to know the full status for flight AA987 and its origin airport's time zone. ``` **Response:** ``` **Flight Details & Location Data** * 🛫 **Flight Status (AA987):** * Origin: Dallas/Fort Worth (DFW) * Destination: Chicago O'Hare (ORD) * Current Status: En Route. ETA: 11:45 AM. * 📍 **Airport Metadata (DFW):** * Location: DFW, Texas, USA * Time Zone: America/Chicago * Coordinates: 32.89* - 97.04 Everything you need to know about that trip. ``` **Prompt:** ``` Search for flights leaving from Miami, but I'm flexible on the destination. ``` **Response:** ``` **Miami Departures Search** I found three potential routes departing Miami today: 1. **Flight: SW301** (Origin: MIA) * Destination: Orlando (MCO) * Time Estimate: 8:00 AM - Status: Scheduled 2. **Flight: AA567** (Origin: MIA) * Destination: Boston (BOS) * Time Estimate: 11:30 AM - Status: En Route 3. **Flight: DL999** (Origin: MIA) * Destination: Washington D.C. (IAD) * Time Estimate: 2:45 PM - Status: Scheduled Let me know if you want status details for any of these. ``` ## Capabilities ### Check Service Health Verify if the entire AeroAPI service is currently operational before running complex queries. ### Retrieve Airport Details Get location and metadata details for any specific airport using its ICAO or IATA code. ### Audit Specific Flight Statuses Pull comprehensive, high-resolution status data for a single flight, including origin, destination, and current enroute status. ### List Scheduled Airport Flights Generate lists of flights—whether they're scheduled to arrive, depart, or are currently in the air—for an entire airport. ### Search Across Flight Parameters Find potential flight routes by querying criteria like origin, destination, or a partial identifier. ## Use Cases ### Coordinating a disrupted shipment A logistics manager asks their agent, 'What's the status of all flights into London Heathrow today?' The agent runs `list_airport_flights` and provides a real-time summary of notable arrivals and departures so the ground team can reroute resources. ### Verifying travel routes for an audit An aviation researcher needs to compare airport codes across three continents. The agent uses `get_airport_details` multiple times, pulling necessary metadata and time zone information into a structured report for comparison. ### Planning emergency rerouting The operations lead asks the agent to 'Find all possible routes from Atlanta to Chicago.' The agent runs `search_flights`, narrowing down options instantly based on available criteria, saving hours of manual searching. ### Preparing a client presentation A travel professional needs details for JFK. They ask the agent about 'John F. Kennedy International Airport' and use `get_airport_details` to pull location and time zone data, making their presentation authoritative. ## Benefits - Get real-time visibility into flight status. Instead of manually checking a website, your agent can pull detailed information on specific flights using the `get_flight_details` tool. - Simplify airport oversight. Use `list_airport_flights` to quickly audit arrival and departure schedules for any major global hub in one conversation. - Improve logistics planning by finding data points fast. The `search_flights` capability lets you locate potential routes based on simple origin or destination queries, not just flight IDs. - Deepen research with metadata. Quickly gather unique airport codes and timezone information using `get_airport_details` to ensure your classification is accurate. - Automate the audit process. You can reliably check the system's operational status via `check_api_status`, ensuring your entire workflow never breaks down due to API issues. ## How It Works The bottom line is you tell your AI what aviation data you need; it runs the query and hands you the precise results. 1. Subscribe to this MCP and enter your personal FlightAware AeroAPI Key. 2. Connect the key to your preferred AI client (Claude, Cursor, etc.) through Vinkius. 3. Ask your agent a natural language question about flight status or airport schedules. ## Frequently Asked Questions **How can I use AeroAPI (FlightAware) to track a specific flight's real-time location?** You simply ask your agent, and it pulls the full details using the correct identifier. The result includes status, origin, destination, and even if it’s currently en route with estimated times. It gives you more than just a simple 'flying' message. **Does AeroAPI (FlightAware) help me compare multiple airport schedules?** Yes. You can tell your agent to audit arrivals and departures for several airports in one go. It compiles the data, giving you a clear overview of capacity and expected traffic at each location. **I'm building a logistics tool; what kind of metadata does AeroAPI (FlightAware) provide?** The MCP provides critical details like unique airport codes, precise time zones, and geographic markers. This data is vital for classifying locations correctly in your system, making sure timestamps are never wrong. **Is AeroAPI (FlightAware) better than just using the airline's website?** It's much faster and more comprehensive. Instead of opening multiple sites, you ask your agent once, and it consolidates the status, schedules, metadata, and potential routes into one readable report. **Can AeroAPI (FlightAware) find flights even if I don't know the exact flight ID?** Absolutely. You don't need a specific identifier; you can search using general criteria like an origin city or destination area, and it will give you a list of potential routes to narrow down your focus. **What kind of industries use AeroAPI (FlightAware) for their daily operations?** Logistics companies, travel agencies, and academic researchers rely on this MCP. It's perfect for anyone whose job depends on accurate, up-to-the-minute knowledge of global movement.