# AviationStack

```json
{
  "name": "AviationStack",
  "slug": "aviationstack",
  "url": "https://composio.dev/toolkits/aviationstack",
  "markdown_url": "https://composio.dev/toolkits/aviationstack.md",
  "logo_url": "https://logos.composio.dev/api/aviationstack",
  "categories": [
    "scheduling & booking"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-11-17T05:33:51.412Z"
}
```

![AviationStack logo](https://logos.composio.dev/api/aviationstack)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with AviationStack MCP or direct API to track flights, search schedules, look up airports, and explore airline and route data through natural language.

## Summary

AviationStack is an aviation data API for real-time, historical, and scheduled flight information.
It provides global flight records and reference catalogs for airports, airlines, routes, and more.

## Categories

- scheduling & booking

## Toolkit Details

- Tools: 11

## Images

- Logo: https://logos.composio.dev/api/aviationstack

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for AviationStack.
  - Setup:
    - Configure Api Key credentials for AviationStack.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Check live status for flight EK202
- Find airports serving London and Dubai
- Compare scheduled flights between major hubs

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `AVIATIONSTACK_GET_AIRPORT_TIMETABLE` | Get Airport Timetable | Return the current departure or arrival timetable for one airport, with optional status, airline, flight, terminal, delay, and schedule-time filters. Returns one page and a continuation cursor when more timetable entries are available. |
| `AVIATIONSTACK_LIST_AIRCRAFT_TYPES` | List Aircraft Types | Requires Basic or higher. List aircraft type names and IATA codes, optionally filtered by autocomplete search. Returns one page and a continuation cursor when more aircraft types are available. |
| `AVIATIONSTACK_LIST_AIRLINES` | List Airlines | Requires Basic or higher. List airlines and their codes, status, fleet, hub, and country metadata, optionally filtered by autocomplete search. Returns one page and a continuation cursor when more airlines are available. |
| `AVIATIONSTACK_LIST_AIRPLANES` | List Airplanes | Requires Basic or higher. List registered airplanes and aircraft metadata, optionally filtered by autocomplete search. Returns one page and a continuation cursor when more airplanes are available. |
| `AVIATIONSTACK_LIST_AIRPORTS` | List Airports | Requires Basic or higher. List airports worldwide, optionally filtered by autocomplete search. Returns one page and a continuation cursor when more airports are available. |
| `AVIATIONSTACK_LIST_CITIES` | List Cities | Requires Basic or higher. List destination cities with IATA, country, location, and timezone metadata, optionally filtered by autocomplete search. Returns one page and a continuation cursor when more cities are available. |
| `AVIATIONSTACK_LIST_COUNTRIES` | List Countries | Requires Basic or higher. List destination countries with ISO, population, capital, continent, currency, dialing, and aviation metadata, optionally filtered by autocomplete search. Returns one page and a continuation cursor when more countries are available. |
| `AVIATIONSTACK_LIST_FLIGHTS` | List Flights | List real-time flights, or flights from a specific historical date when flight_date is provided, with filters for route, airline, status, flight identifiers, and delay. Returns one page and a continuation cursor when more matching flights are available. |
| `AVIATIONSTACK_LIST_FUTURE_FLIGHTS` | List Future Flights | List scheduled departures or arrivals for one airport on a specified future date, optionally filtered by airline or flight number. Returns one page and a continuation cursor when more matching flights are available. |
| `AVIATIONSTACK_LIST_ROUTES` | List Routes | Requires Basic or higher. List airline route metadata, optionally filtered by flight number, departure or arrival airport, or airline code. Returns one page and a continuation cursor when more matching routes are available. |
| `AVIATIONSTACK_LIST_TAXES` | List Aviation Taxes | Requires Basic or higher. List aviation tax zones and IATA tax codes, optionally filtered by autocomplete search. Returns one page and a continuation cursor when more tax records are available. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
```python
pip install composio composio_openai openai
```

```typescript
npm install @composio/core @composio/openai openai
```

#### Path 1, Step 2: Create a Composio session

Initialize Composio with the OpenAI Responses provider and create a session scoped to AviationStack
```python
import json
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
client = OpenAI()

session = composio.create(user_id="your-user-id", toolkits=["aviationstack"])
tools = session.tools()
```

```typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["aviationstack"] });
const tools = await session.tools();
```

#### Path 1, Step 3: Run AviationStack tools with your agent

Send a request, execute the AviationStack tool calls through the session, and print the final answer
```python
response = client.responses.create(
    model="gpt-5.6-sol",
    tools=tools,
    input=[{"role": "user", "content": "Find the current status of Emirates flight EK202"}],
)

while True:
    tool_calls = [o for o in response.output if o.type == "function_call"]
    if not tool_calls:
        break
    results = composio.provider.handle_tool_calls(response=response, session=session)
    response = client.responses.create(
        model="gpt-5.6-sol",
        tools=tools,
        previous_response_id=response.id,
        input=[
            {"type": "function_call_output", "call_id": call.call_id, "output": json.dumps(results[i])}
            for i, call in enumerate(tool_calls)
        ],
    )

print(response.output_text)
```

```typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Find the current status of Emirates flight EK202" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and your agent framework
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
```

#### Path 2, Step 2: Create a session with MCP enabled

Create a session scoped to AviationStack and read its MCP URL and headers
```python
from composio import Composio

composio = Composio()
session = composio.create(user_id="your-user-id", toolkits=["aviationstack"], mcp=True)
```

```typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["aviationstack"],
  mcp: true,
});
```

#### Path 2, Step 3: Connect your agent to the MCP server

Pass the session's MCP URL and headers to your agent and run a AviationStack request
```python
import asyncio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, AssistantMessage, TextBlock

options = ClaudeAgentOptions(
    mcp_servers={
        "composio": {
            "type": "http",
            "url": session.mcp.url,
            "headers": session.mcp.headers,
        }
    },
    system_prompt="You are a helpful assistant with access to AviationStack tools.",
    tools=[],
    allowed_tools=["mcp__composio__*"],
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query("Find the current status of Emirates flight EK202")
        async for message in client.receive_response():
            if isinstance(message, AssistantMessage):
                for block in message.content:
                    if isinstance(block, TextBlock):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Find the current status of Emirates flight EK202",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
```

## Why Use Composio?

### 1. AI Native AviationStack Integration

- Supports both AviationStack MCP and direct API integrations
- Structured, LLM-friendly schemas for reliable flight data queries
- Access real-time, historical, scheduled, airport, airline, and route data without bespoke integration code

### 2. Managed Auth

- Securely store and use your AviationStack API key without hard-coding it in agent workflows
- Central place to manage, scope, and revoke AviationStack access
- Use per-user and per-environment credentials for safer development and production deployments

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access AviationStack
- Scoped, least privilege access to AviationStack flight and reference data
- Full audit trail of agent actions to support review and compliance

## Use AviationStack with any AI Agent Framework

Choose a framework you want to connect AviationStack with:

- [ChatGPT](https://composio.dev/toolkits/aviationstack/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/aviationstack/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/aviationstack/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/aviationstack/framework/atomic-agent)

## Related Toolkits

- [Google Calendar](https://composio.dev/toolkits/googlecalendar) - Google Calendar is a time management service for scheduling meetings, events, and reminders. It streamlines personal and team organization with integrated notifications and sharing options.
- [Apaleo](https://composio.dev/toolkits/apaleo) - Apaleo is a cloud-based property management platform for hospitality businesses. It centralizes reservations, billing, and daily operations for smoother hotel management.
- [Appointo](https://composio.dev/toolkits/appointo) - Appointo is an appointment booking platform for Shopify stores. It lets businesses add online scheduling to their websites with zero coding.
- [Bart](https://composio.dev/toolkits/bart) - Bart is the Bay Area Rapid Transit system, providing fast public transportation across the San Francisco Bay Area. It helps commuters and travelers get real-time schedule info, plan routes, and stay updated on service changes.
- [Blue Pillow Hotels & Stays](https://composio.dev/toolkits/bluepillow) - Blue Pillow Hotels & Stays is a hotel and stay discovery platform offering live offers, recommendations, and booking handoff. It helps surface and compare real-time deals and validate bookings for smoother reservations.
- [Bookingmood](https://composio.dev/toolkits/bookingmood) - Bookingmood is commission-free booking software for rental businesses. It lets you manage reservations and sync bookings directly on your website.
- [Booqable](https://composio.dev/toolkits/booqable) - Booqable is a rental software platform for managing inventory, bookings, and reservations. It helps businesses streamline rentals and keep track of every item with ease.
- [Cal](https://composio.dev/toolkits/cal) - Cal is a meeting scheduling platform that offers shareable booking links and real-time calendar syncing. It streamlines the process of finding mutual availability to make scheduling effortless.
- [Calendarhero](https://composio.dev/toolkits/calendarhero) - Calendarhero is a powerful scheduling platform that streamlines your calendar management across multiple services. It helps you efficiently schedule, reschedule, and organize meetings without the back-and-forth.
- [Calendly](https://composio.dev/toolkits/calendly) - Calendly is an appointment scheduling tool that automates meeting invitations, availability checks, and reminders. It helps individuals and teams avoid endless email back-and-forth when booking meetings.
- [Calendly MCP](https://composio.dev/toolkits/calendly_mcp) - Calendly is an appointment scheduling platform that manages event types, availability, and invites. Use it to automate booking, reduce back-and-forth, and surface open times quickly.
- [Check Cherry](https://composio.dev/toolkits/check_cherry) - Check Cherry is a business management platform for photography and event service companies. It helps teams manage leads, bookings, appointments, offerings, payments, and workflows in one place.
- [Cronfree Time Scheduler](https://composio.dev/toolkits/cronfree_time_scheduler) - Cronfree Time Scheduler is an API-based scheduler for recurring webhook calls. Use it to create and remove timezone-aware schedules without running cron.
- [Etermin](https://composio.dev/toolkits/etermin) - eTermin is an online appointment scheduling platform for businesses to manage bookings. It streamlines client appointments, saving time and reducing scheduling conflicts.
- [Evenium](https://composio.dev/toolkits/evenium) - Evenium is an all-in-one platform for managing professional events, from planning to analysis. It helps teams simplify event logistics, boost engagement, and track every detail in one place.
- [Eventee](https://composio.dev/toolkits/eventee) - Eventee is a user-friendly event management platform for mobile and web. It boosts attendee engagement for in-person, virtual, and hybrid events.
- [Eventzilla](https://composio.dev/toolkits/eventzilla) - Eventzilla is an event management platform for creating, promoting, and running events. It streamlines ticketing, registration, and attendee coordination for organizers.
- [GoTable](https://composio.dev/toolkits/go_table) - GoTable is a restaurant management REST API for reservations, tables, guests, offers, availability, and webhooks. Use it to programmatically manage bookings, guest data, offers, and table availability.
- [Humanitix](https://composio.dev/toolkits/humanitix) - Humanitix is a not-for-profit ticketing platform that donates 100% of profits to charity. It empowers event organizers to make social impact with every ticket sold.
- [Ignav Flights](https://composio.dev/toolkits/ignav_flights) - Ignav Flights is a flight search API for airports, fares, itineraries, and booking links. It helps apps compare routes and prices fast, so travelers can find practical options sooner.

## Frequently Asked Questions

### Do I need my own developer credentials to use AviationStack with Composio?

Yes, AviationStack requires you to configure your own API key. Once set up, Composio handles secure credential storage and API request handling for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)
