Orizn Visa

officiel

Exigences de visa pour 39 585 paires passeport-destination en 15 langues. Vérifiez les types de visa, les documents et les conseils de voyage pour toute combinaison de pays.

GitHub

Essayer ce MCPSponsorisé

Que pouvez-vous faire avec Orizn Visa MCP ?

Vérifier les exigences de visa — Demandez « ai-je besoin d'un visa pour la France vers le Japon ? » et obtenez toutes les règles d'entrée via check_visa_requirement, y compris les documents, les frais et les délais de traitement.
Statut de visa rapide — Utilisez quick_visa_check pour une réponse en une ligne sur l'exigence de visa et les jours sans visa, sans clé API requise (10 vérifications/jour).
Comparer les destinations — Demandez à comparer jusqu'à 25 pays pour un passeport côte à côte avec compare_destinations, couvrant les frais, la sécurité et les exigences de santé.
Règles de visa de transit — Vérifiez les règles d'escale avec check_transit_visa, y compris si vous pouvez quitter l'aéroport et les heures de transit gratuites dans les grands hubs.
Statistiques de couverture — Demandez « combien de pays sont couverts ? » et obtenez des statistiques en direct de la base de données via get_coverage_stats, sans clé requise.
Support multilingue — Obtenez des réponses sur les visas dans l'une des 15 langues (par exemple, français, espagnol, japonais) en spécifiant le paramètre lang.

Documentation

Serveur MCP Orizn Visa API

Le serveur MCP Orizn Visa API 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 parle MCP via 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 prix ? »
« 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 pour extensions et 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.	Hobby 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.	Hobby 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 récemment modifiées, 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 rien volontairement

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 visa.orizn.app accorde à un visiteur anonyme. 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 50 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.

Hobby coûte 9 $/mois pour 10 000 requêtes et débloque tout : mise à niveau. Les 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 votre environnement 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
« No Orizn API key »	Attendu sur les outils nécessitant une clé. `quick_visa_check` répond toujours. Pour lever le blocage, placez la clé dans le bloc `env` du fichier de configuration — pas dans votre shell — puis redémarrez le client
« Keyless daily limit reached »	Les 10 vérifications gratuites d'aujourd'hui sont épuisées. Une clé gratuite supprime le plafond
HTTP 403, « check ORIZN_API_KEY for typos »	La clé est incorrecte, révoquée, ou contient des espaces
HTTP 403, « requires Hobby plan or above »	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