flights
Pack: aviationstack · Endpoint: https://gateway.pipeworx.io/aviationstack/mcp
Real-time and scheduled flights with departure/arrival airport, time, gate, status. Combine filters to narrow down.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
flight_iata | string | no | IATA flight number (e.g. “AA100”) |
flight_icao | string | no | ICAO flight number |
dep_iata | string | no | Departure airport IATA (e.g. “JFK”) |
arr_iata | string | no | Arrival airport IATA |
airline_iata | string | no | Airline IATA code |
flight_status | string | no | scheduled | active | landed | cancelled | incident | diverted |
limit | number | no | 1-100 (default 25) |
offset | number | no | 0-based offset |
Example call
Arguments
{
"flight_iata": "AA100",
"dep_iata": "JFK",
"arr_iata": "LAX"
}curl
curl -X POST https://gateway.pipeworx.io/aviationstack/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"flights","arguments":{"flight_iata":"AA100","dep_iata":"JFK","arr_iata":"LAX"}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('flights', {
"flight_iata": "AA100",
"dep_iata": "JFK",
"arr_iata": "LAX"
});More examples
{
"airline_iata": "UA",
"flight_status": "landed",
"limit": 50
}Response shape
| Field | Type | Description |
|---|---|---|
pagination | object | Pagination metadata |
data | array | Array of flight objects |
Full JSON Schema
{
"type": "object",
"properties": {
"pagination": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "Items per page"
},
"offset": {
"type": "number",
"description": "Current offset"
},
"count": {
"type": "number",
"description": "Total results available"
},
"total": {
"type": "number"
}
},
"description": "Pagination metadata"
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"flight_date": {
"type": "string",
"description": "Flight date (ISO format)"
},
"flight_status": {
"type": "string",
"description": "Flight status (scheduled|active|landed|cancelled|incident|diverted)"
},
"departure": {
"type": "object",
"properties": {
"airport": {
"type": "string",
"description": "Departure airport IATA"
},
"timezone": {
"type": "string",
"description": "Airport timezone"
},
"iata": {
"type": "string",
"description": "IATA code"
},
"icao": {
"type": "string",
"description": "ICAO code"
},
"terminal": {
"type": "null",
"description": "Terminal number"
},
"gate": {
"type": [
"null",
"string"
],
"description": "Gate number"
},
"delay": {
"type": "null",
"description": "Delay in minutes"
},
"scheduled": {
"type": "string",
"description": "Scheduled departure time (ISO)"
},
"estimated": {
"type": "string",
"description": "Estimated departure time (ISO)"
},
"actual": {
"type": "null",
"description": "Actual departure time (ISO)"
},
"estimated_runway": {
"type": "null"
},
"actual_runway": {
"type": "null"
}
},
"description": "Departure details"
},
"arrival": {
"type": "object",
"properties": {
"airport": {
"type": "string",
"description": "Arrival airport IATA"
},
"timezone": {
"type": "string",
"description": "Airport timezone"
},
"iata": {
"type": "string",
"description": "IATA code"
},
"icao": {
"type": "string",
"description": "ICAO code"
},
"terminal": {
"type": [
"null",
"string"
],
"description": "Terminal number"
},
"gate": {
"type": [
"null",
"string"
],
"description": "Gate number"
},
"baggage": {
"type": [
"null",
"string"
]
},
"scheduled": {
"type": "string",
"description": "Scheduled arrival time (ISO)"
},
"delay": {
"type": "null",
"description": "Delay in minutes"
},
"estimated": {
"type": "null",
"description": "Estimated arrival time (ISO)"
},
"actual": {
"type": "null",
"description": "Actual arrival time (ISO)"
},
"estimated_runway": {
"type": "null"
},
"actual_runway": {
"type": "null"
}
},
"description": "Arrival details"
},
"airline": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Airline name"
},
"iata": {
"type": [
"null",
"string"
],
"description": "Airline IATA code"
},
"icao": {
"type": [
"null",
"string"
],
"description": "Airline ICAO code"
}
},
"description": "Airline details"
},
"flight": {
"type": "object",
"properties": {
"number": {
"type": [
"null",
"string"
],
"description": "Flight number"
},
"iata": {
"type": [
"null",
"string"
],
"description": "Flight IATA"
},
"icao": {
"type": [
"null",
"string"
],
"description": "Flight ICAO"
},
"codeshared": {
"type": [
"null",
"object"
]
}
},
"description": "Flight identifiers"
},
"aircraft": {
"type": "object",
"properties": {
"registration": {
"type": "null"
},
"iata": {
"type": "null"
},
"icao": {
"type": "null"
},
"icao24": {
"type": "string"
}
},
"description": "Aircraft details"
},
"live": {
"type": "null"
}
}
},
"description": "Array of flight objects"
}
}
}Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"aviationstack": {
"url": "https://gateway.pipeworx.io/aviationstack/mcp"
}
}
}See Getting Started for client-specific install steps.