Two tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. searchFlights has reasonable parameter descriptions (origin/destination airport codes, date formats), but getAirportCodes lacks any parameter descriptions (empty properties object). Neither tool documents output schema structure, making it difficult for LLMs to plan downstream operations. No error handling guidance, no idempotency hints, and no pagination support despite searchFlights potentially returning large result sets. Tool names follow verb_noun convention (positive), but descriptions are generic and lack context about when to use each tool or what to expect in responses.

• Document output schemas explicitly. For searchFlights, specify: {success: boolean, results: [{airline: string, price: number, departure: string, arrival: string, duration: string, ...}], total_count: number}. For getAirportCodes, specify: {airports: [{code: string, city: string, name: string}]}.
• Add pagination to searchFlights: introduce 'limit' (default 20, max 100) and 'offset' (default 0) parameters. Return total_count and next_offset in response so LLMs can iterate through large result sets without context explosion.
• Enhance searchFlights description: 'Search for one-way and round-trip flights across Indian travel websites (MakeMyTrip, Cleartrip, GoIbibo). Returns up to 20 results per call; use offset for more. Requires valid IATA airport codes (e.g., DEL, BOM) and dates in YYYY-MM-DD format.'
• Add error handling with recovery hints. If airport code is invalid, return: {success: false, error: 'Invalid airport code: XYZ. Call getAirportCodes() to see supported airports.'}. If date is in past, return: {success: false, error: 'Departure date must be today or later.'}.
• Add parameter descriptions to getAirportCodes (even though it has no parameters, clarify in the tool description): 'Returns a static list of 6 major Indian airports. Call this first to validate airport codes before searching flights. No parameters required.'