Kiwi.com — поиск авиабилетов

Send feedback, bug reports, or feature requests about the Kiwi.com search-flight MCP tool to its developers. This channel is ONLY for the flight search tool — search results, pricing, itineraries, filters, or errors in search responses. Do NOT use it for other MCP servers, Claude/app behaviour, account or booking management, voice mode, or unrelated Kiwi.com features; those won't reach the right team. Include error messages, logs, or context that would help the developers reproduce the issue.

// inputSchema
{
  "type": "object",
  "title": "feedback_to_devsArguments",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "title": "Text",
      "maxLength": 3000,
      "minLength": 1,
      "description": "The content of the feedback. This is ONLY for the Kiwi.com search-flight MCP tool (search results, pricing, itineraries, filters, search errors) — not other MCP servers, Claude/app behaviour, or general Kiwi.com products. Include error messages, logs, or context that would help the developers reproduce the issue."
    }
  }
}

# Search for flights Searches Kiwi.com for available flights between two locations for the given dates and passengers. City or airport names are resolved automatically, so call this whenever the user wants to search for flights — whether they gave IATA codes or just place names. ## Result shape Returns `{ query, currency, passengers, resultsCount, itineraries, searchTimeMs }`. Each item in `itineraries` has: - `price` (number) and `priceFormatted` (e.g. "123 EUR") - `totalDurationSeconds` - `bookingUrl` — the link to book the flight - `imageId` — destination city id for a hero photo (https://images.kiwi.com/photos/600x600/{imageId}.jpg) - `baggage` — total included baggage across all travelers: `{ personalItem, cabinBag, checkedBag }` (counts) - `outbound` (and `inbound` for return flights), each a leg with: `route` (list of airport codes including layovers, e.g. ["PRG","MAD","BCN"]), `departureTime` / `arrivalTime` (local ISO timestamps), `durationSeconds`, `stops`, `cabinClass`, and a `segments` list. Each segment has `from`/`to` (IATA), `fromCity`/`toCity`, `fromName`/`toName` (full airport names), `fromCountry`/`toCountry`, `carrier` (code) and `carrierName` (airline name), `flightNumber`, and `cabinClass`. ## How to display Render a markdown table. Group results into cheapest (lowest `price`), shortest (lowest `totalDurationSeconds`), and other notable options. For each itinerary show, in order: - Route: join `outbound.route` with " → " (e.g. "PRG → MAD → BCN"); for return flights show `inbound.route` on a second line. - Times & duration: `outbound.departureTime` → `outbound.arrivalTime` (local), formatted readably (e.g. "12 Jun 06:05 → 09:30 (3h 25m)") using `outbound.durationSeconds`; add the `inbound` equivalents for return flights. - Cabin: `outbound.cabinClass` (e.g. "Economy"). - Price: `priceFormatted`. - Booking link: `bookingUrl`. Finally, summarise the best price and the shortest option, give a recommendation, and end wishing the user a nice trip with a short fun fact about the destination!

