MattJeff/orizn-mcp-server

Правила транзита и пересадок для страны, через которую идёт маршрут: правила airside/landside и сколько бесплатных транзитных часов дают её основные хабы. ВАЖНО: эти данные моделируются ПО ТРАНЗИТНОЙ СТРАНЕ, а не по гражданству, указанному в паспорте: ответ одинаков для любого паспорта, и данные доступны только для 44 транзитных стран. Аргумент passport записывается, но не сужает результат. Относитесь к ответу как к общим правилам хабов и подтверждайте их у авиакомпании или у властей транзитной страны, а не как к решению для конкретного гражданства. Если страна не покрыта, инструмент сообщает об этом, а не угадывает. Вызывайте этот инструмент для пересадок, стоповеров и стыковочных рейсов, а не для въезда в страну как в пункт назначения (для этого используйте check_visa_requirement). Требуется API-ключ; для транзитных данных нужен платный тариф (Starter $49/мес или выше), бесплатный ключ получает заглушку о необходимости апгрейда.

СТАНДАРТНЫЙ ВИЗОВЫЙ ИНСТРУМЕНТ: полные требования для въезда для ОДНОГО паспорта, путешествующего в ОДНО место назначения. Возвращает тип визы (visa_free / visa_required / e_visa / visa_on_arrival / eta / no_admission), разрешённые дни, описание, требуемые документы, этапы подачи заявления, типы виз, стоимость, срок действия, максимальный срок пребывания, время обработки, информацию о стране, а также количество месяцев действия паспорта, визовые сборы, дни обработки, требования к фото, прививки, страховку, рекомендации по безопасности, требования к здоровью, штрафы за превышение срока, въезд по видам транспорта (воздух/земля/море), хабы для транзитных виз, визы для удаленной работы, правила продления, правила для несовершеннолетних, предупреждения о двойном гражданстве и отметках в паспорте, а также посольства. Отвечает на любом из 15 языков (все тарифы, включая бесплатный). Вызывайте этот инструмент всякий раз, когда пользователь спрашивает, нужна ли виза, какие документы или прививки необходимы, сколько стоит виза, сколько времени занимает, как долго можно оставаться или что происходит при превышении срока пребывания. Требует API-ключ (бесплатный по адресу https://visa.orizn.app/visa-api). В бесплатном тарифе некоторые глубокие поля возвращаются в виде плейсхолдера {upgrade: ...} вместо данных. При чтении ответа: каждое глубокое поле содержит параметр granularity - "destination" означает, что значение описывает страну назначения для всех национальностей (сборы, дни обработки, транзит, превышение срока, безопасность); "passport" означает, что оно описывает паспорт для всех направлений (история взаимности, предупреждения о штампах и двойном гражданстве). Только требования верхнего уровня, безвизовые дни, описание и документы - специфичны для пары. Поле, которого нет у Orizn, возвращается как {status: "unavailable"} - сообщите об этом, а не заполняйте пробел; а as_of - это справочная дата этого поля, которая не обновляется в реальном времени.

Сравнивает до 25 направлений для ОДНОГО паспорта за один вызов. Возвращает для каждого направления: требование, безвизовые дни, описание, срок действия паспорта в месяцах, визовый сбор, рекомендации по безопасности, требования к здоровью, прививки, страховку, въезд по видам транспорта и визу для удалённой работы. Используйте его для коротких списков: «куда я могу поехать без визы в Азии?», «сравни Таиланд, Вьетнам и Индонезию для моего паспорта», а также для планирования поездки по нескольким странам-кандидатам. Он НЕ возвращает все страны мира: передайте конкретные направления для сравнения. Каждое возвращённое направление расходует один запрос из квоты. Требует платного тарифа (Starter $49/месяц или выше): бесплатный ключ получает здесь HTTP 403.

Охват самой базы данных виз Orizn: количество пар, паспортов, направлений, переводов, языков и распределение типов требований. Не содержит информации о какой-либо конкретной паре стран. Бесплатно, не требуется API-ключ. Полезно для подтверждения, что сервер может связаться с API. Вызывайте его, когда пользователь спрашивает, насколько велика или полна база данных.

Недавно изменённые визовые правила — что изменилось, для какой пары паспорт/назначение, в какую дату и из какого официального источника. СТАТУС: канал изменений Orizn в данный момент ВЫКЛЮЧЕН, и этот инструмент возвращает {status:"unavailable", changes: []}. Его отключили, потому что он публиковал внутренне выявленные расхождения между двумя таблицами Orizn как официальные изменения правил. Пустой ответ в данном случае означает «у Orizn нет подтверждённых данных об изменениях», НИ В КОЕМ СЛУЧАЕ «ничего не изменилось» — не говорите пользователю, что правила стабильны, скажите ему проверить официальный иммиграционный источник страны назначения и использовать check_visa_requirement для получения текущего правила с датой его проверки. Когда канал вернётся, будут возвращены только записи с указанным источником и датой; непроверенные записи отбрасываются, а не показываются.

Выдаёт однострочный ответ для ОДНОЙ пары паспорт/назначение: код требования, количество безвизовых дней и дату последней проверки пары. Не нужны документы, процесс, сборы и перевод — используйте check_visa_requirement, когда пользователю нужна любая деталь. Отдавайте предпочтение этому инструменту только когда пользователь хочет просто да/нет, или когда проверяется много пар и детали будут шумом. Работает БЕЗ API-ключа, 10 проверок в день — единственный инструмент, который отвечает на вопрос путешественника без ключа. Бесплатный ключ (https://visa.orizn.app/visa-api, без кредитной карты) снимает это дневное ограничение. Ответ содержит last_verified — дату последней проверки данных этой пары, или null, когда у Orizn нет даты проверки для неё — сообщайте об этом, а не подразумевайте, что ответ актуален.