Orizn MCP Server

What MattJeff/orizn-mcp-server MCP server does

MattJeff/orizn-mcp-server MCP server connects an MCP client to the Orizn Visa API. It provides visa and entry information for passport and destination pairs, including requirement categories such as visa-free entry, e-visa, visa on arrival, ETA, visa required, and no admission. The dataset covers 39,585 passport-destination pairs, 199 destinations, and 15 response languages according to the supplied listing and server documentation.

The detailed lookup can include permitted stay, required documents, application steps, fees, processing times, passport validity, photo requirements, vaccinations, insurance, safety and health information, overstay penalties, entry by air, land, or sea, remote-work visas, extensions, minor rules, and embassy information. Results depend on the selected plan and API key.

How it works

The server communicates with MCP clients through stdio and runs on Node.js 18 or later. A client launches the npm package as a local process, and the process calls Orizn’s API at https://visa.orizn.app/api/v1/visa. Country values must use ISO 3166-1 alpha-3 codes such as FRA, JPN, and USA.

quick_visa_check provides a short result with the requirement code, visa-free days, and last verification date. It can run without a key, with anonymous usage limited to 10 checks per day per running server process. get_coverage_stats also works without a key and reports database size and coverage information.

Setup and configuration

Run the server with npx -y orizn-visa-mcp and add the same command and arguments to the MCP client configuration. Claude Desktop and Cursor are explicitly supported, along with other clients that can launch stdio servers.

For detailed visa data, place an Orizn key in the MCP configuration environment block under ORIZN_API_KEY. The key may instead be supplied with the --api-key argument, which takes precedence over the environment variable. The free key tier provides 50 requests per month, or 5 before email confirmation, and includes core fields and all 15 languages. It does not provide the deeper fields or gated tools such as transit checks and destination comparisons.

Tools and capabilities

MattJeff/orizn-mcp-server MCP server includes these documented operations:

• check_visa_requirement: Retrieves detailed requirements for one passport and destination, with an optional language.
• quick_visa_check: Returns a compact visa requirement result without documents, fees, or translation.
• compare_destinations: Compares one passport across 1 to 25 destinations; each destination counts as a request.
• check_transit_visa: Checks whether a traveller can remain airside or leave an airport during a connection, including free transit hours for major hubs.
• get_coverage_stats: Reports pairs, passports, destinations, translations, languages, and requirement distributions.
• get_recent_changes: Accepts optional passport, destination, date, and limit filters.

The visa://supported-languages resource lists the accepted language codes: English, French, Spanish, Portuguese, German, Japanese, Korean, Chinese, Russian, Italian, Arabic, Hindi, Thai, Vietnamese, and Filipino.

Limitations and notes

The policy-change feed behind get_recent_changes is currently disabled. The operation returns an unavailable status and an empty changes list, which must not be interpreted as evidence that no visa rules changed.

A Hobby plan or higher is required for destination comparisons, transit checks, and the deeper fields described above. A valid key can still fail because it is revoked, malformed, over quota, or associated with an insufficient plan. Visa information should be checked against official authorities before travel decisions. The project is released under the MIT license.