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
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":{}}}'Response shape
| Field | Type | Description |
|---|---|---|
data | array | Array of flight objects |
pagination | object | Pagination metadata |
Full JSON Schema
{
"type": "object",
"properties": {
"data": {
"type": "array",
"description": "Array of flight objects",
"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",
"description": "Departure details",
"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": [
"string",
"null"
],
"description": "Terminal number"
},
"gate": {
"type": [
"string",
"null"
],
"description": "Gate number"
},
"delay": {
"type": [
"number",
"null"
],
"description": "Delay in minutes"
},
"scheduled": {
"type": "string",
"description": "Scheduled departure time (ISO)"
},
"estimated": {
"type": "string",
"description": "Estimated departure time (ISO)"
},
"actual": {
"type": [
"string",
"null"
],
"description": "Actual departure time (ISO)"
}
}
},
"arrival": {
"type": "object",
"description": "Arrival details",
"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": [
"string",
"null"
],
"description": "Terminal number"
},
"gate": {
"type": [
"string",
"null"
],
"description": "Gate number"
},
"delay": {
"type": [
"number",
"null"
],
"description": "Delay in minutes"
},
"scheduled": {
"type": "string",
"description": "Scheduled arrival time (ISO)"
},
"estimated": {
"type": "string",
"description": "Estimated arrival time (ISO)"
},
"actual": {
"type": [
"string",
"null"
],
"description": "Actual arrival time (ISO)"
}
}
},
"airline": {
"type": "object",
"description": "Airline details",
"properties": {
"name": {
"type": "string",
"description": "Airline name"
},
"iata": {
"type": "string",
"description": "Airline IATA code"
},
"icao": {
"type": "string",
"description": "Airline ICAO code"
}
}
},
"aircraft": {
"type": [
"object",
"null"
],
"description": "Aircraft details",
"properties": {
"registration": {
"type": [
"string",
"null"
],
"description": "Aircraft registration"
},
"iata": {
"type": [
"string",
"null"
],
"description": "Aircraft IATA code"
},
"icao": {
"type": [
"string",
"null"
],
"description": "Aircraft ICAO code"
},
"icao24": {
"type": [
"string",
"null"
],
"description": "24-bit ICAO code"
}
}
},
"flight": {
"type": "object",
"description": "Flight identifiers",
"properties": {
"number": {
"type": "string",
"description": "Flight number"
},
"iata": {
"type": "string",
"description": "Flight IATA"
},
"icao": {
"type": [
"string",
"null"
],
"description": "Flight ICAO"
}
}
}
}
}
},
"pagination": {
"type": "object",
"description": "Pagination metadata",
"properties": {
"limit": {
"type": "number",
"description": "Items per page"
},
"offset": {
"type": "number",
"description": "Current offset"
},
"count": {
"type": "number",
"description": "Total results available"
}
}
}
}
}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.