_ registry / mcp streamable-http · checked 2h ago

turkish-airlines-mcp

https://mcp-app.turkishtechlab.com

Registry code: cd0e59b5a998cc50

api record

This agent provides tools for managing Turkish Airlines flights, bookings, baggage, and holiday packages, as well as accessing airline information and promotions.

endpoint
https://mcp-app.turkishtechlab.com/mcp
protocol
streamable-http ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing
karma
0 · newcomer
reachable
live
uptime, 30 days
100%

90 days 100%· all time 100%

latency
320ms

last good check

priced tools
0

of 23 tools

_ answered our checks, 90 days 1 checks
_ what it is for
topic
maps travel & places travel & transport
used for
  • check flight status
  • find flight prices
  • manage booking
  • check baggage allowance
  • find holiday packages
takes → gives
text, data → text, data
tools
20 reads1 changes data1 moves money1 sends messages
_ used through this hub 30 days

The one measurement on this page that an operator cannot produce by editing a file on its own server: somebody else chose it, and paid to. Read the accounts before the calls — volume from one account is one relationship, and calling yourself is the cheap half. Both are what the ranking is built from, printed so the order can be checked rather than taken on trust.

accounts
0

distinct, expensive to fake

calls served
0

successful, last 30 days

_ what it can do 23 tools
3 open 20 never probed 3 of 23 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • search_inbound_flights reads open 2h ago

    SEARCH FOR RETURN FLIGHTS (international round trips only): Call after the user picks an outbound option from search_flights. You only need to pass { searchId, optionId, recommendationId, returnDate } — searchId is returned by the preceding search_flights call and MUST be passed back verbatim; optionId and recommendationId come straight from the search_flights results; returnDate is YYYY-MM-DD. The session, outbound segments, taxes, and passengers are restored from the searchId. Do NOT fabricate or copy jSessionId, segments, or duTaxBean. Returns inbound flight options with combined round-trip pricing.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "optionId": {
      "type": "number",
      "description": "REQUIRED (normal use): the optionId of the outbound option the user chose, from the search_flights results."
    },
    "searchId": {
      "type": "string",
      "description": "REQUIRED (normal use): the searchId returned by the preceding search_flights call. Pass it back verbatim — it restores the outbound session, segments, taxes and passengers. Omit only on the widget-driven path that passes selectedOutbound explicitly."
    },
    "duTaxBean": {
      "type": "object",
      "properties": {
        "eco": {
          "type": "boolean",
          "default": true
        },
        "currency": {
          "type": "string",
          "default": "USD"
        },
        "bizAmount": {
          "type": "number",
          "default": 0
        },
        "ecoAmount": {
          "type": "number",
          "default": 0
        },
        "ajEcoAmount": {
          "type": "number",
          "default": 0
        },
        "useTKAmount": {
          "type": "boolean",
          "default": false
        },
        "passengerCount": {
          "type": "number",
          "default": 0
        }
      },
      "description": "Optional; restored from the previous search."
    },
    "jSessionId": {
      "type": "string",
      "description": "Optional; restored from the previous search. Do NOT fabricate."
    },
    "pageTicket": {
      "type": "string",
      "description": "Optional; restored from the previous search."
    },
    "passengers": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "passengerType",
          "quantity"
        ],
        "properties": {
          "quantity": {
            "type": "integer",
            "maximum": 9,
            "minimum": 1
          },
          "passengerType": {
            "enum": [
              "ADT",
              "CHD",
              "INF",
              "YAD",
              "SRC",
              "STD",
              "CNS",
              "STU",
              "DIS",
              "VET",
              "TEACHER",
              "SOLDIER",
              "SENIOR",
              "YOUNGADULT"
            ],
            "type": "string"
          }
        }
      },
      "description": "Optional; defaults to the passengers from the original search."
    },
    "returnDate": {
      "type": "string",
      "description": "Return (inbound) departure date in YYYY-MM-DD. Must be today or a future date. Defaults to the returnDate from the original round-trip search."
    },
    "recommendationId": {
      "type": "number",
      "description": "REQUIRED (normal use): the recommendationId of the chosen fare for that option, from the search_flights results."
    },
    "selectedOutbound": {
      "type": "object",
      "required": [
        "optionId",
        "recommendationId",
        "segments",
        "fareFamily"
      ],
      "properties": {
        "optionId": {
          "type": "number"
        },
        "segments": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "departureAirportCode",
              "arrivalAirportCode",
              "departureDateTime",
              "arrivalDateTime",
              "flightCode",
              "resBookDesigCode",
              "fareBasisCode",
              "brandCode",
              "cabinType"
            ],
            "properties": {
              "rph": {
                "type": "string"
              },
              "brandCode": {
                "type": "string",
                "description": "Brand code from the selected fare (e.g., 'ECOFLY', 'BUSINESSFLEX')"
              },
              "cabinType": {
                "enum": [
                  "ECONOMY",
                  "BUSINESS",
                  "FIRST"
                ],
                "type": "string",
                "description": "Cabin class"
              },
              "equipment": {
                "type": "string"
              },
              "flightCode": {
                "type": "object",
                "required": [
                  "airlineCode",
                  "flightNumber"
                ],
                "properties": {
                  "airlineCode": {
                    "type": "string",
                    "description": "Airline code (e.g., 'TK')"
                  },
                  "flightNumber": {
                    "type": "string",
                    "description": "Flight number (e.g., '1')"
                  }
                }
              },
              "fareBasisCode": {
                "type": "string",
                "description": "Fare basis code from the selected fare (e.g., 'YLOW')"
              },
              "arrivalDateTime": {
                "type": "string",
                "description": "Arrival date/time from search_flights response"
              },
              "resBookDesigCode": {
                "type": "string",
                "description": "Booking class code from the selected fare (e.g., 'Y', 'C')"
              },
              "departureDateTime": {
                "type": "string",
                "description": "Departure date/time from search_flights response"
              },
              "arrivalAirportCode": {
                "type": "string",
                "maxLength": 3,
                "minLength": 3,
                "description": "Arrival airport IATA code"
              },
              "departureAirportCode": {
                "type": "string",
                "maxLength": 3,
                "minLength": 3,
                "description": "Departure airport IATA code"
              },
              "operatingAirlineCode": {
                "type": "string"
              },
              "journeyDurationInMilis": {
                "type": "number"
              }
            }
          },
          "minItems": 1
        },
        "fareFamily": {
          "enum": [
            "ECONOMY",
            "BUSINESS",
            "FIRST"
          ],
          "type": "string"
        },
        "inboundFlightId": {
          "type": "number",
          "default": 0
        },
        "recommendationId": {
          "type": "number"
        }
      },
      "description": "Optional full outbound selection (widget path). Restored from cache when omitted."
    },
    "originDestinations": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "originAirportCode",
          "destinationAirportCode",
          "departureDateTime"
        ],
        "properties": {
          "departureDateTime": {
            "type": "string",
            "description": "Return departure date in YYYY-MM-DD format"
          },
          "originAirportCode": {
            "type": "string",
            "maxLength": 3,
            "minLength": 3,
            "description": "Origin airport for the return leg"
          },
          "destinationAirportCode": {
            "type": "string",
            "maxLength": 3,
            "minLength": 3,
            "description": "Destination airport for the return leg"
          }
        }
      },
      "description": "Optional override of the return leg(s); defaults to the reverse of the outbound leg with returnDate."
    }
  }
}
    arguments 251 lines
  • generate_baggage_issue_link reads open 2h ago

    Generate a direct link to the official Turkish Airlines baggage issue tracing form, localized to the user's language. Use when the user reports a baggage problem (lost, damaged, delayed) and wants to file a formal claim. Does NOT handle existing baggage case status (use a future case-status tool) or baggage allowance (use get_booking_baggage_allowance).

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "language": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "description": "The user's language code (e.g., 'en', 'tr', 'fr', 'de'). Defaults to 'en'."
    }
  }
}
    arguments 12 lines
  • get_contact_info reads open 2h ago

    Get how to reach Turkish Airlines in a specific country: the call-center phone number by default, and — only when a city is given — the sales/ticket offices in that city (address and working hours). Use when the user asks for a Turkish Airlines phone number, call center, or office. Pass the country as a 2-letter ISO code (e.g. 'DE' for Germany); if omitted, the user's own location is used. Add the 'city' argument ONLY when the user asks about an office in a specific city (e.g. 'Turkish Airlines office in Istanbul') — leave it out for a general contact request. Does NOT handle bookings, baggage cases, or feedback.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 60,
      "minLength": 2,
      "description": "City name to look up Turkish Airlines sales/ticket office details in (e.g. 'Istanbul', 'Berlin'). Pass this ONLY when the user asks about a physical office in a specific city. If omitted, just the country's call-center number is returned — do not request every office."
    },
    "countryCode": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "2-letter ISO country code of the country the user wants to contact Turkish Airlines in (e.g. 'DE' for Germany, 'GB' for the UK). Convert the country name to its ISO code yourself. If omitted, the user's own location is used."
    }
  }
}
    arguments 17 lines
  • search_thy_faq reads unknown never probed

    Look up Turkish Airlines' official FAQ answers for a topic. Use this when the user asks a general how-to or policy question about the airline that you should answer from official content rather than from memory — cabin/checked baggage rules, check-in, cancellations and changes, fare rules, pets, infants and children, visas and travel requirements, seats, lounges, and more. Choose the single closest 'topic' from the schema's fixed category list, then answer the user only from the returned questions; do not invent details beyond them. This returns reference text (no card). Does NOT check a specific booking, baggage case, or feedback status.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "topic"
  ],
  "properties": {
    "topic": {
      "enum": [
        "Disabled passengers",
        "Infants and children",
        "Martyrs relatives and Veterans",
        "Pregnant Passengers",
        "Special Assistance",
        "Students",
        "Ticket process in the event of a death",
        "Transfer transit passengers",
        "Cabin baggage",
        "Free baggage",
        "Excess baggage",
        "Lost and delayed baggage",
        "Restrictions",
        "US baggage rules",
        "Turkish Airlines Holidays",
        "TCC Advantages",
        "TCC Application",
        "Miles&Smiles Elite Corporate Card",
        "Online Portal",
        "TCC Membership",
        "TK Wallet",
        "Reservations and bookings",
        "Check-in",
        "Flight Cancelations and Change",
        "Flight packages for domestic flights",
        "Flight packages for International flights",
        "Hold the price",
        "Mobile",
        "Taking Photos and Videos",
        "Visa and travel requirements",
        "As You Wish",
        "Dining Onboard",
        "Inflight entertainment",
        "In-flight Wifi",
        "PressReader",
        "Special meals",
        "Turkish Airlines Lounges",
        "Business upgrade",
        "Car rental",
        "E-Visa",
        "Extra legroom seat",
        "Hotel",
        "Seat selection",
        "Travel insurance",
        "Turkish Airlines Gift Card",
        "Musical instruments",
        "Sports equipment",
        "Traveling with pets",
        "Fare rules",
        "Payment"
      ],
      "type": "string",
      "description": "The Turkish Airlines FAQ category that best fits the user's question. Pick the single closest category from the list."
    }
  }
}
    arguments 65 lines
  • create_business_upgrade_payment_link moves money unknown never probed

    Final step of the Business upgrade flow: register the option the user picked with Turkish Airlines and return the link where they complete it — the card checkout page, or the Miles&Smiles offers page for miles upgrades. Call only after get_business_upgrade_offers, using an `optionId` and a `paymentType` taken verbatim from its result. The user pays on turkishairlines.com; this tool charges nothing and does not change the booking by itself.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "bookingReference",
    "surname",
    "optionId",
    "paymentType"
  ],
  "properties": {
    "surname": {
      "type": "string",
      "pattern": "^[A-Za-z\\s'-]+$",
      "maxLength": 50,
      "minLength": 2,
      "description": "The passenger's surname (last name)"
    },
    "language": {
      "enum": [
        "tr",
        "en"
      ],
      "type": "string",
      "description": "User's language for the localized payment page. Defaults to the client locale, then 'en'."
    },
    "optionId": {
      "type": "string",
      "minLength": 1,
      "description": "The `optionId` of the option the user picked, copied verbatim from a get_business_upgrade_offers result (e.g. 'individual:5' or 'all_flights:5-6')."
    },
    "paymentType": {
      "enum": [
        "CREDIT_CARD",
        "MILES"
      ],
      "type": "string",
      "description": "How the user wants to pay for the upgrade. Must be one of the paymentTypes offered on that option."
    },
    "bookingReference": {
      "type": "string",
      "maxLength": 14,
      "minLength": 6,
      "description": "The booking reference: either a 6-character PNR (alphanumeric) or 10-14 digit e-ticket number. Examples: 'S4CSWP' or '2352270968431'"
    }
  }
}
    arguments 46 lines
  • flight-status reads unknown never probed

    CHECK EXISTING FLIGHT STATUS: Use this tool ONLY when the user wants to check the real-time status of a specific existing flight (e.g., 'check status of TK289', 'is flight TK001 on time?', 'what's the gate for TK815?'). This tool requires a specific flight number. DO NOT use this for searching/bookable flights - use 'search_flights' instead. This tool fetches real-time flight status information including departure/arrival times, gate, terminal, and current flight status (on time, delayed, landed, etc.).

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "flightNumber"
  ],
  "properties": {
    "flightDate": {
      "type": "string",
      "description": "The flight date in YYYY-MM-DD format (e.g., 2025-01-15). Defaults to today if not provided."
    },
    "flightTime": {
      "type": "string",
      "description": "Optional flight time in HH:mm format (24-hour, e.g., 14:30)."
    },
    "flightNumber": {
      "type": "string",
      "description": "The flight number to check (e.g., TK001, TK815). Must include airline code."
    }
  }
}
    arguments 21 lines
  • flight-status-by-route reads unknown never probed

    CHECK FLIGHT STATUS BY ROUTE: Use this tool ONLY when the user wants to check the real-time status of flights on a specific route for a specific date (e.g., 'what flights are flying from IST to SFO today?', 'check flights from Istanbul to San Francisco tomorrow'). This tool shows the status of flights that are already scheduled/flying on that route. DO NOT use this for searching/bookable flights or finding available flights to book - use 'search_flights' instead. This tool fetches real-time flight status information for flights on a given route and date.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "fromAirport",
    "toAirport"
  ],
  "properties": {
    "toAirport": {
      "type": "string",
      "description": "The 3-letter IATA code for the arrival airport (e.g., JFK)."
    },
    "flightDate": {
      "type": "string",
      "description": "The flight date in YYYY-MM-DD format (e.g., 2025-01-15). Defaults to today if not provided."
    },
    "fromAirport": {
      "type": "string",
      "description": "The 3-letter IATA code for the departure airport (e.g., IST)."
    }
  }
}
    arguments 22 lines
  • search_flights reads unknown never probed

    SEARCH FOR BOOKABLE FLIGHTS: Searches Turkish Airlines flights and returns available options with prices. Provide from, to, departureDate, passengers, and tripType. For round trips, also provide returnDate. For multi-city, use originDestinations array instead of from/to/departureDate. IMPORTANT — next step depends on trip type: (1) INTERNATIONAL round trip: returns outbound only — after user selects, call 'search_inbound_flights' for return flights. (2) DOMESTIC round trip: returns both outbound and inbound — do NOT call 'search_inbound_flights'. (3) One-way: returns all needed information. DO NOT use this for checking flight status — use flight-status tools instead.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "from",
    "to",
    "departureDate"
  ],
  "properties": {
    "to": {
      "type": "string",
      "maxLength": 3,
      "minLength": 3,
      "description": "Destination airport IATA code (e.g., 'SFO')"
    },
    "from": {
      "type": "string",
      "maxLength": 3,
      "minLength": 3,
      "description": "Origin airport IATA code (e.g., 'IST')"
    },
    "tripType": {
      "enum": [
        "one_way",
        "round",
        "multi"
      ],
      "type": "string",
      "description": "Inferred automatically: 'round' if returnDate is provided, 'one_way' otherwise. Only specify for multi-city."
    },
    "fareFamily": {
      "type": "string",
      "maxLength": 20,
      "description": "Fare family / cabin class code to filter results (e.g., 'CL', 'BF'). Optional."
    },
    "passengers": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "passengerType",
          "quantity"
        ],
        "properties": {
          "quantity": {
            "type": "integer",
            "maximum": 9,
            "minimum": 1,
            "description": "Number of passengers of this specific type. Must be between 1 and 9. Example: 1"
          },
          "passengerType": {
            "enum": [
              "ADT",
              "CHD",
              "INF",
              "YAD",
              "SRC",
              "STD",
              "CNS",
              "STU",
              "DIS",
              "VET",
              "TEACHER",
              "SOLDIER",
              "SENIOR",
              "YOUNGADULT"
            ],
            "type": "string",
            "description": "Passenger type code. Common types: 'ADT' (Adult), 'CHD' (Child), 'INF' (Infant). Special types: 'DIS' (Disabled), 'VET' (Veteran), 'TEACHER', 'SOLDIER', 'SENIOR', 'YOUNGADULT'. Ensure to use a valid type from the allowed list."
          }
        },
        "description": "Specifies the type and quantity of passengers."
      },
      "description": "Passenger list. Defaults to 1 adult if omitted. Example: [{\"passengerType\": \"ADT\", \"quantity\": 1}]"
    },
    "returnDate": {
      "type": "string",
      "description": "Return date in YYYY-MM-DD format. Provide for round trips. If omitted, search is one-way. Must be today or a future date."
    },
    "departureDate": {
      "type": "string",
      "description": "Departure date in YYYY-MM-DD format (e.g., '2026-11-15'). Must be today or a future date."
    }
  }
}
    arguments 85 lines
  • get_city_guide reads unknown never probed

    Get a travel guide for a destination city, including what to see, where to go, transportation information, weather, and more. Use this when the user asks about a destination city, wants travel tips, or needs information about a place they're visiting.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cityCode"
  ],
  "properties": {
    "cityCode": {
      "type": "string",
      "pattern": "^[A-Z]+$",
      "maxLength": 5,
      "minLength": 3,
      "description": "The IATA or city code for the arrival city (e.g., IST, LON, NYC)"
    },
    "departureCityCode": {
      "type": "string",
      "pattern": "^[A-Z]+$",
      "maxLength": 5,
      "minLength": 3,
      "description": "Optional IATA or city code for the departure city (e.g., ANK, FRA)"
    }
  }
}
    arguments 23 lines
  • get_airline_promotions reads unknown never probed

    Fetch airline promotions. Inputs: country, airports. Use this when the user asks about promotions, special offers, or discounted flights.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "departureAirportCode"
  ],
  "properties": {
    "type": {
      "enum": [
        "1",
        "2"
      ],
      "type": "string",
      "default": "2",
      "description": "The type of promotions to retrieve (1 for main, 2 for all)."
    },
    "visa": {
      "type": "boolean",
      "default": true,
      "description": "Whether to filter promotions that require a visa."
    },
    "countryCode": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2,
      "description": "The 2-letter ISO country code to filter promotions (e.g., TR, DE)."
    },
    "arrivalContinent": {
      "type": "string",
      "description": "Continent name for the arrival continent (e.g. Asia, Europe)."
    },
    "arrivalAirportCode": {
      "type": "string",
      "description": "The 3-letter IATA code for the arrival airport (e.g., FRA) or empty string."
    },
    "departureAirportCode": {
      "type": "string",
      "maxLength": 3,
      "minLength": 3,
      "description": "REQUIRED. The 3-letter IATA code for the departure airport the promotions depart from (e.g., IST). The upstream promotions service returns no results without it — ask the user which city they are flying from if it is not known."
    }
  }
}
    arguments 43 lines
  • get_booking_details reads unknown never probed

    Retrieve detailed information about a flight booking using PNR or E-ticket number. Returns passenger details, flight segments, and status. Use this when the user wants to check their reservation, find their ticket number, or see flight details for a specific booking.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "bookingReference",
    "surname"
  ],
  "properties": {
    "surname": {
      "type": "string",
      "pattern": "^[A-Za-z\\s'-]+$",
      "maxLength": 50,
      "minLength": 2,
      "description": "The passenger's surname (last name)"
    },
    "language": {
      "type": "string",
      "default": "EN",
      "maxLength": 2,
      "minLength": 2,
      "description": "Language code for results, e.g., 'TR' for Turkish, 'EN' for English."
    },
    "bookingReference": {
      "type": "string",
      "maxLength": 14,
      "minLength": 6,
      "description": "The booking reference: either a 6-character PNR (alphanumeric) or 10-14 digit e-ticket number. Examples: 'S4CSWP' or '2352270968431'"
    }
  }
}
    arguments 30 lines
  • get_booking_baggage_allowance reads unknown never probed

    Fetch detailed booking baggage information. Tip: Call get_booking_details tool to retrieve the ticket number if not provided. Use this when the user asks about baggage allowance, baggage limits, or extra baggage for their booking.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "bookingReference",
    "surname"
  ],
  "properties": {
    "surname": {
      "type": "string",
      "pattern": "^[A-Za-z\\s'-]+$",
      "maxLength": 50,
      "minLength": 2,
      "description": "The passenger's surname (last name)"
    },
    "bookingReference": {
      "type": "string",
      "maxLength": 14,
      "minLength": 6,
      "description": "The booking reference: either a 6-character PNR (alphanumeric) or 10-14 digit e-ticket number. Examples: 'S4CSWP' or '2352270968431'"
    }
  }
}
    arguments 23 lines
  • manage_booking_link reads unknown never probed

    Validate a booking by PNR + surname and return the deeplink for the user to manage the reservation OR start online check-in on turkishairlines.com. Use this whenever the user wants to cancel, refund, rebook, change, upgrade, add services, add/remove passengers, OR check in online. Set linkType='manage' for booking changes; 'checkin' for online check-in. Do NOT preemptively send users to the website or call center before trying this tool.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "bookingReference",
    "surname",
    "linkType"
  ],
  "properties": {
    "surname": {
      "type": "string",
      "pattern": "^[A-Za-z\\s'-]+$",
      "maxLength": 50,
      "minLength": 2,
      "description": "The passenger's surname (last name)"
    },
    "language": {
      "type": "string",
      "maxLength": 5,
      "minLength": 2,
      "description": "User's language code (e.g., 'en', 'tr'). Defaults to 'en'."
    },
    "linkType": {
      "enum": [
        "manage",
        "checkin"
      ],
      "type": "string",
      "description": "'manage' for general booking changes (cancel, change, upgrade, add services); 'checkin' for online check-in."
    },
    "bookingReference": {
      "type": "string",
      "maxLength": 14,
      "minLength": 6,
      "description": "The booking reference: either a 6-character PNR (alphanumeric) or 10-14 digit e-ticket number. Examples: 'S4CSWP' or '2352270968431'"
    }
  }
}
    arguments 38 lines
  • generate_holidays_search_link reads unknown never probed

    Generate a Turkish Airlines Holidays link for Flight + Hotel packages on a specific round trip. The user clicks through to browse and book matching packages with their route, dates and travellers pre-filled. Use when the user's ORIGIN is known (stated, or from a prior flight search or booking) and they want holiday packages, campaigns or flight+hotel deals for a route — including as an upsell after a flight search. Prefer 3-letter IATA codes (originAirportCode/destinationAirportCode — the same codes as search_flights and find_flight_price_calendar); English city names (originCity/destinationCity) are a fallback resolved server-side. Children are supported via their ages. Does NOT return package data or prices (the link does) — to show actual packages without an origin (browse by destination, budget or star rating), use search_hotel_packages instead. Does NOT handle flight-only search (use search_flights).

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "departureDate",
    "returnDate"
  ],
  "properties": {
    "rooms": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "adults"
        ],
        "properties": {
          "adults": {
            "type": "integer",
            "maximum": 6,
            "minimum": 1,
            "description": "Number of adults (17+) in this room."
          },
          "childAges": {
            "type": "array",
            "items": {
              "type": "integer",
              "maximum": 17,
              "minimum": 0
            },
            "maxItems": 4,
            "description": "Ages of children in this room at the time of travel. Omit or empty if none."
          }
        }
      },
      "maxItems": 4,
      "minItems": 1,
      "description": "Room and guest configuration. Defaults to one room with 2 adults."
    },
    "cabinClass": {
      "enum": [
        "ECONOMY",
        "BUSINESS"
      ],
      "type": "string",
      "description": "Flight cabin class. Defaults to ECONOMY. Only applies to non-Türkiye origins; ignored (with a note in the result) for Türkiye-origin trips."
    },
    "originCity": {
      "type": "string",
      "maxLength": 60,
      "minLength": 2,
      "description": "Departure city or airport as an English name (e.g. 'Berlin', 'New York'), resolved server-side. Use only when originAirportCode is not known; one of the two is required."
    },
    "returnDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Return date, ISO format 'YYYY-MM-DD'. Must be after departureDate (holidays are round trip only)."
    },
    "departureDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Outbound date, ISO format 'YYYY-MM-DD'. Must not be in the past."
    },
    "destinationCity": {
      "type": "string",
      "maxLength": 60,
      "minLength": 2,
      "description": "Destination city or airport as an English name, resolved server-side. Use only when destinationAirportCode is not known; one of the two is required."
    },
    "originAirportCode": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Origin airport IATA code (e.g. 'IST') — the same code used by search_flights and find_flight_price_calendar. Preferred: the link can be generated even when the location service is unavailable."
    },
    "destinationAirportCode": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Destination airport IATA code (e.g. 'AYT'). Preferred over destinationCity."
    }
  }
}
    arguments 80 lines
  • pnr_finder sends messages unknown never probed

    Securely recover a forgotten PNR by triggering Turkish Airlines to send it via SMS or email to the contact on file. Use when the user has lost their booking reference and remembers the flight + passenger details. For security, the PNR is NEVER displayed in chat — it is only sent to the registered phone/email. After this succeeds, ask the user to check their inbox/SMS, then use get_booking_details once they have it.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "flightInfo",
    "passengerDetails"
  ],
  "properties": {
    "flightInfo": {
      "type": "object",
      "required": [
        "date",
        "departureCode",
        "arrivalCode"
      ],
      "properties": {
        "date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
          "description": "Flight date in YYYY-MM-DD format (e.g. 2026-07-15)."
        },
        "arrivalCode": {
          "type": "string",
          "pattern": "^[A-Za-z]{3}$",
          "description": "Arrival airport IATA code (e.g. JFK)."
        },
        "departureCode": {
          "type": "string",
          "pattern": "^[A-Za-z]{3}$",
          "description": "Departure airport IATA code (e.g. IST)."
        }
      },
      "description": "Flight details for the booking the user is trying to recover."
    },
    "passengerDetails": {
      "type": "object",
      "required": [
        "firstName",
        "lastName",
        "mobileNumber"
      ],
      "properties": {
        "lastName": {
          "type": "string",
          "pattern": "^[A-Za-z\\s'-]+$",
          "minLength": 1,
          "description": "Passenger surname."
        },
        "firstName": {
          "type": "string",
          "pattern": "^[A-Za-z\\s'-]+$",
          "minLength": 1,
          "description": "Passenger first name."
        },
        "emailAddress": {
          "type": "string",
          "format": "email",
          "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
          "description": "Email address registered with the booking. Optional but recommended."
        },
        "mobileNumber": {
          "type": "string",
          "pattern": "^[0-9]+$",
          "description": "Contact number with country code, digits only (e.g. 905557627052)."
        }
      },
      "description": "Passenger identity and contact information used to verify ownership."
    }
  }
}
    arguments 70 lines
  • find_flight_price_calendar reads unknown never probed

    Find the cheapest fares around a target departure date for one travel leg. Ideal when the user is flexible with dates and wants to find the best price. For ROUND_TRIP, call once for the outbound (isReturnFlight=false). After the user picks an outbound date, call again with isReturnFlight=true and departureDate set to that chosen outbound date to get the return-date calendar. Use BEFORE search_flights when the user asks for 'cheapest', 'best price', or has flexible dates.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "originAirportCode",
    "destinationAirportCode",
    "departureDate"
  ],
  "properties": {
    "tripType": {
      "enum": [
        "ONE_WAY",
        "ROUND_TRIP"
      ],
      "type": "string",
      "default": "ONE_WAY",
      "description": "'ONE_WAY' prices a single leg; 'ROUND_TRIP' prices each date as a full round-trip estimate (seeded by stayDuration)."
    },
    "timeRange": {
      "enum": [
        "1_WEEK",
        "2_WEEKS",
        "3_WEEKS",
        "4_WEEKS"
      ],
      "type": "string",
      "default": "2_WEEKS",
      "description": "How many days after the anchor date to include (the API returns up to a month)."
    },
    "cabinClass": {
      "enum": [
        "ECONOMY",
        "BUSINESS"
      ],
      "type": "string",
      "default": "ECONOMY",
      "description": "Fare cabin class."
    },
    "stayDuration": {
      "type": "integer",
      "default": 14,
      "maximum": 60,
      "minimum": 1,
      "description": "Round-trip only: nights at the destination, used to seed the round-trip price estimate. Ignored for ONE_WAY."
    },
    "departureDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Anchor date in YYYY-MM-DD; the calendar returns fares for a range of dates around it. Must be today or later. For the OUTBOUND leg (isReturnFlight=false) this is the desired departure date. For the RETURN leg (isReturnFlight=true) set it to the OUTBOUND date the user already chose — the calendar then returns candidate return dates (always on or after that outbound date)."
    },
    "isReturnFlight": {
      "type": "boolean",
      "default": false,
      "description": "false = outbound calendar; true = return-date calendar for an already-chosen outbound. Only meaningful when tripType is ROUND_TRIP."
    },
    "originAirportCode": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Origin airport IATA code (e.g. IST)."
    },
    "destinationAirportCode": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Destination airport IATA code (e.g. JFK)."
    }
  }
}
    arguments 67 lines
  • search_hotel_packages reads unknown never probed

    Browse Turkish Airlines Holiday packages (Flight + Hotel, Tours, Circuits) from the catalog. Use when the user asks about holiday packages, all-inclusive trips, flight+hotel deals, or wants recommendations with constraints (destination, budget, star rating, trip type). Specify the locale matching the user's market (e.g. en-US, de-DE, fr-FR). Country and resort filters MUST be in the locale's language. Returns a curated list with prices, hotel ratings, and direct booking links.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "locale"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 8,
      "maximum": 20,
      "minimum": 1,
      "description": "Maximum number of packages to return."
    },
    "locale": {
      "enum": [
        "en-GB",
        "fr-FR",
        "de-DE",
        "tr-DE",
        "it-IT",
        "de-AT",
        "tr-AT",
        "en-BE",
        "fr-BE",
        "nl-BE",
        "nl-NL",
        "es-ES",
        "de-CH",
        "en-CH",
        "fr-CH",
        "en-US",
        "en-CA",
        "en-IE",
        "en-DK",
        "fr-LU",
        "en-PL",
        "en-RO",
        "en-SE"
      ],
      "type": "string",
      "description": "Market locale for the catalog (e.g. 'en-US', 'de-DE', 'fr-FR'). Determines language, currency, and which products are available."
    },
    "resort": {
      "type": "string",
      "minLength": 2,
      "description": "Resort or city name in the locale's language. Optional partial match."
    },
    "country": {
      "type": "string",
      "minLength": 2,
      "description": "Destination country name in the locale's language (e.g. 'Egypt' for en-US, 'Ägypten' for de-DE). Optional partial match."
    },
    "maxPrice": {
      "type": "number",
      "description": "Maximum total price per person (with flights) in the locale's currency.",
      "exclusiveMinimum": 0
    },
    "minStars": {
      "anyOf": [
        {
          "type": "number",
          "const": 3
        },
        {
          "type": "number",
          "const": 4
        },
        {
          "type": "number",
          "const": 5
        }
      ],
      "description": "Minimum hotel star rating."
    },
    "maxNights": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Maximum number of nights.",
      "exclusiveMinimum": 0
    },
    "minNights": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Minimum number of nights.",
      "exclusiveMinimum": 0
    },
    "experience": {
      "enum": [
        "Hotel",
        "Circuit",
        "Hotel + Activity"
      ],
      "type": "string",
      "description": "'Hotel' = stay only, 'Circuit' = multi-stop tour, 'Hotel + Activity' = stay with included excursions."
    }
  }
}
    arguments 98 lines
  • get_baggage_case_details reads unknown never probed

    Look up the status of an EXISTING baggage issue case using its case number and the email it was filed with. Use when the user asks to check on a previously reported lost/damaged/delayed baggage case. Does NOT file a new report (use generate_baggage_issue_link) or answer allowance questions (use get_booking_baggage_allowance). After showing the status, you may offer to add a message with add_message_to_baggage_case.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "caseId",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "The email address associated with the baggage case."
    },
    "caseId": {
      "type": "string",
      "pattern": "^\\d{6,}$",
      "description": "The baggage case number, e.g. '2024209652'."
    }
  }
}
    arguments 21 lines
  • add_message_to_baggage_case changes data unknown never probed

    Add a new message to an EXISTING baggage issue case. This posts to the case on the customer's behalf, so only call it after the user has written the message they want to send. Requires the case number (look it up first with get_baggage_case_details if unsure) and the message text.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "caseId",
    "message"
  ],
  "properties": {
    "caseId": {
      "type": "string",
      "pattern": "^\\d{6,}$",
      "description": "The baggage case number, e.g. '2024209652'."
    },
    "message": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "The message to add to the baggage case thread."
    }
  }
}
    arguments 21 lines
  • get_feedback_status reads unknown never probed

    Check the status of a previously submitted feedback or complaint using its reference number (format: tk-12345678; the tk- prefix is optional). Use when the user asks about the status of their feedback, complaint, or application. Does NOT submit new feedback (direct them to feedback.turkishairlines.com) or check baggage cases (use get_baggage_case_details).

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "referenceNumber"
  ],
  "properties": {
    "referenceNumber": {
      "type": "string",
      "pattern": "^\\s*(tk-?)?\\d{4,}\\s*$",
      "description": "The feedback/complaint reference number, e.g. 'tk-12345678'. The 'tk-' prefix is optional."
    }
  }
}
    arguments 14 lines
  • check_stopover_eligibility reads unknown never probed

    Check whether an EXISTING booking qualifies for Turkish Airlines' Stopover in Istanbul program (a free İstanbul hotel on a qualifying layover). Requires the booking reference (PNR or e-ticket) and passenger surname. For route-level questions without a booking, use check_stopover_routes instead.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "bookingReference",
    "surname"
  ],
  "properties": {
    "surname": {
      "type": "string",
      "pattern": "^[A-Za-z\\s'-]+$",
      "maxLength": 50,
      "minLength": 2,
      "description": "The passenger's surname (last name)"
    },
    "bookingReference": {
      "type": "string",
      "maxLength": 14,
      "minLength": 6,
      "description": "The booking reference: either a 6-character PNR (alphanumeric) or 10-14 digit e-ticket number. Examples: 'S4CSWP' or '2352270968431'"
    }
  }
}
    arguments 23 lines
  • check_stopover_routes reads unknown never probed

    Check whether one or more routes (origin → destination, transiting Istanbul) qualify for the Stopover in Istanbul accommodation program — without a specific booking. Use when the user asks whether stopovers are available on a given route or which destinations qualify. For a specific booking, use check_stopover_eligibility instead.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "routes"
  ],
  "properties": {
    "routes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "origin",
          "destination"
        ],
        "properties": {
          "origin": {
            "type": "string",
            "pattern": "^[A-Za-z]{3}$",
            "description": "Origin airport IATA code (e.g. LHR)."
          },
          "destination": {
            "type": "string",
            "pattern": "^[A-Za-z]{3}$",
            "description": "Final destination IATA code (e.g. JFK). The journey is assumed to transit Istanbul."
          }
        }
      },
      "maxItems": 10,
      "minItems": 1,
      "description": "Origin→destination pairs to check for the Stopover in Istanbul program. Each is assumed to connect through IST."
    }
  }
}
    arguments 34 lines
  • get_business_upgrade_offers reads unknown never probed

    Check whether an existing booking can be upgraded to Business Class and return the current offers — per flight, per payment method (credit card or Miles&Smiles miles), with prices for all passengers on the booking. Use whenever the user asks to upgrade to Business, asks the price of an upgrade, or asks whether an upgrade is available for their PNR. Offers are session-bound and change over time: always call this first, then pass the chosen `optionId` + `paymentType` to create_business_upgrade_payment_link. Does NOT perform the upgrade or take payment.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "bookingReference",
    "surname"
  ],
  "properties": {
    "surname": {
      "type": "string",
      "pattern": "^[A-Za-z\\s'-]+$",
      "maxLength": 50,
      "minLength": 2,
      "description": "The passenger's surname (last name)"
    },
    "language": {
      "enum": [
        "tr",
        "en"
      ],
      "type": "string",
      "description": "User's language for the offer copy and the fallback links. Defaults to the client locale, then 'en'."
    },
    "bookingReference": {
      "type": "string",
      "maxLength": 14,
      "minLength": 6,
      "description": "The booking reference: either a 6-character PNR (alphanumeric) or 10-14 digit e-ticket number. Examples: 'S4CSWP' or '2352270968431'"
    }
  }
}
    arguments 31 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/cd0e59b5a998cc50/badge.svg)](https://brick.blue/agent/cd0e59b5a998cc50)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Own the domain? Prove it and the listing carries a verified badge here too: passport.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.