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

Dieses MCP ausprobierenGesponsert

Was kann man mit Orizn Visa MCP machen?

Visabestimmungen prüfen — Fragen Sie „Brauche ich ein Visum für Frankreich nach Japan?“ und erhalten Sie vollständige Einreiseregeln über check_visa_requirement, einschließlich Dokumenten, Gebühren und Bearbeitungszeiten.
Schneller Visastatus — Verwenden Sie quick_visa_check für eine einzeilige Antwort zu Visumanforderungen und visafreien Tagen, ohne API-Schlüssel (10 Prüfungen/Tag).
Reiseziele vergleichen — Bitten Sie darum, bis zu 25 Länder für einen Reisepass nebeneinander mit compare_destinations zu vergleichen, einschließlich Gebühren, Sicherheit und Gesundheitsanforderungen.
Transitvisum-Regeln — Prüfen Sie Zwischenstopp-Regeln mit check_transit_visa, einschließlich der Frage, ob Sie den Flughafen verlassen dürfen, sowie kostenlose Transitstunden an großen Drehkreuzen.
Abdeckungsstatistiken — Fragen Sie „Wie viele Länder sind abgedeckt?“ und erhalten Sie Live-Datenbankstatistiken über get_coverage_stats, ohne Schlüssel erforderlich.
Mehrsprachige Unterstützung — Erhalten Sie Visumantworten in einer von 15 Sprachen (z. B. Französisch, Spanisch, Japanisch), indem Sie den Parameter lang angeben.

Dokumentation

Orizn Visa API MCP Server

Orizn Visa API MCP Server ist ein Model Context Protocol (MCP)-Server, der einem KI-Assistenten die Visum- und Einreisebestimmungen für jedes Pass-/Zielland-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: „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 Zielland: Anforderungstyp, erlaubte Tage, Dokumente, Antragsschritte, Gebühren, Bearbeitungszeiten, Passgültigkeit, Fotovorgaben, Impfungen, Versicherung, Sicherheitshinweise, Überziehungsstrafen, Einreise per Luft/Land/See, Remote-Work-Visum, Verlängerungs- und Minderjährigenregeln, Botschaften.	Jeder Schlüssel
`quick_visa_check`	`passport`, `destination`	Eine Zeile: der Anforderungscode, die Anzahl visumfreier 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 nebeneinander: 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.	Hobby oder höher
`check_transit_visa`	`passport`, `transit_country`, `lang`	Nur Transitregeln: ob der Reisende im Luftseitenbereich bleiben oder den Flughafen während des Umsteigens verlassen darf und wie viele kostenlose Transitstunden die wichtigsten Drehkreuze gewähren.	Hobby 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 auf 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 deaktiviert. 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 echte Einträge zurückzugeben, sobald der Feed mit verifizierten offiziellen Quellen läuft – wobei Einträge ohne benannte Quelle und Datum dann zurückgehalten statt angezeigt werden.

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. Die Begrenzung gilt pro laufendem Serverprozess und setzt sich um 00:00 UTC zurück.

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 50 Anfragen/Monat (5 bis Sie Ihre E-Mail-Adresse bestätigen) und enthält 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.

Hobby kostet 9 $/Monat für 10.000 Anfragen und schaltet alles frei: Upgrade. Pläne 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 den Client neu starten
„Keyless daily limit reached“	Die 10 kostenlosen Prüfungen für heute sind aufgebraucht. Ein kostenloser Schlüssel entfernt die Begrenzung
HTTP 403, „check ORIZN_API_KEY for typos“	Schlüssel ist falsch, widerrufen oder enthält Leerzeichen
HTTP 403, „requires Hobby 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