Orizn Visa

offiziell

Visabestimmungen für 39.585 Pass-Ziel-Paare in 15 Sprachen. Überprüfen Sie Visatypen, Dokumente und Reisetipps für jede Länderkombination.

GitHub

Was kann man mit Orizn Visa MCP machen?

Visumanforderungen prüfen — Fragen Sie nach den vollständigen Einreisebestimmungen für jedes Pass-/Zielpaar über check_visa_requirement, einschließlich Dokumenten, Gebühren und Bearbeitungszeiten.
Schneller Visastatus — Erhalten Sie eine einzeilige Visumauskunft mit quick_visa_check (kein API-Schlüssel erforderlich, 10 kostenlose Checks täglich).
Ziele vergleichen — Nutzen Sie compare_destinations, um bis zu 25 Länder nebeneinander für einen Pass zu sehen, einschließlich Gebühren, Sicherheit und Gesundheitsanforderungen.
Transitvisumregeln — Fragen Sie check_transit_visa, ob Sie den Flughafen während eines Zwischenstopps verlassen dürfen und wie viele kostenlose Transitstunden Drehkreuze gewähren.
Abdeckungsstatistiken — Überprüfen Sie die Datenbankgröße und die Verteilung der Anforderungstypen mit get_coverage_stats (funktioniert ohne Schlüssel).

Dokumentation

Orizn Visa API MCP Server

Der Orizn Visa API MCP Server ist ein Model Context Protocol (MCP)-Server, der einem KI-Assistenten die Visum- und Einreisebestimmungen für jedes Pass/Ziel-Paar liefert – beantwortet in 15 Sprachen.

