Tool Docs · Verified 2026-09-24

VariFlight MCP tool documentation

Explore 36 tools across Flight status & analysis / Trips & flight tracking / Airports & airlines / Fares & deals. These cover flight services, trip statistics, airport weather, fare monitoring, trains, and air–rail connections. Names, parameter types, and required fields were checked against the server tool list. Instructions and examples are provided for integration reference.

Browse tool directory36 results

Flight status & analysis

Flight candidates`getFlightList`

Find flight candidates and list-level summaries by origin, destination, and date.

CapabilityFlight candidates

Input parameters

Parameter	Type	Required	Description
dep	`string`	Required	Departure airport IATA codes; separate multiple codes with commas
arr	`string`	Required	Arrival airport IATA codes; separate multiple codes with commas
date	`string`	Required	Query date in yyyy-MM-dd format

{
  "dep": "PEK,PKX",
  "arr": "PVG,SHA",
  "date": "2026-07-18"
}

Flight status & analysis

Flight status lookup`getFlightStatus`

Query flight lists and details by flight number or route, and compare candidates. Provide fnum + date or dep + arr + date. Use airport codes only; separate multiple codes with commas.

CapabilityFlight status lookup

Input parameters

Parameter	Type	Required	Description
fnum	`string`	-	Flight number, e.g. MU5102; when omitted, both dep and arr are required
date	`string`	Required	Query date in yyyy-MM-dd format
dep	`string`	-	Departure airport IATA codes, comma-separated without spaces, e.g. PEK,PKX
arr	`string`	-	Arrival airport IATA codes, comma-separated without spaces, e.g. PVG,SHA

{
  "fnum": "MU5102",
  "date": "2026-07-18"
}

Flight status & analysis

Flight operations analysis`flightAnalyze`

Analyze delay and cancellation risks and estimated departure windows using flight number, date, and both airports.

CapabilityFlight operations analysis

Input parameters

Parameter	Type	Required	Description
fnum	`string`	Required	Flight number
date	`string`	Required	Flight date in yyyy-MM-dd format
dep	`string`	Required	Departure airport IATA code
arr	`string`	Required	Arrival airport IATA code

{
  "fnum": "MU5102",
  "date": "2026-07-18",
  "dep": "PEK",
  "arr": "SHA"
}

Flight status & analysis

Flights by aircraft`getFlightByAircraftNumber`

Find flights operated by a specific aircraft number or registration.

CapabilityFlights by aircraft

Input parameters

Parameter	Type	Required	Description
aircraftNumber	`string`	Required	Aircraft number or registration, e.g. B-1234 or B1234
date	`string`	-	Date in yyyy-MM-dd format; defaults to today. Historical dates are unrestricted; future dates may be at most two days ahead.

{
  "aircraftNumber": "B-1234",
  "date": "2026-07-18"
}

Flight status & analysis

Flights by special livery`getFlightByPaintName`

Match aircraft by livery name or keyword and combine their flight lists. Historical dates are unrestricted; future dates may be at most two days ahead.

CapabilityFlights by special livery

Input parameters

Parameter	Type	Required	Description
flightDesc	`string`	Required	Livery name or keyword, e.g. panda or panda livery
date	`string`	-	Date in yyyy-MM-dd format; defaults to today

{
  "flightDesc": "熊猫"
}

Flight status & analysis

Aircraft rotation & connections`getAircraftRotation`

Find the operating aircraft, preceding flight chain, status, and turnaround intervals. Connection risk does not mean this flight is or will be delayed. Risk is unknown when valid timing data is missing.

CapabilityAircraft rotation & connections

Input parameters

Parameter	Type	Required	Description
fnum	`string`	Required	Flight number
date	`string`	Required	Flight date in yyyy-MM-dd format
dep	`string`	Required	Departure airport IATA code
arr	`string`	Required	Arrival airport IATA code

{
  "fnum": "CA1111",
  "date": "2026-09-25",
  "dep": "PEK",
  "arr": "HET"
}

Flight status & analysis

Onboard services & comfort`getFlightServiceProfile`

Find meals, Wi-Fi, aircraft type and age, comfort, seats, and remote-stand arrival rates using the four flight identifiers. Interpret raw enum values using the field dictionary. Missing values do not mean no service.

CapabilityOnboard services & comfort

Input parameters

