Orizn Visa

MCP-сервер Orizn Visa API

MCP-сервер Orizn Visa API — это сервер Model Context Protocol (MCP), который предоставляет ИИ-ассистенту информацию о визах и требованиях для въезда для любой пары «паспорт/направление» на 15 языках.

Покрытие постоянно растёт: вместо того чтобы указывать здесь число, которое устареет, инструмент get_coverage_stats считывает его в реальном времени из API (также доступного публично по адресу https://visa.orizn.app/api/v1/visa/stats).

Он отвечает на такие вопросы, как «нужна ли мне виза для поездки из Франции в Японию», «какие документы нужны гражданину США для поездки в Китай», «могу ли я покинуть аэропорт во время пересадки в Стамбуле с индийским паспортом» — на основе данных, а не предположений.

Совместимость

Сервер работает по протоколу MCP через stdio и запускается на Node.js 18 или новее. Он совместим с любым MCP-клиентом, который может запускать stdio-сервер, включая Claude Desktop, Claude Code и Cursor. Блок конфигурации ниже одинаков для всех них.

Установка

npx orizn-visa-mcp

Ничего собирать и клонировать не нужно. Добавьте его в конфигурацию вашего MCP-клиента:

{
  "mcpServers": {
    "orizn-visa": {
      "command": "npx",
      "args": ["-y", "orizn-visa-mcp"]
    }
  }
}

Перезапустите клиент, затем спросите: «Нужна ли мне виза для поездки из Франции в Японию?» — это работает без API-ключа, 10 проверок в день.

Для всего остального (документы, сборы, сроки обработки, правила транзита, 15 языков) добавьте бесплатный ключ:

{
  "mcpServers": {
    "orizn-visa": {
      "command": "npx",
      "args": ["-y", "orizn-visa-mcp"],
      "env": {
        "ORIZN_API_KEY": "orizn_visa_..."
      }
    }
  }
}

Ключ также можно передать в качестве аргумента, который имеет приоритет над переменной окружения:

npx orizn-visa-mcp --api-key orizn_visa_...

Примеры вопросов

• «Нужна ли мне виза для поездки из Франции в Таиланд?»
• «Какие документы нужны гражданину США для посещения Китая?»
• «Сравните Таиланд, Вьетнам и Индонезию для бразильского паспорта.»
• «Могу ли я покинуть аэропорт во время 12-часовой пересадки в Стамбуле с китайским паспортом?»
• «Сколько стоит шенгенская виза для обладателя филиппинского паспорта?»
• «Какие прививки нужны для въезда в Бразилию с французским паспортом?»
• «Какой штраф за превышение срока пребывания по тайской визе на 3 дня?»
• «Есть ли в Португалии виза для цифровых кочевников, и сколько она стоит?»
• «Réponds en français : ai-je besoin d'un visa pour le Japon avec un passeport marocain ?»

Инструменты

Инструмент	Аргументы	Что возвращает	Тариф
check_visa_requirement	passport, destination, lang	Полные требования для въезда по одному паспорту в одно направление: тип требования, разрешённые дни, документы, шаги подачи заявления, сборы, сроки обработки, срок действия паспорта, требования к фото, прививки, страховка, предупреждения о безопасности, штрафы за превышение срока, въезд по воздуху/земле/морю, виза для удалённой работы, правила продления и для несовершеннолетних, посольства.	Любой ключ
quick_visa_check	passport, destination	Одна строка: код требования, количество безвизовых дней и дата последней проверки пары. Без документов, сборов и перевода.	Нет — 10/день без ключа, безлимит с любым ключом
compare_destinations	passport, destinations (1–25), lang	До 25 направлений для одного паспорта рядом: требование, безвизовые дни, описание, срок действия паспорта, сбор, безопасность, здоровье, прививки, страховка, въезд по видам транспорта, виза для удалённой работы. Каждое возвращённое направление считается как один запрос.	Hobby или выше
check_transit_visa	passport, transit_country, lang	Только правила пересадок: может ли путешественник оставаться в транзитной зоне или покинуть аэропорт при пересадке, и сколько бесплатных транзитных часов предоставляют основные хабы.	Hobby или выше
get_coverage_stats	нет	Размер базы данных: пары, паспорта, направления, переводы, языки и распределение типов требований. Ничего не говорит о конкретной паре.	Нет
get_recent_changes	passport, destination, since, limit (все необязательные)	Недавно изменившиеся визовые правила с указанием источника и даты. Лента сейчас отключена — см. ниже.	Нет

Коды стран — ISO 3166-1 alpha-3 (FRA, JPN, USA), а не alpha-2.

requirement — одно из значений visa_free, visa_required, e_visa, visa_on_arrival, eta, no_admission, а также более редкие partial_restrictions, admission_refused, not_applicable и special.

Ресурс

visa://supported-languages — 15 кодов, принимаемых lang, доступны на всех тарифах, включая бесплатный: en fr es pt de ja ko zh ru it ar hi th vi tl.

get_recent_changes намеренно ничего не возвращает

Лента изменений политики Orizn отключена. Она выдавала несоответствия, обнаруженные между двумя внутренними таблицами Orizn, как официальные изменения политики, поэтому теперь она возвращает HTTP 503, и этот инструмент деградирует до:

{ "status": "unavailable", "changes": [], "do_not_conclude": "This is NOT evidence that no visa rules changed..." }

Инструмент намеренно поставляется в таком состоянии: пустой, чётко обозначенный ответ — это честный ответ, и инструмент начнёт возвращать реальные записи в тот день, когда лента заработает на проверенных официальных источниках — после чего записи без указанного источника и даты будут скрываться, а не показываться.

Аутентификация и бесплатный тариф

quick_visa_check, get_coverage_stats и get_recent_changes работают вообще без API-ключа. Безключевой quick_visa_check ограничен 10 проверками в день — та же квота, что и у анонимного посетителя visa.orizn.app. После этого инструмент сообщает об этом и указывает на бесплатный ключ, а не молча завершается с ошибкой. Квота действует на каждый запущенный процесс сервера и сбрасывается в 00:00 UTC.

Остальные три инструмента требуют API-ключ, передаваемый в заголовке x-api-key к https://visa.orizn.app/api/v1/visa.

Получите бесплатный ключ на visa.orizn.app/visa-api — без кредитной карты. Бесплатный тариф — 50 запросов/месяц (5 до подтверждения адреса электронной почты) и включает основные поля и все 15 языков. На бесплатном тарифе более глубокие поля — сборы, сроки обработки, требования к фото, прививки, страховка, транзитные визы, въезд по видам транспорта, штрафы за превышение срока, визы для удалённой работы, посольства — возвращаются как заполнитель {"upgrade": "..."}, а compare_destinations и check_transit_visa ограничены.

Hobby стоит $9/месяц за 10 000 запросов и открывает всё: перейти на тариф. Тарифы с большими объёмами перечислены на странице цен.

Передавайте ключ в блоке env конфигурации MCP — MCP-клиенты не наследуют переменные окружения вашей оболочки, поэтому экспорта ORIZN_API_KEY в терминале недостаточно.

Проверьте ключ без MCP-клиента:

curl -H "x-api-key: $ORIZN_API_KEY" \
  "https://visa.orizn.app/api/v1/visa/check?passport=FRA&destination=JPN"

{ "passport": "FRA", "destination": "JPN", "requirement": "visa_free", "visa_free_days": 90 }

Устранение неполадок

Симптом	Решение
«No Orizn API key»	Ожидаемо для инструментов, требующих ключ. quick_visa_check по-прежнему отвечает. Чтобы устранить это, поместите ключ в блок env файла конфигурации — а не в оболочку — затем перезапустите клиент
«Keyless daily limit reached»	10 бесплатных проверок на сегодня исчерпаны. Бесплатный ключ снимает ограничение
HTTP 403, «check ORIZN_API_KEY for typos»	Ключ неверный, отозван или содержит пробелы
HTTP 403, «requires Hobby plan or above»	Ключ верный, но тариф не тот — этот инструмент платный
HTTP 429	Месячная квота исчерпана
HTTP 404 для реальной страны	Используйте коды alpha-3 (FRA, JPN), а не alpha-2 (FR, JP)
Ничего не работает	Вызовите get_coverage_stats — ему не нужен ключ. Если и он не работает, проблема в сети
get_recent_changes возвращает пустой список	Ожидаемо — лента перестраивается. Это не означает, что правила не изменились

Ссылки

• Веб-сайт — visa.orizn.app
• Документация API — visa.orizn.app/visa-api/dashboard/docs
• Получить бесплатный ключ — visa.orizn.app/visa-api
• GitHub — github.com/MattJeff/orizn-mcp-server
• Поддержка — api@orizn.app

Лицензия

MIT