Orizn Visa

Server MCP API Orizn Visa

Server MCP API Orizn Visa adalah server Model Context Protocol (MCP) yang memberikan asisten AI persyaratan visa dan masuk untuk setiap pasangan paspor/negara tujuan, dijawab dalam 15 bahasa.

Cakupan terus bertambah: alih-alih mencetak angka di sini yang akan basi, alat get_coverage_stats membacanya langsung dari API (juga publik di https://visa.orizn.app/api/v1/visa/stats).

Server ini menjawab pertanyaan seperti "apakah saya perlu visa untuk pergi dari Prancis ke Jepang", "dokumen apa yang dibutuhkan warga negara AS untuk Tiongkok", "bisakah saya keluar dari bandara saat transit di Istanbul dengan paspor India" — dengan data, bukan tebakan.

Kompatibilitas

Server berbicara MCP melalui stdio dan berjalan di Node.js 18 atau lebih baru. Server ini berfungsi dengan klien MCP apa pun yang dapat meluncurkan server stdio, termasuk Claude Desktop, Claude Code, dan Cursor. Blok konfigurasi di bawah ini sama untuk semuanya.

Instalasi

npx orizn-visa-mcp

Tidak ada yang perlu dibangun, tidak ada yang perlu dikloning. Tambahkan ke konfigurasi klien MCP Anda:

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

Mulai ulang klien, lalu tanyakan: "Apakah saya perlu visa untuk pergi dari Prancis ke Jepang?" — ini berfungsi tanpa kunci API, 10 pemeriksaan per hari.

Untuk yang lainnya (dokumen, biaya, waktu pemrosesan, aturan transit, 15 bahasa), tambahkan kunci gratis:

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

Kunci juga dapat diberikan sebagai argumen, yang lebih diutamakan daripada variabel lingkungan:

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

Contoh pertanyaan

• "Apakah saya perlu visa untuk bepergian dari Prancis ke Thailand?"
• "Dokumen apa yang saya butuhkan sebagai warga negara AS yang mengunjungi Tiongkok?"
• "Bandingkan Thailand, Vietnam, dan Indonesia untuk paspor Brasil."
• "Bisakah saya keluar dari bandara selama transit 12 jam di Istanbul dengan paspor Tiongkok?"
• "Berapa biaya visa Schengen untuk pemegang paspor Filipina?"
• "Vaksinasi apa yang saya perlukan untuk masuk ke Brasil dengan paspor Prancis?"
• "Berapa denda jika saya melebihi masa tinggal visa Thailand saya selama 3 hari?"
• "Apakah Portugal memiliki visa pekerja jarak jauh, dan berapa biayanya?"
• "Réponds en français : ai-je besoin d'un visa pour le Japon avec un passeport marocain ?"

Alat

Alat	Argumen	Yang dikembalikan	Paket
check_visa_requirement	passport, destination, lang	Persyaratan masuk lengkap untuk satu paspor ke satu tujuan: jenis persyaratan, jumlah hari yang diizinkan, dokumen, langkah aplikasi, biaya, waktu pemrosesan, validitas paspor, spesifikasi foto, vaksinasi, asuransi, peringatan keselamatan, denda masa tinggal berlebih, masuk melalui udara/darat/laut, visa kerja jarak jauh, aturan perpanjangan dan anak di bawah umur, kedutaan.	Kunci apa pun
quick_visa_check	passport, destination	Satu baris: kode persyaratan, jumlah hari bebas visa, dan tanggal pasangan terakhir diverifikasi. Tanpa dokumen, tanpa biaya, tanpa terjemahan.	Tidak ada — 10/hari tanpa kunci, tidak terbatas dengan kunci apa pun
compare_destinations	passport, destinations (1–25), lang	Hingga 25 tujuan untuk satu paspor berdampingan: persyaratan, hari bebas visa, deskripsi, validitas paspor, biaya, keselamatan, kesehatan, vaksinasi, asuransi, masuk berdasarkan moda, visa kerja jarak jauh. Setiap tujuan yang dikembalikan dihitung sebagai satu permintaan.	Hobby atau lebih tinggi
check_transit_visa	passport, transit_country, lang	Hanya aturan transit: apakah penumpang boleh tetap di area udara atau keluar dari bandara saat menghubungkan penerbangan, dan berapa jam transit gratis yang diberikan bandara utama.	Hobby atau lebih tinggi
get_coverage_stats	tidak ada	Ukuran basis data: pasangan, paspor, tujuan, terjemahan, bahasa, dan distribusi jenis persyaratan. Tidak menyebutkan pasangan tertentu.	Tidak ada
get_recent_changes	passport, destination, since, limit (semua opsional)	Aturan visa yang baru berubah, dengan sumber yang melaporkannya dan tanggalnya. Umpan saat ini mati — lihat di bawah.	Tidak ada

Kode negara adalah ISO 3166-1 alpha-3 (FRA, JPN, USA), bukan alpha-2.

requirement adalah salah satu dari visa_free, visa_required, e_visa, visa_on_arrival, eta, no_admission, plus yang lebih jarang partial_restrictions, admission_refused, not_applicable dan special.

Sumber daya

visa://supported-languages — 15 kode yang diterima oleh lang, tersedia di semua paket termasuk gratis: en fr es pt de ja ko zh ru it ar hi th vi tl.

get_recent_changes sengaja tidak mengembalikan apa pun

Umpan perubahan kebijakan Orizn dimatikan. Umpan tersebut menyajikan ketidakkonsistenan yang terdeteksi antara dua tabel internal Orizn seolah-olah itu adalah perubahan kebijakan resmi, sehingga sekarang mengembalikan HTTP 503 dan alat ini menurun menjadi:

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

Alat ini dikirim dalam keadaan ini dengan sengaja: jawaban kosong yang diberi label jelas adalah jawaban yang jujur, dan alat mulai mengembalikan entri nyata pada hari umpan berjalan pada sumber resmi yang terverifikasi — pada saat itu entri tanpa sumber bernama dan tanggal ditahan daripada ditampilkan.

Autentikasi dan tingkat gratis

quick_visa_check, get_coverage_stats dan get_recent_changes berfungsi tanpa kunci API sama sekali. quick_visa_check tanpa kunci dibatasi 10 pemeriksaan per hari — tunjangan yang sama yang diberikan visa.orizn.app kepada pengunjung anonim. Setelah itu alat akan mengatakannya dan menunjuk ke kunci gratis daripada gagal diam-diam. Batasnya per proses server yang berjalan dan diatur ulang pada 00:00 UTC.

Tiga alat lainnya memerlukan kunci API, dikirim sebagai header x-api-key ke https://visa.orizn.app/api/v1/visa.

Dapatkan yang gratis di visa.orizn.app/visa-api — tanpa kartu kredit. Tingkat gratis adalah 50 permintaan/bulan (5 sampai Anda mengonfirmasi alamat email Anda) dan mencakup bidang inti dan semua 15 bahasa. Pada paket gratis, bidang yang lebih dalam — biaya, hari pemrosesan, spesifikasi foto, vaksinasi, asuransi, visa transit, masuk berdasarkan moda, denda masa tinggal berlebih, visa kerja jarak jauh, kedutaan — kembali sebagai placeholder {"upgrade": "..."}, dan compare_destinations dan check_transit_visa dibatasi.

Hobby adalah $9/bulan untuk 10.000 permintaan dan membuka semua itu: tingkatkan. Paket volume lebih tinggi tercantum di halaman harga.

Berikan kunci di blok env dari konfigurasi MCP — klien MCP tidak mewarisi lingkungan shell Anda, jadi mengekspor ORIZN_API_KEY di terminal tidak cukup.

Periksa kunci tanpa klien MCP apa pun:

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 }

