orizn-visa-mcp

Orizn Visa API MCP Server

Orizn Visa API MCP Server は、あらゆるパスポートと渡航先の組み合わせについて、ビザや入国要件を15言語で回答する Model Context Protocol（MCP）サーバーです。

対応範囲は拡大しています。古くなってしまう数値をここに記載する代わりに、get_coverage_stats ツールでAPIから最新の数値を取得します（https://visa.orizn.app/api/v1/visa/stats でも公開されています）。

「フランスから日本へ行くのにビザは必要ですか」「米国市民が中国へ行くにはどんな書類が必要ですか」「インドのパスポートでイスタンブールに乗り継ぐ際、空港の外へ出られますか」といった質問に、推測ではなくデータに基づいて回答します。

互換性

このサーバーは stdio 経由でMCPと通信し、Node.js 18以降で動作します。Claude Desktop、Claude Code、Cursorなど、stdioサーバーを起動できるあらゆるMCPクライアントで使用できます。以下の設定ブロックは、どのクライアントでも同じです。

インストール

npx orizn-visa-mcp

ビルドもクローンも不要です。MCPクライアントの設定に追加してください。

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

クライアントを再起動してから、「フランスから日本へ行くのにビザは必要ですか？」と尋ねてください。APIキーなしで利用でき、1日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日過ぎた場合、罰金はいくらですか？」
• 「ポルトガルにはデジタルノマドビザがありますか？費用はいくらですか？」
• 「フランス語で回答してください。モロッコのパスポートで日本へ行くのにビザは必要ですか？」

ツール

ツール	引数	返される内容	プラン
check_visa_requirement	passport、destination、lang	あるパスポートで特定の渡航先に入国する際の要件全般：要件の種類、滞在可能日数、必要書類、申請手順、手数料、処理時間、パスポートの有効期間、写真の仕様、予防接種、保険、安全に関する勧告、不法滞在の罰則、空路・陸路・海路での入国、リモートワークビザ、延長と未成年者に関する規則、大使館。	すべてのキー
quick_visa_check	passport、destination	1行で、要件コード、ビザなしで滞在できる日数、対象の組み合わせが最後に確認された日付を返します。書類、手数料、翻訳は含まれません。	なし — キーなしで1日10回、任意のキーがあれば無制限
compare_destinations	passport、destinations（1～25）、lang	1つのパスポートについて、最大25か国・地域の情報を並べて比較します：要件、ビザなしで滞在できる日数、説明、パスポートの有効期間、手数料、安全、健康、予防接種、保険、入国手段、リモートワークビザ。返される渡航先ごとに1回のリクエストとしてカウントされます。	Starter 以上
check_transit_visa	passport、transit_country、lang	乗り継ぎ時の規則のみ：乗客が空港の制限区域内にとどまる必要があるか、または空港の外に出られるか、主要ハブ空港で認められる無料の乗り継ぎ時間を返します。	Starter 以上
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 内部の2つのテーブル間で検出された不一致を、公式な政策変更であるかのように配信していました。そのため現在は 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 キーなしで動作します。API キーなしの quick_visa_check は、1 日あたり 10 回までに制限されています。これは visa.orizn.app で匿名ユーザーに提供されるのと同じ回数です。上限に達すると、ツールはその旨を通知し、無料キーを案内します。エラーを出さずに失敗することはありません。上限は実行中のサーバープロセスごとに適用され、毎日 00:00 UTC にリセットされます。

ほかの 3 つのツールでは、https://visa.orizn.app/api/v1/visa に x-api-key ヘッダーとして API キーを送信する必要があります。

visa.orizn.app/visa-api から無料キーを取得できます。クレジットカードは不要です。無料プランでは 月 100 リクエスト（メールアドレスの確認前は 5 リクエスト）が利用でき、主要なフィールドと 15 言語すべてが含まれます。無料プランでは、詳細フィールド（手数料、処理日数、写真の仕様、予防接種、保険、トランジットビザ、入国手段別の情報、オーバーステイの罰則、リモートワークビザ、大使館）は {"upgrade": "..."} というプレースホルダーを返し、compare_destinations と check_transit_visa は利用できません。

Starter は月額 49 ドルで、30,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」	API キーが必要なツールでは想定どおりの表示です。quick_visa_check は引き続き回答します。制限を解除するには、シェルではなく設定ファイルの env ブロックにキーを設定し、クライアントを再起動してください
「Keyless daily limit reached」	本日の無料チェック 10 回を使い切りました。無料キーを使えば上限が解除されます
HTTP 403、「check ORIZN_API_KEY for typos」	キーが間違っている、取り消されている、または空白文字が含まれています
HTTP 403、「requires Starter plan or above」	キーは正しいですが、プランが異なります。このツールは有料です
HTTP 429	月間クォータを使い切りました
実在する国で HTTP 404	alpha-2（FR、JP）ではなく、alpha-3 コード（FRA、JPN）を使ってください
何も動作しない	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
• サポート — [email protected]

ライセンス

MIT