mattjeff avatar

Orizn Visa Mcp

mattjeff/orizn-mcp-server

Connects Claude to Orizn's visa requirement database covering 39,585 passport-destination pairs across 199 countries in 15 languages. Exposes six tools: check_visa_requirement returns full details including fees, processing times, photo specs, transit rules, overstay penalties, and embassy locations with up to 32 data points per query. quick_visa_check gives fast yes/no answers on visa type (free, required, on arrival, e-visa). check_transit_visa handles layover rules for 50 major hubs like DXB and IST. get_all_destinations and get_visa_changes require paid tiers. Free tier works without an API key for basic checks. Reach for this when building travel planning tools, itinerary agents, or anything that needs current visa policy data beyond simple yes/no answers.

GitHub stars
1
tools
6
auth
Secret needed
transport
STDIO, HTTP
env var
1
last updated
Oct 28, 2026

Install

From registry metadata
$ npx add-mcp https://visa.orizn.app/mcp --name orizn-visa-mcp

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http orizn-visa-mcp https://visa.orizn.app/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 6 tools

Verified live against the running server on Nov 6, 2026.

quick_visa_checkDoes this passport need a visa for this destination? Returns the requirement, the number of visa-free days, and — when that exact pair has been individually re-verified — the date it was. One pair per call, English only. Prefer it when the user wants a plain yes/no; switch to...2 params

Does this passport need a visa for this destination? Returns the requirement, the number of visa-free days, and — when that exact pair has been individually re-verified — the date it was. One pair per call, English only. Prefer it when the user wants a plain yes/no; switch to...

Parameters* required
destination*string
Destination country, ISO 3166-1 alpha-3 (e.g. JPN)
passport*string
Passport country, ISO 3166-1 alpha-3 (e.g. FRA)
check_visa_requirement[needs a free API key — this call will fail without one: https://visa.orizn.app/visa-api/register?source=mcp-remote, then reconnect with ?key=<key>] THE default visa tool: the full entry record for ONE passport travelling to ONE destination. Returns the requirement (visa_free...3 params

[needs a free API key — this call will fail without one: https://visa.orizn.app/visa-api/register?source=mcp-remote, then reconnect with ?key=<key>] THE default visa tool: the full entry record for ONE passport travelling to ONE destination. Returns the requirement (visa_free...

Parameters* required
destination*string
Country being entered, ISO 3166-1 alpha-3 (e.g. JPN for Japan).
langstring
Language of the written fields. One of: fr, en, es, pt, de, ja, ko, zh, ru, it, ar, hi, th, vi, tl. Defaults to en. Available on every plan, free included.
passport*string
Passport country, ISO 3166-1 alpha-3 (e.g. FRA for France).
check_transit_visa[needs a free API key — this call will fail without one: https://visa.orizn.app/visa-api/register?source=mcp-remote, then reconnect with ?key=<key>] Transit and layover rules for a country being connected through: airside/landside rules and how many free transit hours its main...3 params

[needs a free API key — this call will fail without one: https://visa.orizn.app/visa-api/register?source=mcp-remote, then reconnect with ?key=<key>] Transit and layover rules for a country being connected through: airside/landside rules and how many free transit hours its main...

Parameters* required
langstring
Language code. One of: fr, en, es, pt, de, ja, ko, zh, ru, it, ar, hi, th, vi, tl. Defaults to en.
passport*string
Traveller's passport, ISO 3166-1 alpha-3 (e.g. IND). Recorded, but does not narrow the answer.
transit_country*string
Country being transited, ISO 3166-1 alpha-3 (e.g. ARE for a Dubai layover, TUR for Istanbul).
compare_destinations[needs a free API key — this call will fail without one: https://visa.orizn.app/visa-api/register?source=mcp-remote, then reconnect with ?key=<key>] Compare up to 2525 destinations costs 25 requests. Ask for the destinations the user actually named, not a whole region. Needs t...3 params

[needs a free API key — this call will fail without one: https://visa.orizn.app/visa-api/register?source=mcp-remote, then reconnect with ?key=<key>] Compare up to 2525 destinations costs 25 requests. Ask for the destinations the user actually named, not a whole region. Needs t...

Parameters* required
destinations*array
1 to 25 ISO 3166-1 alpha-3 destination codes, e.g. ["JPN","THA","VNM"]. Duplicates are removed before billing.
langstring
Language of the description field. One of: fr, en, es, pt, de, ja, ko, zh, ru, it, ar, hi, th, vi, tl. Defaults to en.
passport*string
Traveller's passport, ISO 3166-1 alpha-3 (e.g. FRA).
get_coverage_statsHow big the Orizn visa database is: pairs, passports, destinations, enriched records, translations and languages. Says nothing about any specific country pair — use quick_visa_check or check_visa_requirement for that. Keyless, free, and costs nothing against any quota. Call it...

How big the Orizn visa database is: pairs, passports, destinations, enriched records, translations and languages. Says nothing about any specific country pair — use quick_visa_check or check_visa_requirement for that. Keyless, free, and costs nothing against any quota. Call it...

No parameters. Call it with no arguments.

get_recent_changesRecently changed visa rules — what changed, for which passport/destination pair, on what date, and from which official source. STATUS: Orizn's change feed is currently OFF and this tool returns {status:"unavailable", changes: []}. It was shut down because it was publishing int...4 params

Recently changed visa rules — what changed, for which passport/destination pair, on what date, and from which official source. STATUS: Orizn's change feed is currently OFF and this tool returns {status:"unavailable", changes: []}. It was shut down because it was publishing int...

Parameters* required
destinationstring
Optional ISO 3166-1 alpha-3 destination code to filter on (e.g. 'JPN').
limitnumber
Maximum number of changes to return (1-200, default 50).
passportstring
Optional ISO 3166-1 alpha-3 passport code to filter on (e.g. 'FRA').
sincestring
Optional ISO date (YYYY-MM-DD) — only changes detected on or after this date.

Sponsors

Configuration

ORIZN_API_KEYsecret

Optional. Without it, quick_visa_check (10 checks/day), get_coverage_stats and get_recent_changes still work. A key lifts that cap and unlocks documents, fees, processing times, transit rules and 15 languages. Free key (100 requests/month, no credit card) at https://visa.orizn.ap

Readme

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

npm version License: MIT MCP Compatible

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


View the full README on GitHub

Details

Repository
github.com/mattjeff/orizn-mcp-server
Website
visa.orizn.app/integrations/mcp
Package
orizn-visa-mcp
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active
Tools verified
Nov 6, 2026