Orizn Visa

Orizn Visa API MCP Sunucusu

Orizn Visa API MCP Sunucusu, bir yapay zeka asistanına herhangi bir pasaport/varış noktası çifti için vize ve giriş gereksinimlerini 15 dilde yanıtlayan bir Model Context Protocol (MCP) sunucusudur.

Kapsam büyümeye devam ediyor: burada zamanla bayatlayacak bir sayı yazmak yerine, get_coverage_stats aracı bunu API'den canlı olarak okur (ayrıca https://visa.orizn.app/api/v1/visa/stats adresinde herkese açıktır).

"Fransa'dan Japonya'ya gitmek için vize gerekiyor mu", "ABD vatandaşının Çin için hangi belgelere ihtiyacı var", "Hint pasaportuyla İstanbul'da aktarma sırasında havaalanından çıkabilir miyim" gibi soruları tahminle değil, veriyle yanıtlar.

Uyumluluk

Sunucu, stdio üzerinden MCP konuşur ve Node.js 18 veya üzeri sürümlerde çalışır. Claude Desktop, Claude Code ve Cursor dahil olmak üzere stdio sunucusu başlatabilen herhangi bir MCP istemcisiyle çalışır. Aşağıdaki yapılandırma bloğu hepsi için aynıdır.

Kurulum

npx orizn-visa-mcp

Derlenecek veya klonlanacak bir şey yok. MCP istemci yapılandırmanıza ekleyin:

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

İstemciyi yeniden başlatın ve sorun: "Fransa'dan Japonya'ya gitmek için vize gerekiyor mu?" — bu, API anahtarı olmadan çalışır, günde 10 kontrol.

Diğer her şey için (belgeler, ücretler, işlem süreleri, transit kuralları, 15 dil), ücretsiz bir anahtar ekleyin:

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

Anahtar ayrıca bir argüman olarak da iletilebilir; bu, ortam değişkenine göre önceliklidir:

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

Örnek sorular

• "Fransa'dan Tayland'a seyahat etmek için vize gerekiyor mu?"
• "Çin'i ziyaret eden bir ABD vatandaşı olarak hangi belgelere ihtiyacım var?"
• "Brezilya pasaportu için Tayland, Vietnam ve Endonezya'yı karşılaştırın."
• "Çin pasaportuyla İstanbul'da 12 saatlik aktarma sırasında havaalanından çıkabilir miyim?"
• "Filipinli pasaport sahibi için Schengen vizesi ne kadar?"
• "Fransız pasaportuyla Brezilya'ya girmek için hangi aşıları yaptırmam gerekiyor?"
• "Tayland vizemi 3 gün aşarsam cezası ne kadar?"
• "Portekiz'de dijital göçebe vizesi var mı ve maliyeti ne kadar?"
• "Réponds en français : ai-je besoin d'un visa pour le Japon avec un passeport marocain ?"

Araçlar

Araç	Argümanlar	Ne döndürür	Plan
check_visa_requirement	passport, destination, lang	Bir pasaportun tek bir varış noktasına tam giriş gereksinimleri: gereksinim türü, izin verilen günler, belgeler, başvuru adımları, ücretler, işlem süreleri, pasaport geçerliliği, fotoğraf özellikleri, aşılar, sigorta, güvenlik uyarısı, vize aşımı cezaları, hava/kara/deniz girişi, uzaktan çalışma vizesi, uzatma ve reşit olmayan kuralları, elçilikler.	Herhangi bir anahtar
quick_visa_check	passport, destination	Tek satır: gereksinim kodu, vizesiz gün sayısı ve çiftin son doğrulandığı tarih. Belge yok, ücret yok, çeviri yok.	Yok — anahtarsız günde 10, herhangi bir anahtarla sınırsız
compare_destinations	passport, destinations (1–25), lang	Tek pasaport için yan yana 25'e kadar varış noktası: gereksinim, vizesiz günler, açıklama, pasaport geçerliliği, ücret, güvenlik, sağlık, aşılar, sigorta, moda göre giriş, uzaktan çalışma vizesi. Döndürülen her varış noktası bir istek olarak sayılır.	Hobi veya üzeri
check_transit_visa	passport, transit_country, lang	Yalnızca aktarma kuralları: yolcunun bağlantı sırasında hava tarafında kalıp kalamayacağı veya havaalanından çıkıp çıkamayacağı ve ana merkezlerin kaç saat ücretsiz transit süresi tanıdığı.	Hobi veya üzeri
get_coverage_stats	yok	Veritabanının boyutu: çiftler, pasaportlar, varış noktaları, çeviriler, diller ve gereksinim türlerinin dağılımı. Belirli bir çift hakkında bir şey söylemez.	Yok
get_recent_changes	passport, destination, since, limit (tümü isteğe bağlı)	Son zamanlarda değişen vize kuralları, bunları bildiren kaynak ve tarihle birlikte. Akış şu anda kapalı — aşağıya bakın.	Yok

