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ş koşullarını 15 dilde yanıtlayan bir Model Context Protocol (MCP) sunucusudur.

Kapsam büyümeye devam ediyor: burada 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", "Çin için bir ABD vatandaşının 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?"
• "Filipin pasaportu sahibi için Schengen vizesi ne kadar?"
• "Fransız pasaportuyla Brezilya'ya girmek için hangi aşılara ihtiyacım var?"
• "Tayland vizemi 3 gün aşarsam cezası ne olur?"
• "Portekiz'in 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 girişi için tüm gereksinimler: 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ı, aşırı kalış 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 — günde 10 anahtarsız, herhangi bir anahtarla sınırsız
compare_destinations	passport, destinations (1–25), lang	Tek pasaport için 25'e kadar varış noktası yan yana: 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.	Başlangıç 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ığı.	Başlangıç 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 hiç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 bilerek 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ür ve bu araç şu duruma düşer:

{ "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 olandır ve akış doğrulanmış resmi kaynaklarda çalıştığı gün araç 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ç, x-api-key başlığı olarak https://visa.orizn.app/api/v1/visa adresine gönderilen bir API anahtarı gerektirir.

visa.orizn.app/visa-api adresinden ücretsiz bir tane edinin — kredi kartı gerekmez. Ücretsiz katman ayda 100 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ş, aşırı kalış 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.

Başlangıç planı ayda 49 ABD doları karşılığında 30.000 istek sunar ve ticari lisansla tümünün 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ıt verir. Bunu 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'de yazım hatalarını kontrol edin"	Anahtar yanlış, iptal edilmiş veya boşluk içeriyor
HTTP 403, "Başlangıç planı veya üzeri gerektirir"	Doğru anahtar, yanlış plan — bu araç ücretlidir
HTTP 429	Aylık kota harcandı
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ür	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 edinin — visa.orizn.app/visa-api
• GitHub — github.com/MattJeff/orizn-mcp-server
• Destek — api@orizn.app

Lisans

MIT