Orizn MCP Server

Orizn Visa API MCP Server

Orizn Visa API MCP Server is a Model Context Protocol (MCP) server that gives an AI assistant the visa and entry requirements for any passport/destination pair, answered in 15 languages.

It covers 49,750 pairs — 199 passports × 250 destinations (as of October 2026). Coverage grows: the get_coverage_stats tool reads the current figure live from the API (also public at https://visa.orizn.app/api/v1/visa/stats).

It answers questions like "do I need a visa to go from France to Japan", "what documents does a US citizen need for China", "can I leave the airport during a layover in Istanbul on an Indian passport" — with data, not a guess.

Compatibility

The server speaks MCP over stdio and runs on Node.js 18 or later. It works with any MCP client that can launch a stdio server, including Claude Desktop, Claude Code and Cursor. The configuration block below is the same for all of them.

Remote MCP (no install)

The same six tools are hosted at https://visa.orizn.app/mcp (Streamable HTTP, JSON-RPC over POST). Nothing runs on your machine.

The key is accepted as ?key=, Authorization: Bearer <key> or X-API-Key: <key>. Without a key, quick_visa_check answers 10 checks a day per network (the same allowance as the anonymous demo on visa.orizn.app); get_coverage_stats and get_recent_changes are free; the other tools say they need a key. With a key, every call is billed and logged exactly like the REST API. A URL with a key in it is a secret.

• Claude.ai / Claude Desktop — Settings → Connectors → Add custom connector, paste the URL.
• ChatGPT — Settings → Apps & Connectors → Advanced settings → Developer mode, then Create, paste the URL, authentication "No authentication".
• Claude Code — claude mcp add --transport http orizn-visa https://visa.orizn.app/mcp
• Cursor — ~/.cursor/mcp.json:

{
  "mcpServers": {
    "orizn-visa": {
      "url": "https://visa.orizn.app/mcp",
      "headers": { "Authorization": "Bearer orizn_visa_..." }
    }
  }
}

Free key, no card: visa.orizn.app/visa-api/register.

Install

npx orizn-visa-mcp

Nothing to build, nothing to clone. Add it to your MCP client config:

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

Restart the client, then ask: "Do I need a visa to go from France to Japan?" — that works with no API key, 10 checks a day.

For everything else (documents, fees, processing times, transit rules, 15 languages), add a free key:

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

The key can also be passed as an argument, which takes precedence over the environment variable:

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

Example questions

• "Do I need a visa to travel from France to Thailand?"
• "What documents do I need as a US citizen visiting China?"
• "Compare Thailand, Vietnam and Indonesia for a Brazilian passport."
• "Can I leave the airport during a 12h layover in Istanbul on a Chinese passport?"
• "How much does a Schengen visa cost for a Filipino passport holder?"
• "Which vaccinations do I need to enter Brazil with a French passport?"
• "What's the fine if I overstay my Thai visa by 3 days?"
• "Does Portugal have a digital nomad visa, and what does it cost?"
• "Réponds en français : ai-je besoin d'un visa pour le Japon avec un passeport marocain ?"

Tools

Country codes are ISO 3166-1 alpha-3 (FRA, JPN, USA), not alpha-2.

requirement is one of visa_free, visa_required, e_visa, visa_on_arrival, eta, no_admission, plus the rarer partial_restrictions, admission_refused, not_applicable and special.

Resource

visa://supported-languages — the 15 codes accepted by lang, available on every plan including free: en fr es pt de ja ko zh ru it ar hi th vi tl.

get_recent_changes returns nothing on purpose

Orizn's policy-change feed is switched off. It was serving inconsistencies detected between two internal Orizn tables as if they were official policy changes, so it now returns HTTP 503 and this tool degrades to:

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

The tool is shipped in this state deliberately: an empty, clearly-labelled answer is the honest one, and the tool starts returning real entries the day the feed runs on verified official sources — at which point entries without a named source and a date are withheld rather than shown.

Authentication and free tier

quick_visa_check, get_coverage_stats and get_recent_changes work with no API key at all. Keyless quick_visa_check is capped at 10 checks per day — the same allowance visa.orizn.app gives an anonymous visitor. Past that the tool says so and points at the free key rather than failing silently. The cap is per running server process and resets at 00:00 UTC.

The other three tools need an API key, sent as the x-api-key header to https://visa.orizn.app/api/v1/visa.

Get a free one at visa.orizn.app/visa-api/register — no credit card. The free tier is 100 requests/month (5 until you confirm your email address) and includes the core fields and all 15 languages. On the free plan the deeper fields — fees, processing days, photo specs, vaccinations, insurance, transit visas, entry by mode, overstay penalties, remote-work visas, embassies — come back as an {"upgrade": "..."} placeholder, and compare_destinations and check_transit_visa are gated.

Starter is $49/month for 30,000 requests and unlocks all of it, with a commercial licence: upgrade. Higher-volume plans are listed on the pricing page.

Pass the key in the env block of the MCP config — MCP clients do not inherit your shell environment, so exporting ORIZN_API_KEY in a terminal is not enough.

Check a key without any 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 }

Troubleshooting

Links

• Website — visa.orizn.app
• API documentation — visa.orizn.app/visa-api/dashboard/docs
• Get a free key — visa.orizn.app/visa-api
• Remote MCP endpoint — https://visa.orizn.app/mcp
• GitHub — github.com/MattJeff/orizn-mcp-server
• Support — api@orizn.app

License

MIT