Parameter	Type	Required	Description
fnum	`string`	Required	Flight number
date	`string`	Required	Flight date in yyyy-MM-dd format
dep	`string`	Required	Departure airport IATA code
arr	`string`	Required	Arrival airport IATA code

{
  "fnum": "CA1111",
  "date": "2026-09-26",
  "dep": "PEK",
  "arr": "HET"
}

Flight status & analysis

Route operations summary`getRouteOperationSummary`

Get an operations summary for a specified route.

CapabilityRoute operations summary

Input parameters

Parameter	Type	Required	Description
dep	`string`	Required	Departure city or airport IATA code
arr	`string`	Required	Arrival city or airport IATA code
date	`string`	-	Query date; defaults to today

{
  "dep": "BJS",
  "arr": "SHA",
  "date": "2026-07-18"
}

Flight status & analysis

Flight track coordinates`getFlightTrackLine`

Get track coordinates for one or more flights.

CapabilityFlight track coordinates

Input parameters

Parameter	Type	Required	Description
flightStr	`string`	Required	Format: flightNumber_departureIATA_arrivalIATA_yyyy-MM-dd_trackType; 0 = flight, 1 = train. Separate multiple entries with semicolons.

{
  "flightStr": "MU5102_PEK_SHA_2026-09-24_0"
}

Flight status & analysis

Aviation operations statistics`flightMarketData`

Query passenger or cargo operations by national total, country, city, airport, or airline.

CapabilityAviation operations statistics

Input parameters

Parameter	Type	Required	Description
type	`string`	Required	Scope: whole, country, city, airport, or airline
code	`string`	-	Country, city, airport, or airline code; optional for whole
span	`integer`	-	Number of recent days to query
tranmode	`string`	-	passenger = passenger flights; freight = cargo flights

{
  "type": "whole",
  "span": 7,
  "tranmode": "passenger"
}

Flight status & analysis

Country-pair route statistics`flightMarketRouteData`

Query passenger or cargo route operations between specified countries or regions.

CapabilityCountry-pair route statistics

Input parameters

Parameter	Type	Required	Description
orgCtry	`string`	Required	Departure country or region two-letter code
dstCtry	`string`	Required	Arrival country or region two-letter code
span	`integer`	-	Number of recent days to query
tranmode	`string`	-	passenger = passenger flights; freight = cargo flights

{
  "orgCtry": "CN",
  "dstCtry": "JP",
  "span": 7,
  "tranmode": "passenger"
}

Trips & flight tracking

Upcoming & active trips`queryUserFutureTrip`

Query the user’s upcoming or active flight trips.

CapabilityUpcoming & active trips

Input parameters

Parameter	Type	Required	Description
identityType	`integer`	-	Role: 0 passenger, 1 pickup, 2 drop-off, 3 crew, 99 follow only; defaults to 0

{
  "identityType": 0
}

Trips & flight tracking

Past flight trips`queryUserHistoryTrip`

Query the user’s historical flight trips.

CapabilityPast flight trips

Input parameters

Parameter	Type	Required	Description
year	`string`	-	Year in yyyy format; defaults to the current year
identityType	`integer`	-	Role: 0 passenger, 1 pickup, 2 drop-off, 3 crew, 99 follow only; defaults to 0

{
  "year": "2026",
  "identityType": 0
}

Trips & flight tracking

Trip statistics overview`queryUserTripStats`

Query total trips, distance, and duration across all history, one year, or a year range. Use queryUserTripDetailStats for full location, airline, and aircraft lists; use queryUserTripDelayStats for delay details.

CapabilityTrip statistics overview

Input parameters

Parameter	Type	Required	Description
yearStart	`string`	-	Start year in yyyy format
yearEnd	`string`	-	End year in yyyy format

{
  "yearStart": "2024",
  "yearEnd": "2026"
}

Trips & flight tracking

Detailed trip statistics`queryUserTripDetailStats`

Query full personal flight statistics by location, airline, or aircraft registration. Location statistics support flights and trains. Use queryUserTripStats for annual trip counts and distance totals.

CapabilityDetailed trip statistics

Input parameters

Parameter	Type	Required	Description
year	`integer`	-	Statistics year; omitted or 0 queries all years
statType	`string`	Required	area = location; airline = airline; aircraft = operating aircraft registration
tripType	`string`	-	Required when statType=area: flight or train. Train statistics return cities only.

{
  "year": 2026,
  "statType": "area",
  "tripType": "flight"
}