Ülke kodları ISO 3166-1 alpha-3 (FRA, JPN, USA) biçimindedir, alpha-2 değil.

requirement şunlardan biridir: visa_free, visa_required, e_visa, visa_on_arrival, eta, no_admission, ayrıca daha nadir olan partial_restrictions, admission_refused, not_applicable ve special.

Kaynak

visa://supported-languages — lang tarafından kabul edilen 15 kod, ücretsiz dahil her planda mevcuttur: en fr es pt de ja ko zh ru it ar hi th vi tl.

get_recent_changes bilinçli olarak hiçbir şey döndürmez

Orizn'in politika değişikliği akışı kapatılmıştır. İki dahili Orizn tablosu arasında tespit edilen tutarsızlıkları resmi politika değişiklikleri gibi sunuyordu, bu nedenle artık HTTP 503 döndürüyor ve bu araç şu duruma düşüyor:

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

Araç bilinçli olarak bu durumda gönderilir: boş, açıkça etiketlenmiş bir yanıt dürüst olanıdır ve araç, akış doğrulanmış resmi kaynaklarda çalıştığı gün gerçek girdileri döndürmeye başlar — bu noktada adlandırılmış bir kaynağı ve tarihi olmayan girdiler gösterilmek yerine saklanır.

Kimlik doğrulama ve ücretsiz katman

quick_visa_check, get_coverage_stats ve get_recent_changes hiçbir API anahtarı olmadan çalışır. Anahtarsız quick_visa_check günde 10 kontrol ile sınırlıdır — visa.orizn.app'in anonim bir ziyaretçiye verdiği izinle aynıdır. Bu sınırın ötesinde araç bunu söyler ve sessizce başarısız olmak yerine ücretsiz anahtarı işaret eder. Sınır, çalışan sunucu süreci başına uygulanır ve 00:00 UTC'de sıfırlanır.

Diğer üç araç, https://visa.orizn.app/api/v1/visa adresine x-api-key başlığı olarak gönderilen bir API anahtarı gerektirir.

Ücretsiz bir tane alın: visa.orizn.app/visa-api — kredi kartı gerekmez. Ücretsiz katman ayda 50 istek (e-posta adresinizi doğrulayana kadar 5) içerir ve temel alanları ve 15 dilin tamamını kapsar. Ücretsiz planda daha derin alanlar — ücretler, işlem günleri, fotoğraf özellikleri, aşılar, sigorta, transit vizeleri, moda göre giriş, vize aşımı cezaları, uzaktan çalışma vizeleri, elçilikler — bir {"upgrade": "..."} yer tutucusu olarak döner ve compare_destinations ile check_transit_visa kısıtlıdır.

Hobi, 10.000 istek için ayda 9 ABD dolarıdır ve hepsinin kilidini açar: yükselt. Daha yüksek hacimli planlar fiyatlandırma sayfasında listelenmiştir.

Anahtarı MCP yapılandırmasının env bloğuna iletin — MCP istemcileri kabuk ortamınızı devralmaz, bu nedenle bir terminalde ORIZN_API_KEY dışa aktarmak yeterli değildir.

Herhangi bir MCP istemcisi olmadan bir anahtarı kontrol edin:

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 }

Sorun giderme

Belirti	Çözüm
"Orizn API anahtarı yok"	Yalnızca anahtar gerektiren araçlarda beklenir. quick_visa_check yine de yanıtlar. Kaldırmak için anahtarı yapılandırma dosyasının env bloğuna koyun — kabuğunuza değil — ardından istemciyi yeniden başlatın
"Anahtarsız günlük sınıra ulaşıldı"	Bugün için 10 ücretsiz kontrol harcandı. Ücretsiz bir anahtar sınırı kaldırır
HTTP 403, "ORIZN_API_KEY yazım hatalarını kontrol edin"	Anahtar yanlış, iptal edilmiş veya boşluk içeriyor
HTTP 403, "Hobi planı veya üzeri gerekir"	Doğru anahtar, yanlış plan — bu araç ücretlidir
HTTP 429	Aylık kota tükendi
Gerçek bir ülkede HTTP 404	Alpha-3 kodlarını kullanın (FRA, JPN), alpha-2 değil (FR, JP)
Hiçbir şey çalışmıyor	get_coverage_stats çağırın — anahtar gerektirmez. O da başarısız olursa, sorun ağdır
get_recent_changes boş bir liste döndürüyor	Beklenen — akış yeniden oluşturuluyor. Kuralların değişmediği anlamına gelmez

Bağlantılar

• Web sitesi — visa.orizn.app
• API belgeleri — visa.orizn.app/visa-api/dashboard/docs
• Ücretsiz anahtar alın — visa.orizn.app/visa-api
• GitHub — github.com/MattJeff/orizn-mcp-server
• Destek — api@orizn.app

Lisans

MIT