Orizn Visa

Orizn Visa API MCP सर्वर

Orizn Visa API MCP सर्वर एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सर्वर है जो AI सहायक को किसी भी पासपोर्ट/गंतव्य जोड़ी के लिए वीज़ा और प्रवेश आवश्यकताएँ प्रदान करता है, जिसका उत्तर 15 भाषाओं में दिया जाता है।

कवरेज बढ़ती रहती है: यहाँ एक संख्या छापने के बजाय जो पुरानी हो जाए, get_coverage_stats टूल इसे API से लाइव पढ़ता है (यह https://visa.orizn.app/api/v1/visa/stats पर सार्वजनिक रूप से भी उपलब्ध है)।

यह ऐसे प्रश्नों का उत्तर देता है जैसे "क्या मुझे फ्रांस से जापान जाने के लिए वीज़ा चाहिए", "चीन जाने के लिए अमेरिकी नागरिक को कौन से दस्तावेज़ चाहिए", "क्या मैं भारतीय पासपोर्ट पर इस्तांबुल में लेओवर के दौरान हवाई अड्डे से बाहर जा सकता हूँ" — अनुमान से नहीं, डेटा के साथ।

संगतता

सर्वर stdio पर MCP बोलता है और 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 — lang द्वारा स्वीकार किए गए 15 कोड, मुफ्त सहित हर योजना पर उपलब्ध: 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 अनुरोधों के लिए और यह सब अनलॉक करता है: अपग्रेड करें। उच्च-मात्रा योजनाएँ मूल्य निर्धारण पृष्ठ पर सूचीबद्ध हैं।

कुंजी को MCP कॉन्फ़िग के env ब्लॉक में पास करें — 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