Trips & flight tracking

Personal trip delay statistics`queryUserTripDelayStats`

Query delay rates, counts, and durations for personal trips by airline, airport, or flight. These do not represent industry performance. delayDuration and delayTime are in seconds; delayRate is a percentage.

CapabilityPersonal trip delay statistics

Input parameters

Parameter	Type	Required	Description
year	`integer`	-	Statistics year; omitted or 0 queries all years
statType	`string`	Required	airline = by airline; airport = by airport; flight = by delayed flight

{
  "year": 2026,
  "statType": "airline"
}

Trips & flight tracking

Follow a flight`followFlight`

Follow a flight and set a role only when explicitly requested. If no role is specified, use 0 (passenger). Do not call this tool for ordinary flight queries.

CapabilityFollow a flight

Input parameters

Parameter	Type	Required	Description
fnum	`string`	Required	Flight number
date	`string`	Required	Flight date in yyyy-MM-dd format
dep	`string`	Required	Departure airport IATA code
arr	`string`	Required	Arrival airport IATA code
orderstyle	`string`	Required	0 passenger, 1 pickup, 2 drop-off, 99 follow only; pass as a string

{
  "fnum": "MU5102",
  "date": "2026-09-27",
  "dep": "PEK",
  "arr": "SHA",
  "orderstyle": "0"
}

Trips & flight tracking

Unfollow a flight`unfollowFlight`

Stop following a specified flight for the current user.

CapabilityUnfollow a flight

Input parameters

Parameter	Type	Required	Description
fnum	`string`	Required	Flight number
date	`string`	Required	Flight date in yyyy-MM-dd format
dep	`string`	Required	Departure airport IATA code
arr	`string`	Required	Arrival airport IATA code

{
  "fnum": "MU5102",
  "date": "2026-07-18",
  "dep": "PEK",
  "arr": "SHA"
}

Airports & airlines

Airport & city search`searchAirport`

Find airport and city IATA codes by name or keyword.

CapabilityAirport & city search

Input parameters

Parameter	Type	Required	Description
name	`string`	Required	Airport or city name, or keyword
region	`string`	-	Scope filter: CN = mainland China; INT = global. Defaults to global.

{
  "name": "北京",
  "region": "CN"
}

Airports & airlines

Electronic arrival card guidance`getAirportStrategy`

Check whether a country or region requires an electronic arrival card and find the application URL and guidance. Empty results do not mean no card is required. Verify official destination requirements before travel.

CapabilityElectronic arrival card guidance

Input parameters

Parameter	Type	Required	Description
country	`string`	Required	ISO 3166-1 alpha-2 country or region code, e.g. JP, MY, TH

{
  "country": "MY"
}

Airports & airlines

Airports by coordinates`getAirportByLatLng`

Find the nearest airport and other airports in the same city from latitude and longitude.

CapabilityAirports by coordinates

Input parameters

Parameter	Type	Required	Description
lat	`string`	Required	Latitude
lng	`string`	Required	° longitude

{
  "lat": "31.2304",
  "lng": "121.4737"
}

Airports & airlines

Airport information`getAirportInfoByCode`

Get airport details, phone numbers, transport, reviews, and services by IATA code.

CapabilityAirport information

Input parameters

Parameter	Type	Required	Description
code	`string`	Required	Airport IATA code, e.g. PVG

{
  "code": "PVG"
}

Airports & airlines

Airline information`getAirlineInfoByCode`

Get airline details, phone numbers, and services by two-letter airline code.

CapabilityAirline information

Input parameters

Parameter	Type	Required	Description
code	`string`	Required	Airline two-letter code, e.g. MU

{
  "code": "MU"
}

Airports & airlines

Live airport flight board`getAirportFlightBoard`

Get the live flight board for one airport.

CapabilityLive airport flight board

Input parameters

Parameter	Type	Required	Description
local	`string`	Required	City or airport IATA code, e.g. PVG
out	`string`	-	0 departures, 1 arrivals

{
  "local": "PVG",
  "out": "0"
}

Airports & airlines

Airport operations overview`getAirportOperationOverview`

Get an airport’s overall, departure, or arrival operations overview.

CapabilityAirport operations overview

Input parameters

Parameter	Type	Required	Description
local	`string`	Required	City or airport IATA code, e.g. HFE
out	`string`	-	0 departures, 1 arrivals, 2 both

