# Aviationstack MCP MCP > Aviationstack MCP connects your agent to global aviation intelligence. It provides real-time access to flight paths, airport metadata (IATA/ICAO), airline schedules, and technical aircraft specifications. Your client can search for active flights, audit complex routes between any two points, or list detailed country and city data needed for logistics planning. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** flight-tracking, real-time-data, aviation-metadata, airport-data, airline-schedules ## Description This MCP gives your agent the full spectrum of global aviation data. Instead of opening nine different databases to check a flight's status, you talk to your AI client, and it handles the complexity. Your agent acts as a dedicated operations analyst, allowing you to query real-time movements by flight number or airline, fetch detailed airport metadata, and even audit entire scheduled routes just by naming the departure and arrival locations. It pulls together everything from specific airplane registration details to general global city and country listings. When your client talks to Vinkius, it’s not just another data source; it's a unified aviation intelligence layer that lets you skip manual research entirely. You can ask for flight status, and the agent returns not just 'on time,' but estimated coordinates and necessary airport codes right away. ## Tools ### list_flights Fetches real-time status updates for thousands of scheduled and active flights. ### list_routes Calculates and lists the details of flight routes based on specific origin and destination airports. ### list_taxes Retrieves a list of applicable aviation taxes for different regions or countries. ### list_aircraft_types Retrieves the catalog of recognized airplane types used in global aviation. ### list_airlines Provides a list of operating airlines and their technical identifiers for lookups. ### list_airplanes Looks up detailed information about specific airplane registrations in the global database. ### list_airports Lists metadata for airports, including their IATA and ICAO codes worldwide. ### list_cities Gives a list of populated cities served by the global aviation network. ### list_countries Provides a directory of countries that have an active presence in the aviation system. ## Prompt Examples **Prompt:** ``` Find real-time status for flight AA123. ``` **Response:** ``` I've retrieved the real-time status for American Airlines flight AA123. It is currently 'active' and en route from Dallas (DFW) to London (LHR), with an estimated arrival in 3 hours. Would you like the exact coordinates? ``` **Prompt:** ``` List all airports in Tokyo. ``` **Response:** ``` Searching for airports in Tokyo... I've identified Haneda Airport (HND) and Narita International Airport (NRT). I have their full geographic data and contact info if you're interested. ``` **Prompt:** ``` What are the technical specs for a Boeing 747? ``` **Response:** ``` Fetching technical specifications for the Boeing 747 series... I've found detailed data including its aircraft code, production line history, and typical configuration. Shall I list the specific model variants for you? ``` ## Capabilities ### Track Real-Time Flight Status Search for active or scheduled flights using a specific airline or flight number to get current status updates. ### Determine Airport and City Data Retrieve full metadata, including IATA/ICAO codes and timezones, for airports, cities, or countries globally. ### Audit Flight Paths Define a route by specifying the departure and arrival airport identifiers to check scheduled connections and paths. ### Inspect Aircraft Specifications Access technical data, including specific registration details and general type specifications for airplanes. ### List Operating Airlines Fetch a directory of global airlines operating worldwide along with their required identifiers. ## Use Cases ### Coordinating International Travel A logistics manager needs to book a cross-continent trip. They ask their agent: 'Show me the best flights from London to Sydney, including all required airport codes and associated taxes.' The MCP uses `list_airports`, `list_routes`, and `list_taxes` sequentially to deliver a complete itinerary. ### Building an Aircraft Inventory System A developer needs to validate the types of jets used by a client. They ask their agent to run 'list all aircraft types' and then use `list_airplanes` to pull specific registration details, feeding that into their application's schema. ### Analyzing Market Expansion A data analyst is considering entering a new region. They ask the agent to 'list all countries and cities served by aviation.' The MCP uses `list_countries` and `list_cities`, giving them an immediate scope of market potential. ### Troubleshooting a Flight Delay A corporate travel coordinator asks: 'What's the status for flight BA249?' The agent calls `list_flights` and returns real-time data, including current location estimates and updated arrival times. ## Benefits - Cut out manual lookups. Instead of checking airport codes in a separate database, your agent calls `list_airports` to pull metadata instantly. - Audit complex travel plans by using the MCP's route tools. You simply need to specify origin and destination for `list_routes`, getting back scheduled connections without writing code. - Stay compliant with immediate data access. If you're building a booking system, use `list_taxes` to accurately pull applicable fees before quoting a final price. - Get deep specs on gear. Need to know the technical limitations of an aircraft? Use `list_aircraft_types` and `list_airplanes` for detailed registry data. - Understand the global scope. Quickly list all cities or countries served by the network using `list_cities` or `list_countries` when scoping a new market. ## How It Works The bottom line is you get a single interface that executes complex, multi-step database queries using plain conversation. 1. Subscribe to this MCP and enter your Aviationstack Access Key into Vinkius. 2. Connect the MCP to your preferred agent client (Claude, Cursor, etc.). 3. Use natural language prompts with your agent; it will determine which tools to call and return structured aviation data. ## Frequently Asked Questions **How do I find real-time flights with list_flights?** You simply ask your agent for the status of a flight, providing the airline and number. The MCP uses `list_flights` to pull active data instantly. **Can I use this MCP to find airport codes? (list_airports)** Yes. Use `list_airports` to retrieve complete metadata, including both the IATA and ICAO codes for any global airport you name. **Is list_routes better than just listing flights?** Yes, because `list_routes` doesn't just track a flight; it audits the entire scheduled path between two specified airports, giving a structured overview of connections. **What if I need to check taxes? (list_taxes)** Always use `list_taxes`. You pass the origin and destination data through, and the MCP pulls all applicable aviation tax rates for that specific route. **When I use `list_airlines`, what should I do if my calls fail with an authentication error?** You need to verify your Aviationstack Access Key. Ensure the key you entered into Vinkius is active and hasn't expired, as invalid credentials are the most common cause of failure. **Does `list_airplanes` provide historical data beyond just the current status?** Yes, it pulls deep technical records. When you run `list_airplanes`, you get detailed specs including production history and specific aircraft registration information. **If I need to check hundreds of flights quickly using `list_flights`, are there rate limits or performance issues?** The MCP handles high volumes, but excessive requests in a short window can trigger temporary throttling. For large batch jobs, consider implementing exponential backoff logic in your agent. **How do I filter the search when calling `list_cities` for specific regions?** You must pass specific parameters like country or state identifiers to narrow results. Searching only by name can return too many irrelevant locations, so always include a geographical scope. **Can I track a specific flight by its number?** Yes! Use the `list_flights` tool and provide the flight number in the `flight_number` parameter. Your agent will retrieve the real-time status and details for that specific flight. **How do I find the IATA code for a specific airport?** Use the `list_airports` tool and provide the airport name or city in the `search` parameter. The response will include the corresponding IATA and ICAO codes for all matching airports. **Does the integration provide technical aircraft specifications?** Absolutely. You can use the `list_aircraft_types` tool to retrieve a comprehensive list of specifications for various aircraft models used in the global fleet.