Variflight MCP Server
OfficialVariflight MCP Server lets you query flight info, transfer options, comfort metrics, realtime aircraft location, weather, and itinerary/date data.
Search direct flights by departure/arrival airport or city and date, with optional paging/detail.
Search flights by flight number and date.
Get connecting/transfer flight options between cities.
Get flight happiness/comfort details (punctuality, aircraft, cabin, meals, entertainment).
Track realtime aircraft location by tail number.
Get today's date in YYYY-MM-DD.
Get 3-day airport weather forecast by IATA code.
Search flight itineraries with recommended options and lowest price.
README also lists a getFlightPriceByCities tool for cabin-level prices, but it is not in the provided schema.
Allows querying flight information using IATA airport codes for searching flights, retrieving transfer options, and obtaining weather forecasts at airports.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Variflight MCP Server search flights from Beijing to Shanghai on March 20th"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Variflight MCP Server
A Model Context Protocol (MCP) server implementation for VariFlight flight information services. This server provides various tools to query flight information, weather data, and flight comfort metrics.
This package is the stdio distribution of VariFlight Aviation MCP on the VariFlight AI Open Platform. Full documentation, including client setup, tool reference and pricing: ai.variflight.com/docs/aviation (中文).
Variflight API Key
To use the Variflight MCP server, you need to have a Variflight API key. Sign up at ai.variflight.com and create one in the console; new accounts receive ¥50 in trial credits.
Remote server
The same tools are available as a remote MCP server over streamable HTTP, with no local process required:
claude mcp add --transport http variflight-aviation https://ai.variflight.com/servers/aviation/mcp \
--header "X-API-Key: YOUR_API_KEY"Clients that support OAuth 2.1 can add https://ai.variflight.com/servers/aviation/mcp without a key and sign in when prompted.
Related MCP server: Aviation Weather MCP Server
Installation
{
"mcpServers": {
"variflight": {
"command": "npx",
"args": [
"-y",
"@variflight-ai/variflight-mcp"
],
"env": {
"VARIFLIGHT_API_KEY": "your_api_key_here"
}
}
}
}Available Tools
1. Search Flights by Departure and Arrival
Search direct flights by city or airport code on a specific date. Use city codes like BJS or exact airport codes like PEK, but do not mix city and airport codes for the same side:
searchFlightsByDepArr({
dep: "PEK", // Beijing
arr: "SHA", // Shanghai
date: "2024-03-20"
})2. Search Flights by Number
Search a specific flight by flight number and date:
searchFlightsByNumber({
fnum: "MU2157",
date: "2024-03-20"
})3. Get Flight Transfer Information
Search connecting flight options between departure and arrival cities:
getFlightTransferInfo({
depcity: "BJS",
arrcity: "LAX",
depdate: "2024-03-20"
})searchFlightsByDepArr and getFlightTransferInfo also accept optional paging parameters. Busy routes can return dozens of results with many fields each, so use these to keep responses small:
limit: maximum number of results to returnoffset: number of results to skip; passnext_offsetfrom the previous response to get the next page. Each page is a separate billed call.detail:"summary"returns only the core fields of each result;"full"(the default) returns every field
When any of them is set, the response also includes total, offset, returned and, if more results exist, next_offset. Without them, the response is unchanged.
searchFlightsByDepArr({
depcity: "BJS",
arrcity: "SHA",
date: "2024-03-20",
limit: 20,
detail: "summary"
})4. Flight Happiness Index
Get comfort-focused details for a known flight, such as punctuality, aircraft type, cabin configuration, meals, and entertainment:
flightHappinessIndex({
fnum: "MU2157",
date: "2024-03-20"
})5. Real-time Aircraft Location
Track realtime flight location using the aircraft registration number, also called tail number:
getRealtimeLocationByAnum({
anum: "B2021"
})6. Airport Weather Forecast
Get the 3-day airport weather forecast:
getFutureWeatherByAirport({
airport: "PEK"
})7. Search Flight Itineraries
Get a natural-language summary with recommended flight options, overall lowest price, shortest duration, and several suggested itineraries:
searchFlightItineraries({
depCityCode: "BJS", // Beijing
arrCityCode: "SHA", // Shanghai
depDate: "2025-04-20"
})8. Get Flight Prices by Cities
Get structured raw sale-flight data between two cities, with each flight returning cabin-level prices:
getFlightPriceByCities({
dep_city: "BJS", // Beijing
arr_city: "SHA", // Shanghai
dep_date: "2026-04-20"
})License
ISC License - See LICENSE for details.
Author
Variflight (https://ai.variflight.com)
Version
Current version: 1.1.0
Available Tools
8 toolsflightHappinessIndexC
using this tool when you need information related to following topics: Detailed flight comparisons (punctuality, amenities, cabin specs),Health safety protocols for air travel,Baggage allowance verification,Environmental impact assessments,Aircraft configuration visualization,Comfort-focused trip planning (seat dimensions, entertainment, food). etc.
Inputs: date (required), fnum (required), arr, dep.
getFlightTransferInfoB
Get flight transfer info by departure city and arrival city and departure date. Date format: YYYY-MM-DD. IMPORTANT: For today's date, you MUST use getTodayDate tool instead of hardcoding any date. Airport codes should be IATA 3-letter codes.
Inputs: arrcity (required), depcity (required), depdate (required).
getFutureWeatherByAirportA
Get airport future weather for 3days (today、tomorrow、the day after tomorrow) by airport IATA 3-letter code. Airport codes should be IATA 3-letter codes (e.g. PEK for Beijing, SHA for Shanghai, CAN for Guangzhou, HFE for Hefei).
Inputs: airport (required).
getRealtimeLocationByAnumA
Get flight realtime location by aircraft number. aircraft number should be Aircraft registration numberlike B2021, B2022, B2023, etc. if aircraft number is unknown, you shuold try to request it using searchFlightsByNumber tool
Inputs: anum (required).
getTodayDateA
Get today's date in local timezone (YYYY-MM-DD format). Use this tool whenever you need today's date - NEVER hardcode dates.
Inputs: random_string.
searchFlightItinerariesB
Search for purchasable flight options and the lowest price using the departure city three-letter code, arrival city three-letter code, and departure date. (e.g. BJS for Beijing, SHA for Shanghai, CAN for Guangzhou, HFE for Hefei).
Inputs: arrCityCode (required), depCityCode (required), depDate (required).
searchFlightsByDepArrA
Search for flights between airports or cities by date. For cities with multiple airports, use depcity and arrcity parameters; otherwise use dep and arr parameters. Date must be in YYYY-MM-DD format. For today's date, use the getTodayDate tool. All airport/city codes must be valid IATA 3-letter codes (e.g.BJS for city of Beijing, PEK for Beijing Capital Airport).
Inputs: date (required), arr, arrcity, dep, +1 more.
searchFlightsByNumberA
Search flights by flight number and date. Flight number should include airline code (e.g. MU2157, CZ3969). dep and arr are optional, keep empty if you don't know them. Date format: YYYY-MM-DD. IMPORTANT: For today's date, you MUST use getTodayDate tool instead of hardcoding any date. Airport codes (optional) should be IATA 3-letter codes.
Inputs: date (required), fnum (required), arr, dep.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
There is significant overlap between searchFlightItineraries, searchFlightsByDepArr, and getFlightTransferInfo, all involving flight search between locations with date parameters. However, descriptions clarify some distinctions: searchFlightItineraries focuses on purchasable options and pricing, searchFlightsByDepArr handles airport/city flexibility, and getFlightTransferInfo specifically targets transfer information. The flightHappinessIndex stands out as distinct, covering comfort and amenities rather than routing.
Naming is inconsistent with mixed conventions: flightHappinessIndex uses camelCase, while all other tools use snake_case (e.g., getFlightTransferInfo, searchFlightsByDepArr). Verb patterns vary: 'get' (getFlightTransferInfo, getFutureWeatherByAirport, getRealtimeLocationByAnum, getTodayDate) vs. 'search' (searchFlightItineraries, searchFlightsByDepArr, searchFlightsByNumber), with flightHappinessIndex lacking a clear verb. This inconsistency reduces predictability.
With 8 tools, the count is reasonable for a flight information server, covering key aspects like search, transfers, weather, location, and comfort. It's slightly on the higher side but well-scoped, as each tool addresses a specific need without obvious bloat. The domain of flight data supports this number, ensuring agents have necessary operations without being overwhelmed.
The tool set provides good coverage for flight-related queries, including search (by itinerary, departure/arrival, number), transfer info, real-time location, weather, and comfort assessments. Minor gaps exist, such as lack of tools for booking management, flight status updates beyond location, or historical data, but core workflows for information retrieval are well-covered, allowing agents to handle most common requests effectively.
Maintenance
Related MCP Connectors
航班管家 DAST 官方航空数据 MCP,支持 Remote HTTP 与 npm STDIO,提供航班动态、天气、轨迹及延误风险。Official Flight Master MCP.
Flight search MCP server providing search, pagination, and itinerary details for AI assistants.
Geo-based flight search MCP server. Find more flights between any two places on earth
Hosted MCP server for Xweather weather data: conditions, forecasts, alerts, and more.
Related MCP Servers
- AlicenseCqualityCmaintenanceA Model Context Protocol (MCP) server that provides real-time flight tracking and status information using the AviationStack API.318 npm7MIT
- AlicenseNot gradedqualityDmaintenanceProvides aviation weather information through a Model Context Protocol server, enabling access to METARs, TAFs, PIREPs, and route weather data for informational purposes only.2MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol server that provides comprehensive weather data querying capabilities based on the Caiyun Weather API, supporting real-time weather, forecasts, and alerts with multi-language support.710MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol server that provides tools to fetch weather alerts for US states and forecasts based on latitude/longitude coordinates using the US National Weather Service API.21MIT