@variflight-ai/tripmatch-mcp

Variflight Tripmatch MCP Server

Variflight Tripmatch MCP Server provides a set of tools to query flight and train information.

Variflight API Key

To use the Variflight Tripmatch 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/tripmatch-mcp"
            ],
            "env": {
                "VARIFLIGHT_API_KEY": "your_api_key_here"
            }
        }
    }
}

Available Tools

1. Search Flights by Departure and Arrival

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).

searchFlightsByDepArr({
  dep: "PEK",      // Departure airport IATA 3-letter code (optional)
  depcity: "BJS", // Departure city IATA 3-letter code (optional)
  arr: "SHA",      // Arrival airport IATA 3-letter code (optional)
  arrcity: "SHA",  // Arrival city IATA 3-letter code (optional)
  date: "2024-03-20" // Flight date in YYYY-MM-DD format
})

2. Search Flights by Number

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.

searchFlightsByNumber({
  fnum: "MU2157", // Flight number including airline code
  date: "2024-03-20", // Flight date in YYYY-MM-DD format
  dep: "HFE",     // Departure airport IATA 3-letter code (optional)
  arr: "CAN"      // Arrival airport IATA 3-letter code (optional)
})

3. Get Flight and Train Transfer Information

Get flight and train 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.

getFlightAndTrainTransferInfo({
  depcity: "BJS", // Departure airport IATA 3-letter code
  arrcity: "LAX", // Arrival airport IATA 3-letter code
  depdate: "2024-03-20" // Flight date in YYYY-MM-DD format
})

4. Flight Happiness Index

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.

flightHappinessIndex({
  fnum: "MU2157", // Flight number including airline code
  date: "2024-03-20", // Flight date in YYYY-MM-DD format
  dep: "HFE",     // Departure airport IATA 3-letter code (optional)
  arr: "CAN"      // Arrival airport IATA 3-letter code (optional)
})

5. Get Today's Date

Get today's date in local timezone (YYYY-MM-DD format). Use this tool whenever you need today's date - NEVER hardcode dates.

getTodayDate({})

6. Airport Weather Forecast

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).

getFutureWeatherByAirport({
  airport: "PEK" // Airport IATA 3-letter code
})

7. Search Train Tickets

Search for train tickets between two cities on a specific date. Date must be in YYYY-MM-DD format.

searchTrainTickets({
  from: "合肥", // Departure city name
  to: "北京",   // Arrival city name
  date: "2024-03-25" // Travel date in YYYY-MM-DD format
})

8. Get Flight Price By Cities

Get flight price information by departure city, arrival city, and departure date. All city codes must be valid IATA 3-letter codes (e.g. HFE for Hefei, CAN for Guangzhou). Date must be in YYYY-MM-DD format.

getFlightPriceByCities({
  dep_city: "HFE", // Departure city IATA 3-letter code
  arr_city: "CAN", // Arrival city IATA 3-letter code
  dep_date: "2024-03-25" // Departure date in YYYY-MM-DD format
})

9. Search Train Stations

Search for train stations by keyword.

searchTrainStations({
  query: "北京" // Keyword to search for train stations
})

License

ISC License - See LICENSE for details.

Author

Variflight (https://ai.variflight.com)

Version

Current version: 0.0.2