About io.github.variflight/variflight-mcp
io.github.variflight/variflight-mcp is an MCP server in the Maps category: variflight MCP Server.
Install
claude mcp add io-github-variflight-variflight-mcp -- npx -y @variflight-ai/variflight-mcpnpx -y @variflight-ai/variflight-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (9)
flightHappinessIndexUse this tool when the user wants comfort-focused details for a known flight, such as punctuality, aircraft type, cabin configuration, seat comfort, meals, entertainment, or other onboard experience details. This tool works best when a specific flight number and date are already known. Do not use it for fare search, itinerary recommendation, or raw price comparison.
Parameters not published.
getFlightPriceByCitiesUse this tool when the user needs structured raw pricing data. It returns sale flights between two cities as a list of flights, and each flight contains cabin entries with prices. This is better than searchFlightItineraries when the caller needs per-flight, per-cabin price details instead of a natural-language recommendation summary. All city codes must be valid IATA 3-letter codes (e.g. BJS for Beijing, SHA for Shanghai, CAN for Guangzhou, HFE for Hefei).
Parameters not published.
getFlightTransferInfoSearch connecting flight options between a departure city and an arrival city on a specific date. Use city IATA 3-letter codes such as BJS, SHA, or LAX. This tool is for transfer or connection itineraries between cities, not for airport weather, airport facilities, or realtime tracking. Date must be in YYYY-MM-DD format. For today
Parameters not published.
getFutureWeatherByAirportGet the 3-day airport weather forecast for today, tomorrow, and the day after tomorrow by airport IATA 3-letter code, such as PEK, SHA, CAN, or HFE.
Parameters not published.
getRealtimeLocationByAnumGet realtime flight location by aircraft registration number, also called tail number, such as B2021 or B2022. Use this only when the aircraft registration number is known. If the registration number is unknown, first try to find the flight through searchFlightsByNumber and then use the aircraft registration number from that result.
Parameters not published.
getTodayDateGet today
Parameters not published.
searchFlightItinerariesUse this tool when the user wants a concise recommended itinerary summary in natural language. It returns a text-style result that summarizes how many sale flights match, the overall lowest price, the shortest duration, and several recommended options. Use city IATA 3-letter codes only. If the user instead needs structured raw flight pricing data with each flight and cabin price, use getFlightPriceByCities.
Parameters not published.
searchFlightsByDepArrSearch direct flights by departure and arrival location plus date. Use depcity and arrcity when the user specifies cities such as BJS or SHA. Use dep and arr when the user specifies exact airports such as PEK or PVG. Provide one departure field and one arrival field, and do not mix city and airport codes for the same side. All codes must be valid IATA 3-letter codes. Date must be in YYYY-MM-DD format. For today
Parameters not published.
searchFlightsByNumberSearch a flight by flight number and date. The flight number must include the airline code, for example MU2157 or CZ3969. dep and arr are optional and should only be provided when the exact airports are known. Date must be in YYYY-MM-DD format. For today
Parameters not published.
Ask AI
Ask AI about io.github.variflight/variflight-mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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.
Variflight API Key
To use the Variflight MCP server, you need to have a Variflight API key. You can get it from here.
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"
})
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://mcp.variflight.com)
Version
Current version: 1.0.3
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.