{
  "local": "HFE",
  "out": "2"
}

Airports & airlines

Airport weather & impact`getAirportWeatherBriefing`

Combine current weather, METAR/TAF, significant weather, typhoons, lightning, and forecasts for a conservative impact assessment. Weather risk does not mean a specific flight is delayed or cancelled. Missing data does not imply normal weather.

CapabilityAirport weather & impact

Input parameters

Parameter	Type	Required	Description
airportCode	`string`	Required	Airport IATA code; use searchAirport first if only a city name is available
date	`string`	-	Date in yyyy-MM-dd format; defaults to today

{
  "airportCode": "PEK"
}

Fares & deals

Lowest-fare calendar`getFlightTicketPrice`

Get daily lowest fares for a route, supporting one-way date ranges and round trips. Defaults to tomorrow; earlier departure dates are adjusted. Use getRouteFlightTickets for specific itineraries and all prices.

CapabilityLowest-fare calendar

Input parameters

Parameter	Type	Required	Description
depDateBegin	`string`	-	Start date of a one-way range or outbound round-trip date in yyyy-MM-dd format; defaults to tomorrow
depDateEnd	`string`	-	End date of a one-way range in yyyy-MM-dd format; defaults to the adjusted start date. Not used for round trips.
arrDate	`string`	-	Return date in yyyy-MM-dd format; required for type=2 and cannot precede the outbound date
dep	`string`	Required	Departure city or airport IATA code
arr	`string`	Required	Arrival city or airport IATA code
type	`string`	Required	1 one-way, 2 round trip

{
  "dep": "BJS",
  "arr": "CAN",
  "type": "1",
  "depDateBegin": "2026-10-01"
}

Fares & deals

Live fare filtering & comparison`getRouteFlightTickets`

Use one read-only DuckDB SELECT/WITH SQL query to find, filter, or aggregate domestic and international itineraries. flights(...) requires market, ordered legs, and cabin, using city-level IATA codes and explicit dates. Cabins: economy, premium_economy, business, first. Domestic supports one-way or standard round trips; international supports up to 6 legs, with at most 6 sources per call. Default to seg.share IS FALSE to exclude codeshares. Preserve option_id. adult_total includes taxes; missing amounts are not zero. Details appear in MCP content resource blocks; item.resource points to the URI. Reuse candidates via flight_snapshot(...) with the returned snapshot_id. Lowest fares apply only to returned candidates.

CapabilityLive fare filtering & comparison

Input parameters

Parameter	Type	Required	Description
sql	`string`	Required	One read-only SELECT/WITH SQL query using flights(...) or flight_snapshot(...); search arguments must be fixed literals

{
  "sql": "SELECT o.option_id, o.adult_total FROM flights(market := 'domestic', legs := [{'dep_city':'BJS','arr_city':'SHA','date':'2026-10-01'}], cabin := 'economy') AS o WHERE o.transfers = 0 AND o.adult_total IS NOT NULL AND EXISTS (SELECT 1 FROM UNNEST(o.legs) AS l(leg) CROSS JOIN UNNEST(leg.segments) AS s(seg) WHERE seg.share IS FALSE) ORDER BY o.adult_total, o.option_id LIMIT 3"
}

Fares & deals

Domestic route fare prediction`domesticPriceForecast`

Predict fares for a domestic route and departure date, optionally filtering by flight number. Predictions are not bookable quotes.

CapabilityDomestic route fare prediction

Input parameters

Parameter	Type	Required	Description
dep	`string`	Required	Departure city IATA code
arr	`string`	Required	Arrival city IATA code
date	`string`	Required	Departure date in yyyy-MM-dd format
flightNo	`string`	-	Flight number filter

{
  "dep": "BJS",
  "arr": "SHA",
  "date": "2026-10-02"
}

Fares & deals

Nearby international travel options`internationalNearbySuggest`

Find nearby cities, dates, and nonstop recommendations for international travel and Hong Kong, Macao, and Taiwan routes. An optional return date is supported.

CapabilityNearby international travel options

Input parameters

Parameter	Type	Required	Description
depCityCode	`string`	Required	Departure city IATA code
arrCityCode	`string`	Required	Arrival city IATA code
depDate	`string`	Required	Departure date in yyyy-MM-dd format
returnDate	`string`	-	Return date in yyyy-MM-dd format