// inputSchema
{
  "type": "object",
  "title": "search_flightsArguments",
  "required": [
    "flyFrom",
    "flyTo",
    "departureDate"
  ],
  "properties": {
    "sort": {
      "enum": [
        "price",
        "duration",
        "quality",
        "date",
        "popularity"
      ],
      "type": "string",
      "title": "Sort",
      "default": "price",
      "description": "Result ordering"
    },
    "flyTo": {
      "type": "string",
      "title": "Flyto",
      "maxLength": 100,
      "minLength": 1,
      "description": "Destination: IATA code, city or airport name"
    },
    "adults": {
      "ge": 1,
      "le": 9,
      "type": "integer",
      "title": "Adults",
      "default": 1,
      "description": "Number of adults (12+)"
    },
    "locale": {
      "type": "string",
      "title": "Locale",
      "default": "en",
      "maxLength": 10,
      "minLength": 1,
      "description": "Locale (e.g. en, de, fr)"
    },
    "flyFrom": {
      "type": "string",
      "title": "Flyfrom",
      "maxLength": 100,
      "minLength": 1,
      "description": "Origin: IATA code, city or airport name (e.g. \"PRG\", \"Prague\", \"London Heathrow\")"
    },
    "infants": {
      "type": "integer",
      "title": "Infants",
      "default": 0,
      "maximum": 4,
      "minimum": 0,
      "description": "Number of infants (<2)"
    },
    "atime_to": {
      "anyOf": [
        {
          "ge": 0,
          "le": 23,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Atime To",
      "default": null,
      "description": "Latest outbound arrival hour (0-23, local)"
    },
    "children": {
      "type": "integer",
      "title": "Children",
      "default": 0,
      "maximum": 8,
      "minimum": 0,
      "description": "Number of children (2-11)"
    },
    "currency": {
      "type": "string",
      "title": "Currency",
      "default": "EUR",
      "maxLength": 3,
      "minLength": 1,
      "description": "Currency code (e.g. EUR, USD)"
    },
    "dtime_to": {
      "anyOf": [
        {
          "ge": 0,
          "le": 23,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Dtime To",
      "default": null,
      "description": "Latest outbound departure hour (0-23, local)"
    },
    "fly_days": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 32
        },
        {
          "type": "null"
        }
      ],
      "title": "Fly Days",
      "default": null,
      "description": "Allowed outbound departure weekdays — comma-separated 0=Sun..6=Sat, e.g. '1,2,3,4,5' for weekdays"
    },
    "price_to": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Price To",
      "default": null,
      "description": "Maximum total price filter in the specified currency"
    },
    "atime_from": {
      "anyOf": [
        {
          "ge": 0,
          "le": 23,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Atime From",
      "default": null,
      "description": "Earliest outbound arrival hour (0-23, local)"
    },
    "cabinClass": {
      "anyOf": [
        {
          "enum": [
            "M",
            "W",
            "C",
            "F"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cabinclass",
      "default": null,
      "description": "M=economy, W=premium economy, C=business, F=first"
    },
    "dtime_from": {
      "anyOf": [
        {
          "ge": 0,
          "le": 23,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Dtime From",
      "default": null,
      "description": "Earliest outbound departure hour (0-23, local)"
    },
    "price_from": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Price From",
      "default": null,
      "description": "Minimum total price filter in the specified currency"
    },
    "returnDate": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 10
        },
        {
          "type": "null"
        }
      ],
      "title": "Returndate",
      "default": null,
      "description": "Return date in dd/mm/yyyy — the day to fly back, or the earliest return date of a range (omit for one-way)"
    },
    "stopover_to": {
      "anyOf": [
        {
          "ge": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Stopover To",
      "default": null,
      "description": "Maximum layover duration in hours"
    },
    "one_for_city": {
      "type": "boolean",
      "title": "One For City",
      "default": false,
      "description": "If true, return only the single best result per destination city — useful for 'explore' searches with broad destinations"
    },
    "ret_atime_to": {
      "anyOf": [
        {
          "ge": 0,
          "le": 23,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ret Atime To",
      "default": null,
      "description": "Latest return arrival hour (0-23, local)"
    },
    "ret_dtime_to": {
      "anyOf": [
        {
          "ge": 0,
          "le": 23,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ret Dtime To",
      "default": null,
      "description": "Latest return departure hour (0-23, local)"
    },
    "ret_fly_days": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 32
        },
        {
          "type": "null"
        }
      ],
      "title": "Ret Fly Days",
      "default": null,
      "description": "Allowed return departure weekdays — comma-separated 0=Sun..6=Sat"
    },
    "returnDateTo": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 10
        },
        {
          "type": "null"
        }
      ],
      "title": "Returndateto",
      "default": null,
      "description": "Latest return date in dd/mm/yyyy for an explicit range [returnDate .. returnDateTo]. Requires returnDate; use instead of returnDateFlexDays; must be >= returnDate"
    },
    "departureDate": {
      "type": "string",
      "title": "Departuredate",
      "maxLength": 10,
      "description": "Departure date in dd/mm/yyyy — the day to fly, or the earliest date of a range (see departureDateTo)"
    },
    "stopover_from": {
      "anyOf": [
        {
          "ge": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Stopover From",
      "default": null,
      "description": "Minimum layover duration in hours"
    },
    "ret_atime_from": {
      "anyOf": [
        {
          "ge": 0,
          "le": 23,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ret Atime From",
      "default": null,
      "description": "Earliest return arrival hour (0-23, local)"
    },
    "ret_dtime_from": {
      "anyOf": [
        {
          "ge": 0,
          "le": 23,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ret Dtime From",
      "default": null,
      "description": "Earliest return departure hour (0-23, local)"
    },
    "departureDateTo": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 10
        },
        {
          "type": "null"
        }
      ],
      "title": "Departuredateto",
      "default": null,
      "description": "Latest departure date in dd/mm/yyyy for an explicit range [departureDate .. departureDateTo]. Use instead of departureDateFlexDays for a one-directional or asymmetric range; must be >= departureDate"
    },
    "select_airlines": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ],
      "title": "Select Airlines",
      "default": null,
      "description": "Only include flights operated by these airlines — comma-separated IATA codes, e.g. 'FR,U2,BA'. Mutually exclusive with exclude_airlines"
    },
    "adults_hand_bags": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "integer",
            "maximum": 1,
            "minimum": 0
          },
          "maxItems": 9
        },
        {
          "type": "null"
        }
      ],
      "title": "Adults Hand Bags",
      "default": null,
      "description": "Cabin (hand) bags per adult, one entry per adult (each 0-1), e.g. [1, 1]"
    },
    "adults_hold_bags": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "integer",
            "maximum": 2,
            "minimum": 0
          },
          "maxItems": 9
        },
        {
          "type": "null"
        }
      ],
      "title": "Adults Hold Bags",
      "default": null,
      "description": "Checked (hold) bags per adult, one entry per adult (each 0-2), e.g. [1, 0]"
    },
    "exclude_airlines": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ],
      "title": "Exclude Airlines",
      "default": null,
      "description": "Exclude flights operated by these airlines — comma-separated IATA codes, e.g. 'FR,W6'. Mutually exclusive with select_airlines"
    },
    "max_fly_duration": {
      "anyOf": [
        {
          "ge": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Fly Duration",
      "default": null,
      "description": "Maximum total flight duration in hours"
    },
    "nights_in_dst_to": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Nights In Dst To",
      "default": null,
      "description": "Maximum nights at destination before return flight"
    },
    "stopover_airports": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ],
      "title": "Stopover Airports",
      "default": null,
      "description": "Only connect via these airports — comma-separated IATA codes. Constrains connecting flights only; direct (non-stop) flights are still returned."
    },
    "children_hand_bags": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "integer",
            "maximum": 1,
            "minimum": 0
          },
          "maxItems": 8
        },
        {
          "type": "null"
        }
      ],
      "title": "Children Hand Bags",
      "default": null,
      "description": "Cabin (hand) bags per child, one entry per child (each 0-1), e.g. [1]"
    },
    "children_hold_bags": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "integer",
            "maximum": 2,
            "minimum": 0
          },
          "maxItems": 8
        },
        {
          "type": "null"
        }
      ],
      "title": "Children Hold Bags",
      "default": null,
      "description": "Checked (hold) bags per child, one entry per child (each 0-2), e.g. [2]"
    },
    "nights_in_dst_from": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Nights In Dst From",
      "default": null,
      "description": "Minimum nights at destination before return flight. Turns the search into a return search"
    },
    "returnDateFlexDays": {
      "type": "integer",
      "title": "Returndateflexdays",
      "default": 0,
      "maximum": 10,
      "minimum": 0,
      "description": "Search +/- this many days around returnDate (symmetric). Leave 0 when using returnDateTo"
    },
    "stopover_countries": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ],
      "title": "Stopover Countries",
      "default": null,
      "description": "Only connect via these countries — comma-separated ISO 3166-1 alpha-2 codes, e.g. 'DE,AT'. Constrains connecting flights only; direct (non-stop) flights are still returned."
    },
    "allow_self_transfer": {
      "type": "boolean",
      "title": "Allow Self Transfer",
      "default": true,
      "description": "Allow self-transfer (virtual interlining) connections between separate tickets"
    },
    "max_sector_stopovers": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Sector Stopovers",
      "default": null,
      "description": "Maximum number of stopovers (connections) allowed per flight sector"
    },
    "departureDateFlexDays": {
      "type": "integer",
      "title": "Departuredateflexdays",
      "default": 0,
      "maximum": 10,
      "minimum": 0,
      "description": "Search +/- this many days around departureDate (symmetric). Leave 0 when using departureDateTo"
    },
    "allow_overnight_stopovers": {
      "type": "boolean",
      "title": "Allow Overnight Stopovers",
      "default": true,
      "description": "Allow overnight (red-eye) layovers"
    },
    "exclude_stopover_airports": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ],
      "title": "Exclude Stopover Airports",
      "default": null,
      "description": "Never connect via these airports — comma-separated IATA codes"
    },
    "exclude_stopover_countries": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ],
      "title": "Exclude Stopover Countries",
      "default": null,
      "description": "Never connect via these countries — comma-separated ISO 3166-1 alpha-2 codes"
    },
    "allow_diff_airport_connection": {
      "type": "boolean",
      "title": "Allow Diff Airport Connection",
      "default": true,
      "description": "Allow connections that change airports within the same city"
    }
  }
}