orizn-visa-mcp

Orizn Visa MCP Server

Visa requirements for 199 passports × 202 destinations (40,000+ pairs), in 15 languages, as MCP tools any AI agent can call.

Start here: get a key, make a call

1. Grab a free API key — 10 seconds, no credit card: visa.orizn.app/visa-api Free tier: 50 requests/month (5 until you confirm your email address), all 15 languages included.

2. Check it works (no MCP client needed):

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 }

3. Add the server to your MCP client (Claude Desktop, Cursor, Codex, Composio, Windsurf — same block):

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

Restart the client, then ask: "Do I need a visa to go from France to Japan?"

Prefer a CLI flag? npx orizn-visa-mcp --api-key orizn_visa_...

Without a key only get_coverage_stats works — every other tool returns an error pointing back here. There is no useful keyless mode.

Tools

Tool	Plan needed	What it returns
check_visa_requirement	any key	Full entry requirements for one passport → one destination (see fields below)
quick_visa_check	any key	Requirement code + visa-free days + last-verified date. Nothing else
compare_destinations	Hobby ($9/mo)	Up to 25 destinations for one passport, side by side
check_transit_visa	Hobby ($9/mo)	Layover rules and free transit hours per hub (DXB, IST, DOH, SIN, …)
get_coverage_stats	none	Size of the database. Works without a key

compare_destinations takes an explicit list — it does not dump every country for a passport. Each destination returned counts as one request against your quota.

What check_visa_requirement returns

• Core: requirement · visa_free_days · visa_required · description · documents_required · process · visa_types · max_stay · validity · verified
• Cost & timing: cost · visa_fee (single/multiple entry) · processing_time · processing_days (standard/express/rush) · best_apply_period
• Entry: passport_validity_months · entry_by_mode (air/land/sea) · transit_visa (per-hub rules)
• Documents: photo_specs (mm, background, glasses)
• Health & safety: vaccinations_required · health_requirements · insurance_required · safety (advisory level 1–4)
• Penalties & warnings: overstay_penalty · dual_nationality_warnings · stamp_warnings · minor_rules
• Long-stay: remote_work_visa · extension · extension_rules
• Embassies: embassy.your_embassy_at_destination + embassy.visa_application_embassy
• History: reciprocity_history

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

On the free plan, the deeper fields come back as {"upgrade": "..."} placeholders instead of data: visa_fee, processing_days, photo_specs, vaccinations_required, insurance_required, transit_visa, entry_by_mode, overstay_penalty, remote_work_visa, extension_rules, reciprocity_history, health_requirements, best_apply_period, minor_rules, dual_nationality_warnings, stamp_warnings, plus embassy, tips and visa_types. The core fields and all 15 languages are free.

Configuration

Option	Description
ORIZN_API_KEY env var	Your API key (recommended — put it in the env block of your MCP config)
--api-key <key> CLI arg	Same thing, as a command-line argument. Takes precedence over the env var

Examples

Ask your agent in natural language:

• "Do I need a visa to travel from France to Thailand?"
• "What documents do I need as a US citizen visiting China?" (check_visa_requirement)
• "Compare Thailand, Vietnam and Indonesia for a Brazilian passport." (compare_destinations)
• "Can I leave the airport during a 12h layover in Istanbul on a Chinese passport?" (check_transit_visa)
• "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 ?"

Supported languages

All 15 are available on every plan, free included — pass lang to check_visa_requirement or compare_destinations.

en English · fr French · es Spanish · de German · it Italian · pt Portuguese · ru Russian · zh Chinese · ja Japanese · ko Korean · ar Arabic · hi Hindi · th Thai · vi Vietnamese · tl Filipino

Pricing

Plan	Price	Requests/month
Free	$0	50
Hobby	$9/mo	10,000
Starter	$49/mo	30,000
Pro	$199/mo	250,000
Business	$699/mo	1,000,000
Enterprise	Custom	Unlimited

Free gives you the core fields and all 15 languages. Hobby ($9) is what unlocks the rest: compare_destinations, check_transit_visa, fees, processing times, photo specs, vaccinations, safety, overstay penalties, embassies and remote-work visas. Everything above Hobby is volume.

Upgrade to Hobby →

Troubleshooting

Symptom	Fix
"No Orizn API key"	The server never saw ORIZN_API_KEY. MCP clients do not inherit your shell env — the key must be in the env block of the config file, then restart the client
HTTP 403, "check ORIZN_API_KEY for typos"	Key is wrong, revoked, or has whitespace. Verify it in the dashboard
HTTP 403, "requires Hobby plan or above"	Right key, wrong plan — this tool is paid
HTTP 429	Monthly quota spent. Free is 50/month; Hobby is 10,000 for $9
HTTP 404 on a real country	Use ISO 3166-1 alpha-3 codes (FRA, JPN), not alpha-2 (FR, JP)
Nothing works, no key involved	Run get_coverage_stats — it needs no key. If that fails too, it's the network

Links

• API documentation — visa.orizn.app/visa-api/dashboard/docs
• GitHub — github.com/MattJeff/orizn-mcp-server
• Support / feature requests — [e-mail]

License

MIT