{
  "depCityCode": "BJS",
  "arrCityCode": "TYO",
  "depDate": "2026-10-03",
  "returnDate": "2026-10-08"
}

Fares & deals

Flight fare alert`monitorFlightPrice`

Create a domestic flight fare monitor for the current user and send an SMS when the target price is reached. Future dates only. CREATED = created; DUPLICATE = already exists; LIMIT_REACHED = quota reached and no monitor created.

CapabilityFlight fare alert

Input parameters

Parameter	Type	Required	Description
depCity	`string`	Required	Departure city IATA code
arrCity	`string`	Required	Arrival city IATA code
date	`string`	Required	Flight date in yyyy-MM-dd format; today and historical dates are unsupported
flightNo	`string`	Required	Flight number
thresholdPrice	`integer`	Required	Target price in CNY; must be a positive integer

{
  "depCity": "BJS",
  "arrCity": "HFE",
  "date": "2026-10-04",
  "flightNo": "CA1501",
  "thresholdPrice": 500
}

Fares & deals

My fare monitors`flightPriceMonitorList`

Query the current user’s unexpired domestic flight fare monitors. No parameters required.

CapabilityMy fare monitors

Input parameters

Parameter	Type	Required	Description

This tool takes no parameters. Call it with an empty object.

{}

Fares & deals

Domestic direct trains`domesticDirectTrainSearch`

Find direct trains by date and departure/arrival cities, optionally filtering station-name lists at either end. Use trainDetail for seats, fares, and availability.

CapabilityDomestic direct trains

Input parameters

Parameter	Type	Required	Description
depDate	`string`	Required	Departure date in yyyy-MM-dd format
depCityName	`string`	Required	Departure city name
arrCityName	`string`	Required	Arrival city name
depStationNames	`string[]`	-	Departure station name list
arrStationNames	`string[]`	-	Arrival station name list

{
  "depDate": "2026-09-28",
  "depCityName": "北京",
  "arrCityName": "上海",
  "depStationNames": [
    "北京南"
  ],
  "arrStationNames": [
    "上海虹桥"
  ]
}

Fares & deals

Train fares & availability`trainDetail`

Query seats, fares, availability, and details using a real train number, date, and both station codes from actual search results. Optional single-transfer context is supported.

CapabilityTrain fares & availability

Input parameters

Parameter	Type	Required	Description
trainNumber	`string`	Required	Actual train number
depDate	`string`	Required	Departure date in yyyy-MM-dd format
depStationCode	`string`	Required	Departure station three-letter code
arrStationCode	`string`	Required	Arrival station three-letter code
transferContext	`object`	-	Single-transfer context

{
  "trainNumber": "G103",
  "depDate": "2026-09-28",
  "depStationCode": "VNP",
  "arrStationCode": "AOH"
}

Fares & deals

Air–rail transfer options`intermodalTransferSearch`

Find single-transfer flight and train combinations within a travel time window. Transfer references cannot be used to book flights.

CapabilityAir–rail transfer options

Input parameters

Parameter	Type	Required	Description
depCityCode	`string`	Required	Departure city-level IATA code
arrCityCode	`string`	Required	Arrival city-level IATA code
earliestDepTime	`string`	Required	Earliest departure in yyyy-MM-dd HH:mm format
latestArrTime	`string`	Required	Latest arrival in yyyy-MM-dd HH:mm format
latestDepTime	`string`	-	Latest departure in yyyy-MM-dd HH:mm format
transferType	`string[]`	-	Transfer type list
sort	`string`	-	Sort order
limit	`integer`	-	Result limit: default 20, maximum 50

{
  "depCityCode": "BJS",
  "arrCityCode": "HFE",
  "earliestDepTime": "2026-09-29 08:00",
  "latestArrTime": "2026-09-29 22:00",
  "limit": 20
}

Fares & deals

Low-fare airport routes`getAirportLowPriceRoutes`

Find low-fare routes and destination rankings from a specified airport or city.

CapabilityLow-fare airport routes

Input parameters

Parameter	Type	Required	Description
dep	`string`	Required	Departure airport or city IATA code
depDateBegin	`string`	Required	Departure date range start in yyyy-MM-dd format
depDateEnd	`string`	Required	Departure date range end in yyyy-MM-dd format

{
  "dep": "HFE",
  "depDateBegin": "2026-10-05",
  "depDateEnd": "2026-10-12"
}