mcp-travelcode

Check if a booking can be cancelled and what the refund/penalty/deadline are. Always call this before cancel_order. Speak about 'the booking' and 'cancellation rules' to the user — never quote internal labels, REST routes, or error codes.

Check if a booking can be changed and what kinds of change are allowed (contact info, passport, rebook, baggage). Always call this before modify_order. Speak about 'the booking' and 'allowed changes' to the user — never quote internal labels, REST routes, or error codes.

Get current delay statistics for an airport on a specific date. Shows average departure/arrival delays and cancellation rates. Use this during weather events or disruptions to assess the situation at an airport.

Get the departure or arrival board for an airport within a time window (max 12 hours). Shows all flights with their status, terminals, and gates. Use this to monitor departures/arrivals or check for widespread delays.

Get detailed information about a specific airport or city by its IATA code. Returns name, city, and country.

Get full details of a saved traveler — passport documents and loyalty memberships needed for booking. Typical flow: search_clients → pick the right person → this tool → create_order. Speak about 'this traveler', 'their passport', 'their loyalty programs' to the user; never quote internal labels, RES…

Get historical delay statistics for a specific flight number. Shows how often the flight is delayed, average delay duration, and reliability assessment. Use this to evaluate a flight's punctuality before booking.

Retrieve or filter existing flight search results using a cache ID from a previous search. Apply filters (direct flights, specific airlines, price range), change sorting, or paginate through results without running a new search. Cache expires after ~15 minutes. If the originating search_flights call…

Get real-time status of a specific flight by flight number and date. Returns departure/arrival times (scheduled, actual, estimated), terminals, gates, aircraft info, and delay information. Use this to check if a flight is on time, delayed, or cancelled.

Get hotel location details by ID. Returns name and entity type (city, region, hotel).

Get full details of a booking — travelers, services, tickets, and payment status. Speak about 'the booking' to the user; never quote internal labels, REST routes, or error codes.

Get full details of a single traveler — passport, nationality, current trip with services (hotels, flights). Typical flow: search_travelers → pick a person → this tool. Speak in plain language ('this traveler', 'their passport'); never quote internal labels, REST routes, or error codes.

List the user's bookings with optional filtering by status, booking reference, traveler name, or date range. Supports paging and sorting. Speak in plain language to the user — never quote internal labels, REST routes, or error codes.

List the legal-entity companies attached to a user, for admin impersonation. Call this when another tool tells you the target user has multiple companies and you need to pick one before retrying.

Change an existing booking: contact info, passport, dates (rebook), or add baggage. Always call check_order_modification first to learn which changes are allowed for this booking. Modification is asynchronous — use get_order afterwards to confirm the result. Speak about 'the booking' and 'the change…

Search for airlines by name or IATA code. Returns matching airlines with their codes and names. Use this to find airline codes for filtering flight searches.

Search for airports by name, city, or IATA code. Returns a list of matching airports and cities with their codes. Use this to find airport codes before searching for flights.

Search for hotel locations (cities, regions, hotels) by name. Returns location IDs needed for hotel search.