Orizn Visa

Serveur MCP de l'API Orizn Visa

Le serveur MCP de l'API Orizn Visa est un serveur Model Context Protocol (MCP) qui fournit à un assistant IA les exigences de visa et d'entrée pour toute paire passeport/destination, avec des réponses en 15 langues.

La couverture augmente : plutôt que d'afficher un chiffre ici qui deviendrait obsolète, l'outil get_coverage_stats le lit en direct depuis l'API (également publique sur https://visa.orizn.app/api/v1/visa/stats).

Il répond à des questions comme « ai-je besoin d'un visa pour aller de la France au Japon », « quels documents un citoyen américain doit-il fournir pour la Chine », « puis-je quitter l'aéroport pendant une escale à Istanbul avec un passeport indien » — avec des données, pas une supposition.

Compatibilité

Le serveur communique via MCP sur stdio et fonctionne sur Node.js 18 ou version ultérieure. Il fonctionne avec tout client MCP capable de lancer un serveur stdio, y compris Claude Desktop, Claude Code et Cursor. Le bloc de configuration ci-dessous est le même pour tous.

Installation

npx orizn-visa-mcp

Rien à compiler, rien à cloner. Ajoutez-le à la configuration de votre client MCP :

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

Redémarrez le client, puis demandez : « Ai-je besoin d'un visa pour aller de la France au Japon ? » — cela fonctionne sans clé API, 10 vérifications par jour.

Pour tout le reste (documents, frais, délais de traitement, règles de transit, 15 langues), ajoutez une clé gratuite :

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

La clé peut également être transmise comme argument, ce qui a priorité sur la variable d'environnement :

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

Exemples de questions

• « Ai-je besoin d'un visa pour voyager de la France vers la Thaïlande ? »
• « Quels documents un citoyen américain visitant la Chine doit-il fournir ? »
• « Comparez la Thaïlande, le Vietnam et l'Indonésie pour un passeport brésilien. »
• « Puis-je quitter l'aéroport pendant une escale de 12 h à Istanbul avec un passeport chinois ? »
• « Combien coûte un visa Schengen pour un titulaire de passeport philippin ? »
• « Quelles vaccinations sont nécessaires pour entrer au Brésil avec un passeport français ? »
• « Quelle est l'amende si je dépasse la durée de mon visa thaïlandais de 3 jours ? »
• « Le Portugal propose-t-il un visa nomade numérique, et quel est son coût ? »
• « Réponds en français : ai-je besoin d'un visa pour le Japon avec un passeport marocain ? »

Outils

Outil	Arguments	Ce qu'il retourne	Plan
check_visa_requirement	passport, destination, lang	Exigences d'entrée complètes pour un passeport vers une destination : type d'exigence, jours autorisés, documents, étapes de demande, frais, délais de traitement, validité du passeport, spécifications photo, vaccinations, assurance, avis de sécurité, pénalités de dépassement de séjour, entrée par air/terre/mer, visa de travail à distance, règles de prolongation et pour mineurs, ambassades.	Toute clé
quick_visa_check	passport, destination	Une ligne : le code d'exigence, le nombre de jours sans visa, et la date de dernière vérification de la paire. Pas de documents, pas de frais, pas de traduction.	Aucune — 10/jour sans clé, illimité avec toute clé
compare_destinations	passport, destinations (1–25), lang	Jusqu'à 25 destinations pour un passeport, côte à côte : exigence, jours sans visa, description, validité du passeport, frais, sécurité, santé, vaccinations, assurance, entrée par mode, visa de travail à distance. Chaque destination retournée compte comme une requête.	Starter ou supérieur
check_transit_visa	passport, transit_country, lang	Règles d'escale uniquement : si le voyageur peut rester côté air ou quitter l'aéroport pendant la correspondance, et combien d'heures de transit gratuites les principaux hubs accordent.	Starter ou supérieur
get_coverage_stats	aucun	Taille de la base de données : paires, passeports, destinations, traductions, langues, et répartition des types d'exigences. Ne dit rien sur une paire spécifique.	Aucune
get_recent_changes	passport, destination, since, limit (tous facultatifs)	Règles de visa modifiées récemment, avec la source qui les a signalées et la date. Le flux est actuellement désactivé — voir ci-dessous.	Aucune