Pemecahan masalah

Gejala	Perbaikan
"Tidak ada kunci API Orizn"	Diharapkan pada alat khusus kunci. quick_visa_check masih menjawab. Untuk mengatasinya, letakkan kunci di blok env dari file konfigurasi — bukan shell Anda — lalu mulai ulang klien
"Batas harian tanpa kunci tercapai"	10 pemeriksaan gratis hari ini sudah habis. Kunci gratis menghapus batas
HTTP 403, "periksa ORIZN_API_KEY untuk salah ketik"	Kunci salah, dicabut, atau memiliki spasi
HTTP 403, "memerlukan paket Hobby atau lebih tinggi"	Kunci benar, paket salah — alat ini berbayar
HTTP 429	Kuota bulanan habis
HTTP 404 pada negara yang nyata	Gunakan kode alpha-3 (FRA, JPN), bukan alpha-2 (FR, JP)
Tidak ada yang berfungsi sama sekali	Panggil get_coverage_stats — tidak memerlukan kunci. Jika itu juga gagal, itu masalah jaringan
get_recent_changes mengembalikan daftar kosong	Diharapkan — umpan sedang dibangun ulang. Itu tidak berarti aturannya tidak berubah

Tautan

• Situs web — visa.orizn.app
• Dokumentasi API — visa.orizn.app/visa-api/dashboard/docs
• Dapatkan kunci gratis — visa.orizn.app/visa-api
• GitHub — github.com/MattJeff/orizn-mcp-server
• Dukungan — api@orizn.app

Lisensi

MIT