Die Abdeckung wächst: Statt hier eine Zahl zu nennen, die schnell veraltet, liest das get_coverage_stats-Tool sie live von der API (auch öffentlich unter https://visa.orizn.app/api/v1/visa/stats).

Es beantwortet Fragen wie „Brauche ich ein Visum, um von Frankreich nach Japan zu reisen?“, „Welche Dokumente benötigt ein US-Bürger für China?“, „Kann ich während eines Zwischenstopps in Istanbul mit indischem Pass den Flughafen verlassen?“ – mit Daten, nicht mit Vermutungen.

Kompatibilität

Der Server spricht MCP über stdio und läuft auf Node.js 18 oder neuer. Er funktioniert mit jedem MCP-Client, der einen stdio-Server starten kann, einschließlich Claude Desktop, Claude Code und Cursor. Der Konfigurationsblock unten ist für alle gleich.

Installation

npx orizn-visa-mcp

Nichts zu bauen, nichts zu klonen. Fügen Sie ihn zu Ihrer MCP-Client-Konfiguration hinzu:

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

Starten Sie den Client neu und fragen Sie dann: „Brauche ich ein Visum, um von Frankreich nach Japan zu reisen?“ – das funktioniert ohne API-Schlüssel, 10 Prüfungen pro Tag.

Für alles andere (Dokumente, Gebühren, Bearbeitungszeiten, Transitregeln, 15 Sprachen) fügen Sie einen kostenlosen Schlüssel hinzu:

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

Der Schlüssel kann auch als Argument übergeben werden, das Vorrang vor der Umgebungsvariable hat:

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

Beispielfragen

„Brauche ich ein Visum, um von Frankreich nach Thailand zu reisen?“
„Welche Dokumente benötige ich als US-Bürger für einen Besuch in China?“
„Vergleiche Thailand, Vietnam und Indonesien für einen brasilianischen Pass.“
„Kann ich während eines 12-stündigen Zwischenstopps in Istanbul mit chinesischem Pass den Flughafen verlassen?“
„Wie viel kostet ein Schengen-Visum für einen philippinischen Passinhaber?“
„Welche Impfungen benötige ich für die Einreise nach Brasilien mit französischem Pass?“
„Wie hoch ist die Strafe, wenn ich mein thailändisches Visum um 3 Tage überziehe?“
„Hat Portugal ein Digital-Nomaden-Visum und was kostet es?“
„Réponds en français : ai-je besoin d'un visa pour le Japon avec un passeport marocain ?“

Tools

Tool	Argumente	Was es zurückgibt	Plan
`check_visa_requirement`	`passport`, `destination`, `lang`	Vollständige Einreisebestimmungen für einen Pass in ein Ziel: Anforderungstyp, erlaubte Tage, Dokumente, Antragsschritte, Gebühren, Bearbeitungszeiten, Passgültigkeit, Fotovorgaben, Impfungen, Versicherung, Sicherheitshinweise, Überziehungsstrafen, Einreise auf dem Luft-/Land-/Seeweg, Remote-Work-Visum, Verlängerungs- und Minderjährigenregeln, Botschaften.	Jeder Schlüssel
`quick_visa_check`	`passport`, `destination`	Eine Zeile: der Anforderungscode, die Anzahl der visumfreien Tage und das Datum der letzten Überprüfung des Paares. Keine Dokumente, keine Gebühren, keine Übersetzung.	Keiner – 10/Tag ohne Schlüssel, unbegrenzt mit jedem Schlüssel
`compare_destinations`	`passport`, `destinations` (1–25), `lang`	Bis zu 25 Ziele für einen Pass im Vergleich: Anforderung, visumfreie Tage, Beschreibung, Passgültigkeit, Gebühr, Sicherheit, Gesundheit, Impfungen, Versicherung, Einreise nach Art, Remote-Work-Visum. Jedes zurückgegebene Ziel zählt als eine Anfrage.	Starter oder höher
`check_transit_visa`	`passport`, `transit_country`, `lang`	Nur Zwischenstoppregeln: ob der Reisende während des Umsteigens im Luftseitenbereich bleiben oder den Flughafen verlassen darf und wie viele kostenlose Transitstunden die wichtigsten Drehkreuze gewähren.	Starter oder höher
`get_coverage_stats`	keine	Größe der Datenbank: Paare, Pässe, Ziele, Übersetzungen, Sprachen und die Verteilung der Anforderungstypen. Sagt nichts über ein bestimmtes Paar aus.	Keiner
`get_recent_changes`	`passport`, `destination`, `since`, `limit` (alle optional)	Kürzlich geänderte Visaregeln mit der Quelle, die sie gemeldet hat, und dem Datum. Der Feed ist derzeit deaktiviert – siehe unten.	Keiner

Ländercodes sind ISO 3166-1 alpha-3 (FRA, JPN, USA), nicht alpha-2.

requirement ist eines von visa_free, visa_required, e_visa, visa_on_arrival, eta, no_admission, plus die selteneren partial_restrictions, admission_refused, not_applicable und special.

Ressource

visa://supported-languages – die 15 Codes, die von lang akzeptiert werden, verfügbar in jedem Plan einschließlich kostenlos: en fr es pt de ja ko zh ru it ar hi th vi tl.

`get_recent_changes` gibt absichtlich nichts zurück

Orizns Feed für Richtlinienänderungen ist abgeschaltet. Er lieferte Inkonsistenzen, die zwischen zwei internen Orizn-Tabellen erkannt wurden, als wären es offizielle Richtlinienänderungen. Daher gibt er jetzt HTTP 503 zurück und dieses Tool degradiert zu:

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

Das Tool wird bewusst in diesem Zustand ausgeliefert: Eine leere, klar gekennzeichnete Antwort ist die ehrliche, und das Tool beginnt erst dann echte Einträge zurückzugeben, wenn der Feed auf verifizierten offiziellen Quellen läuft – in diesem Fall werden Einträge ohne benannte Quelle und Datum zurückgehalten statt angezeigt.

Authentifizierung und kostenloser Tarif

quick_visa_check, get_coverage_stats und get_recent_changes funktionieren ganz ohne API-Schlüssel. Schlüsselloses quick_visa_check ist auf 10 Prüfungen pro Tag begrenzt – dieselbe Freigrenze, die visa.orizn.app einem anonymen Besucher gewährt. Danach sagt das Tool dies und verweist auf den kostenlosen Schlüssel, statt still zu scheitern. Das Limit gilt pro laufendem Serverprozess und wird um 00:00 UTC zurückgesetzt.

Die anderen drei Tools benötigen einen API-Schlüssel, der als x-api-key-Header an https://visa.orizn.app/api/v1/visa gesendet wird.

Holen Sie sich einen kostenlosen unter visa.orizn.app/visa-api – keine Kreditkarte erforderlich. Der kostenlose Tarif umfasst 100 Anfragen/Monat (5 bis Sie Ihre E-Mail-Adresse bestätigen) und beinhaltet die Kernfelder und alle 15 Sprachen. Im kostenlosen Plan kommen die tieferen Felder – Gebühren, Bearbeitungstage, Fotovorgaben, Impfungen, Versicherung, Transitvisa, Einreise nach Art, Überziehungsstrafen, Remote-Work-Visa, Botschaften – als {"upgrade": "..."}-Platzhalter zurück, und compare_destinations und check_transit_visa sind gesperrt.

Starter kostet 49 $/Monat für 30.000 Anfragen und schaltet alles frei, mit einer kommerziellen Lizenz: Upgrade. Tarife mit höherem Volumen sind auf der Preisseite aufgelistet.

Geben Sie den Schlüssel im env-Block der MCP-Konfiguration an – MCP-Clients übernehmen Ihre Shell-Umgebung nicht, daher reicht das Exportieren von ORIZN_API_KEY in einem Terminal nicht aus.

Prüfen Sie einen Schlüssel ohne MCP-Client:

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 }

Fehlerbehebung

Symptom	Lösung
„No Orizn API key“	Erwartet bei den schlüsselpflichtigen Tools. `quick_visa_check` antwortet weiterhin. Zum Beheben den Schlüssel in den `env`-Block der Konfigurationsdatei setzen – nicht in die Shell – und dann den Client neu starten
„Keyless daily limit reached“	Die 10 kostenlosen Prüfungen für heute sind aufgebraucht. Ein kostenloser Schlüssel entfernt das Limit
HTTP 403, „check ORIZN_API_KEY for typos“	Schlüssel ist falsch, widerrufen oder enthält Leerzeichen
HTTP 403, „requires Starter plan or above“	Richtiger Schlüssel, falscher Plan – dieses Tool ist kostenpflichtig
HTTP 429	Monatskontingent aufgebraucht
HTTP 404 bei einem echten Land	Alpha-3-Codes verwenden (`FRA`, `JPN`), nicht alpha-2 (`FR`, `JP`)
Nichts funktioniert	`get_coverage_stats` aufrufen – es benötigt keinen Schlüssel. Wenn auch das fehlschlägt, liegt es am Netzwerk
`get_recent_changes` gibt eine leere Liste zurück	Erwartet – der Feed wird neu aufgebaut. Es bedeutet nicht, dass die Regeln unverändert sind

Lizenz

MIT