Les codes pays sont au format ISO 3166-1 alpha-3 (FRA, JPN, USA), pas alpha-2.

requirement est l'un des visa_free, visa_required, e_visa, visa_on_arrival, eta, no_admission, plus les plus rares partial_restrictions, admission_refused, not_applicable et special.

Ressource

visa://supported-languages — les 15 codes acceptés par lang, disponibles sur tous les plans, y compris gratuit : en fr es pt de ja ko zh ru it ar hi th vi tl.

get_recent_changes ne retourne volontairement rien

Le flux de changements de politique d'Orizn est désactivé. Il servait des incohérences détectées entre deux tables internes d'Orizn comme s'il s'agissait de changements de politique officiels. Il retourne donc désormais HTTP 503 et cet outil se dégrade en :

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

L'outil est livré dans cet état délibérément : une réponse vide et clairement étiquetée est la réponse honnête, et l'outil commencera à retourner de vraies entrées le jour où le flux fonctionnera sur des sources officielles vérifiées — auquel cas les entrées sans source nommée et sans date seront retenues plutôt qu'affichées.

Authentification et offre gratuite

quick_visa_check, get_coverage_stats et get_recent_changes fonctionnent sans aucune clé API. Le quick_visa_check sans clé est plafonné à 10 vérifications par jour — la même allocation que celle accordée à un visiteur anonyme sur visa.orizn.app. Au-delà, l'outil le signale et oriente vers la clé gratuite plutôt que d'échouer silencieusement. Le plafond s'applique par processus serveur en cours d'exécution et se réinitialise à 00:00 UTC.

Les trois autres outils nécessitent une clé API, envoyée comme en-tête x-api-key à https://visa.orizn.app/api/v1/visa.

Obtenez-en une gratuitement sur visa.orizn.app/visa-api — sans carte de crédit. L'offre gratuite est de 100 requêtes/mois (5 jusqu'à confirmation de votre adresse e-mail) et inclut les champs essentiels et les 15 langues. Sur le plan gratuit, les champs plus approfondis — frais, jours de traitement, spécifications photo, vaccinations, assurance, visas de transit, entrée par mode, pénalités de dépassement de séjour, visas de travail à distance, ambassades — reviennent comme un espace réservé {"upgrade": "..."}, et compare_destinations et check_transit_visa sont restreints.

Starter coûte 49 $/mois pour 30 000 requêtes et débloque tout, avec une licence commerciale : mise à niveau. Des plans à volume plus élevé sont listés sur la page de tarification.

Passez la clé dans le bloc env de la configuration MCP — les clients MCP n'héritent pas de l'environnement de votre shell, donc exporter ORIZN_API_KEY dans un terminal ne suffit pas.

Vérifiez une clé sans aucun client 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 }

Dépannage

Symptôme	Correctif
« Aucune clé API Orizn »	Attendu sur les outils réservés aux clés. quick_visa_check répond toujours. Pour lever cela, placez la clé dans le bloc env du fichier de configuration — pas dans votre shell — puis redémarrez le client
« Limite quotidienne sans clé atteinte »	Les 10 vérifications gratuites d'aujourd'hui sont épuisées. Une clé gratuite supprime le plafond
HTTP 403, « vérifiez ORIZN_API_KEY pour les fautes de frappe »	La clé est incorrecte, révoquée ou contient des espaces
HTTP 403, « nécessite le plan Starter ou supérieur »	Bonne clé, mauvais plan — cet outil est payant
HTTP 429	Quota mensuel épuisé
HTTP 404 sur un pays réel	Utilisez les codes alpha-3 (FRA, JPN), pas alpha-2 (FR, JP)
Rien ne fonctionne du tout	Appelez get_coverage_stats — il ne nécessite aucune clé. Si cela échoue aussi, c'est le réseau
get_recent_changes retourne une liste vide	Attendu — le flux est en cours de reconstruction. Cela ne signifie pas que les règles sont inchangées

Liens

• Site web — visa.orizn.app
• Documentation API — visa.orizn.app/visa-api/dashboard/docs
• Obtenir une clé gratuite — visa.orizn.app/visa-api
• GitHub — github.com/MattJeff/orizn-mcp-server
• Support — api@orizn.app

Licence

MIT