searchFlightsByNumber

Use this tool to search flight details by entering the flight number and date. Optional departure and arrival airport codes can refine results. Ensure date format is YYYY-MM-DD or use the getTodayDate tool for today's date.

Instructions

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.

Input Schema

Name	Required	Description
`arr`	No	Arrival airport IATA 3-letter code (e.g. CAN for Guangzhou)
`date`	Yes	Flight date in YYYY-MM-DD format. IMPORTANT: If user input only cotains month and date, you should use getTodayDate tool to get the year. For today's date, use getTodayDate tool instead of hardcoding
`dep`	No	Departure airport IATA 3-letter code (e.g. HFE for Hefei)
`fnum`	Yes	Flight number including airline code (e.g. MU2157, CZ3969)

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "arr": {
      "description": "Arrival airport IATA 3-letter code (e.g. CAN for Guangzhou)",
      "maxLength": 3,
      "minLength": 3,
      "pattern": "^[A-Z]{3}$",
      "type": "string"
    },
    "date": {
      "description": "Flight date in YYYY-MM-DD format. IMPORTANT: If user input only cotains month and date, you should use getTodayDate tool to get the year. For today's date, use getTodayDate tool instead of hardcoding",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "type": "string"
    },
    "dep": {
      "description": "Departure airport IATA 3-letter code (e.g. HFE for Hefei)",
      "maxLength": 3,
      "minLength": 3,
      "pattern": "^[A-Z]{3}$",
      "type": "string"
    },
    "fnum": {
      "description": "Flight number including airline code (e.g. MU2157, CZ3969)",
      "pattern": "^[A-Z0-9]{2,3}[0-9]{1,4}$",
      "type": "string"
    }
  },
  "required": [
    "fnum",
    "date"
  ],
  "type": "object"
}

Variflight MCP Server