# MattJeff/orizn-mcp-server [Health: Active]

**Category:** 🚆 Travel & Transportation  
**Repository:** https://github.com/MattJeff/orizn-mcp-server  
**GitHub Stars:** 1  
**Views:** 5  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mattjeff-orizn-mcp-server

## Description
Visa requirements for 39,585 passport-destination pairs in 15 languages. Check visa types, required documents, and travel tips.

## Tools
Capabilities this server exposes over MCP:

- **check_visa_requirement** — Full visa details — documents, process, tips, transit, fees, processing days, photo specs, vaccinations, insurance, overstay penalties, embassies, safety, health, remote work, extensions, and more
- **quick_visa_check** — Fast yes/no visa check (visa-free / e-visa / required / on arrival / ETA / no admission)
- **get_all_destinations** — All 199 destinations for any passport
- **get_visa_changes** — Track recent visa policy changes
- **check_transit_visa** — Transit visa rules + free transit hours for top 50 layover hubs (DXB, IST, DOH, SIN, ...)
- **get_coverage_stats** — Database coverage statistics

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "orizn-mcp-server": {
    "command": "npx",
    "args": ["-y","orizn-visa-mcp"],
    "env": {
      "ORIZN_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `ORIZN_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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.

_Full upstream README: https://allmcps.com/mcp/mattjeff-orizn-mcp-server/readme_