Skip to main content
Glama
Variflight MCP Server

Variflight MCP Server

Official
by variflight

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 return

  • offset: number of results to skip; pass next_offset from 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 tools
flightHappinessIndexC

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

    B3.2/5.0

    Scored across 8 tools

    Disambiguation3/5

    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 Consistency2/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers