Orizn Visa

Máy chủ MCP API Orizn Visa

Máy chủ MCP API Orizn Visa là một máy chủ Giao thức Ngữ cảnh Mô hình (MCP) cung cấp cho trợ lý AI các yêu cầu thị thực và nhập cảnh cho bất kỳ cặp hộ chiếu/điểm đến nào, được trả lời bằng 15 ngôn ngữ.

Phạm vi bao phủ ngày càng tăng: thay vì in một con số ở đây có thể trở nên lỗi thời, công cụ get_coverage_stats đọc trực tiếp từ API (cũng công khai tại https://visa.orizn.app/api/v1/visa/stats).

Nó trả lời các câu hỏi như "tôi có cần thị thực để đi từ Pháp đến Nhật Bản không", "công dân Hoa Kỳ cần những giấy tờ gì để đến Trung Quốc", "tôi có thể rời sân bay trong lúc quá cảnh ở Istanbul bằng hộ chiếu Ấn Độ không" — với dữ liệu, không phải phỏng đoán.

Tương thích

Máy chủ nói MCP qua stdio và chạy trên Node.js 18 trở lên. Nó hoạt động với bất kỳ máy khách MCP nào có thể khởi chạy máy chủ stdio, bao gồm Claude Desktop, Claude Code và Cursor. Khối cấu hình bên dưới giống nhau cho tất cả các máy khách này.

Cài đặt

npx orizn-visa-mcp

Không cần xây dựng gì, không cần sao chép gì. Thêm nó vào cấu hình máy khách MCP của bạn:

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

Khởi động lại máy khách, sau đó hỏi: "Tôi có cần thị thực để đi từ Pháp đến Nhật Bản không?" — điều đó hoạt động mà không cần khóa API, 10 lần kiểm tra mỗi ngày.

Đối với mọi thứ khác (giấy tờ, phí, thời gian xử lý, quy tắc quá cảnh, 15 ngôn ngữ), hãy thêm một khóa miễn phí:

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

Khóa cũng có thể được truyền dưới dạng đối số, có quyền ưu tiên hơn biến môi trường:

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

Câu hỏi ví dụ

• "Tôi có cần thị thực để đi từ Pháp đến Thái Lan không?"
• "Công dân Hoa Kỳ đến thăm Trung Quốc cần những giấy tờ gì?"
• "So sánh Thái Lan, Việt Nam và Indonesia cho hộ chiếu Brazil."
• "Tôi có thể rời sân bay trong lúc quá cảnh 12 giờ ở Istanbul bằng hộ chiếu Trung Quốc không?"
• "Thị thực Schengen có giá bao nhiêu cho người giữ hộ chiếu Philippines?"
• "Tôi cần tiêm phòng gì để vào Brazil bằng hộ chiếu Pháp?"
• "Mức phạt nếu tôi ở quá hạn thị thực Thái Lan 3 ngày là bao nhiêu?"
• "Bồ Đào Nha có thị thực du mục kỹ thuật số không và chi phí là bao nhiêu?"
• "Réponds en français : ai-je besoin d'un visa pour le Japon avec un passeport marocain ?"

Công cụ

Công cụ	Đối số	Nội dung trả về	Gói
check_visa_requirement	passport, destination, lang	Toàn bộ yêu cầu nhập cảnh cho một hộ chiếu vào một điểm đến: loại yêu cầu, số ngày được phép, giấy tờ, các bước xin, phí, thời gian xử lý, thời hạn hộ chiếu, thông số ảnh, tiêm chủng, bảo hiểm, khuyến cáo an toàn, hình phạt quá hạn, nhập cảnh bằng đường hàng không/đường bộ/đường biển, thị thực làm việc từ xa, quy tắc gia hạn và trẻ vị thành niên, đại sứ quán.	Bất kỳ khóa nào
quick_visa_check	passport, destination	Một dòng: mã yêu cầu, số ngày miễn thị thực và ngày cặp được xác minh lần cuối. Không có giấy tờ, không có phí, không có bản dịch.	Không — 10/ngày không cần khóa, không giới hạn với bất kỳ khóa nào
compare_destinations	passport, destinations (1–25), lang	Tối đa 25 điểm đến cho một hộ chiếu cạnh nhau: yêu cầu, số ngày miễn thị thực, mô tả, thời hạn hộ chiếu, phí, an toàn, sức khỏe, tiêm chủng, bảo hiểm, nhập cảnh theo phương thức, thị thực làm việc từ xa. Mỗi điểm đến được trả về tính là một yêu cầu.	Starter trở lên
check_transit_visa	passport, transit_country, lang	Chỉ quy tắc quá cảnh: hành khách có thể ở khu vực airside hoặc rời sân bay khi nối chuyến hay không và các sân bay chính cấp bao nhiêu giờ quá cảnh miễn phí.	Starter trở lên
get_coverage_stats	không có	Kích thước cơ sở dữ liệu: cặp, hộ chiếu, điểm đến, bản dịch, ngôn ngữ và phân bố các loại yêu cầu. Không nói gì về một cặp cụ thể.	Không
get_recent_changes	passport, destination, since, limit (tất cả tùy chọn)	Các quy tắc thị thực thay đổi gần đây, kèm nguồn báo cáo và ngày. Nguồn cấp hiện đang tắt — xem bên dưới.	Không

Mã quốc gia là ISO 3166-1 alpha-3 (FRA, JPN, USA), không phải alpha-2.

requirement là một trong visa_free, visa_required, e_visa, visa_on_arrival, eta, no_admission, cộng với các loại hiếm hơn partial_restrictions, admission_refused, not_applicable và special.

Tài nguyên

visa://supported-languages — 15 mã được chấp nhận bởi lang, có sẵn trên mọi gói bao gồm cả miễn phí: en fr es pt de ja ko zh ru it ar hi th vi tl.

get_recent_changes cố tình không trả về gì

Nguồn cấp thay đổi chính sách của Orizn đang bị tắt. Nó đã phục vụ các điểm không nhất quán được phát hiện giữa hai bảng nội bộ của Orizn như thể chúng là các thay đổi chính sách chính thức, vì vậy hiện tại nó trả về HTTP 503 và công cụ này giảm cấp thành:

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

Công cụ được phát hành ở trạng thái này một cách có chủ đích: một câu trả lời trống, được gắn nhãn rõ ràng là câu trả lời trung thực và công cụ bắt đầu trả về các mục thực vào ngày nguồn cấp chạy trên các nguồn chính thức đã được xác minh — tại thời điểm đó, các mục không có nguồn được đặt tên và ngày tháng sẽ bị giữ lại thay vì hiển thị.

Xác thực và gói miễn phí

quick_visa_check, get_coverage_stats và get_recent_changes hoạt động mà không cần khóa API nào cả. quick_visa_check không cần khóa bị giới hạn ở 10 lần kiểm tra mỗi ngày — cùng mức cho phép mà visa.orizn.app cấp cho khách truy cập ẩn danh. Vượt quá mức đó, công cụ sẽ nói rõ và chỉ đến khóa miễn phí thay vì thất bại âm thầm. Giới hạn là trên mỗi tiến trình máy chủ đang chạy và được đặt lại lúc 00:00 UTC.

Ba công cụ còn lại cần khóa API, được gửi dưới dạng tiêu đề x-api-key đến https://visa.orizn.app/api/v1/visa.

Nhận một khóa miễn phí tại visa.orizn.app/visa-api — không cần thẻ tín dụng. Gói miễn phí là 100 yêu cầu/tháng (5 cho đến khi bạn xác nhận địa chỉ email) và bao gồm các trường cốt lõi và tất cả 15 ngôn ngữ. Trên gói miễn phí, các trường sâu hơn — phí, số ngày xử lý, thông số ảnh, tiêm chủng, bảo hiểm, thị thực quá cảnh, nhập cảnh theo phương thức, hình phạt quá hạn, thị thực làm việc từ xa, đại sứ quán — được trả về dưới dạng trình giữ chỗ {"upgrade": "..."} và compare_destinations và check_transit_visa bị giới hạn.

Starter có giá $49/tháng cho 30.000 yêu cầu và mở khóa tất cả, kèm giấy phép thương mại: nâng cấp. Các gói có khối lượng cao hơn được liệt kê trên trang giá.

Truyền khóa trong khối env của cấu hình MCP — máy khách MCP không kế thừa môi trường shell của bạn, vì vậy xuất ORIZN_API_KEY trong terminal là không đủ.

Kiểm tra khóa mà không cần bất kỳ máy khách MCP nào:

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 }

Xử lý sự cố

Triệu chứng	Cách khắc phục
"Không có khóa API Orizn"	Dự kiến trên các công cụ chỉ dành cho khóa. quick_visa_check vẫn trả lời. Để gỡ bỏ, hãy đặt khóa trong khối env của tệp cấu hình — không phải shell của bạn — sau đó khởi động lại máy khách
"Đã đạt giới hạn hàng ngày không cần khóa"	10 lần kiểm tra miễn phí hôm nay đã hết. Khóa miễn phí sẽ gỡ bỏ giới hạn
HTTP 403, "kiểm tra ORIZN_API_KEY xem có lỗi chính tả không"	Khóa sai, bị thu hồi hoặc có khoảng trắng
HTTP 403, "yêu cầu gói Starter trở lên"	Khóa đúng, gói sai — công cụ này trả phí
HTTP 429	Hạn mức hàng tháng đã hết
HTTP 404 trên một quốc gia thực	Sử dụng mã alpha-3 (FRA, JPN), không phải alpha-2 (FR, JP)
Không có gì hoạt động	Gọi get_coverage_stats — nó không cần khóa. Nếu điều đó cũng thất bại, thì đó là vấn đề mạng
get_recent_changes trả về danh sách trống	Dự kiến — nguồn cấp đang được xây dựng lại. Điều đó không có nghĩa là các quy tắc không thay đổi

Liên kết

• Trang web — visa.orizn.app
• Tài liệu API — visa.orizn.app/visa-api/dashboard/docs
• Nhận khóa miễn phí — visa.orizn.app/visa-api
• GitHub — github.com/MattJeff/orizn-mcp-server
• Hỗ trợ — api@orizn.app

Giấy phép

MIT