Orizn Visa Mcp

io.github.MattJeff由 GitHub 帳號 MattJeff 發布v1.3.2更新於 Oct 29, 2026

Visa and entry requirements for any passport/destination pair, in 15 languages. Free key.

發布方自己的服務:Visa Developer Center MCP Server

已驗證Streamable HTTP可網頁執行位置與生活網頁搜尋與抓取

概覽

AI 產生的概覽

Orizn Visa MCP 讓助理查詢任一護照與目的地組合的簽證與入境要求,提供免金鑰的快速查詢與需要金鑰的完整查詢。

可以做什麼
  • 查詢單一護照與目的地組合的簽證要求、免簽天數與最近查核日期
  • 取得完整入境紀錄:所需文件、費用、辦理時間、護照效期、疫苗、逾期停留規定與大使館資訊
  • 為同一護照並排比較最多 25 個目的地
  • 查詢過境與轉機規定,包括能否離開機場以及免費轉機時數
  • 讀取資料庫涵蓋統計,並在可用時讀取近期規則變更清單
適用情境
適合使用者詢問是否需要簽證、需要哪些文件或費用、轉機時能否離開機場等情況,並希望取得有來源的資料而非猜測。單純的是非題用免金鑰的快速查詢即可。
執行需求
可使用託管的遠端端點,或在 Node.js 18 以上以 npx 執行 npm 套件。ORIZN_API_KEY 為選用:沒有金鑰時僅 quick_visa_check(每日 10 次)、get_coverage_stats 與 get_recent_changes 可用。金鑰可放在 env 設定區塊、命令列參數,或遠端 URL 的查詢參數與請求標頭中。國家代碼須使用 ISO alpha-3。
安裝前請注意
金鑰屬於機密,含金鑰的遠端 URL 同樣是機密,建議改用請求標頭或 env 設定區塊。帶金鑰的呼叫會比照 REST API 計費並留下紀錄,compare_destinations 與 check_transit_visa 需要每月 49 美元的付費 Starter 方案。免費方案的深入欄位只會回傳升級占位內容。get_recent_changes 已刻意關閉並回傳空清單,這不代表簽證規則沒有變動。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Orizn Visa Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.MattJeff%2Forizn-visa-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "orizn-visa": {
      "type": "http",
      "url": "https://visa.orizn.app/mcp"
    }
  }
}

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

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.

URL
Keylesshttps://visa.orizn.app/mcp
With your API keyhttps://visa.orizn.app/mcp?key=orizn_visa_...

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:
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

bash
npx orizn-visa-mcp

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

json
{  "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:

json
{  "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:

bash
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

ToolArgumentsWhat it returnsPlan
check_visa_requirementpassport, destination, langFull entry requirements for one passport into one destination: requirement type, days allowed, documents, application steps, fees, processing times, passport validity, photo specs, vaccinations, insurance, safety advisory, overstay penalties, entry by air/land/sea, remote-work visa, extension and minor rules, embassies.Any key
quick_visa_checkpassport, destinationOne line: the requirement code, the number of visa-free days, and the date the pair was last verified. No documents, no fees, no translation.None — 10/day keyless, unlimited with any key
compare_destinationspassport, destinations (1–25), langUp to 25 destinations for one passport side by side: requirement, visa-free days, description, passport validity, fee, safety, health, vaccinations, insurance, entry by mode, remote-work visa. Each destination returned counts as one request.Starter or above
check_transit_visapassport, transit_country, langLayover rules only: whether the traveller may stay airside or leave the airport while connecting, and how many free transit hours the main hubs grant.Starter or above
get_coverage_statsnoneSize of the database: pairs, passports, destinations, translations, languages, and the distribution of requirement types. Says nothing about a specific pair.None
get_recent_changespassport, destination, since, limit (all optional)Visa rules that changed recently, with the source that reported them and the date. The feed is currently off — see below.None

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:

json
{ "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:

bash
curl -H "x-api-key: $ORIZN_API_KEY" \  "https://visa.orizn.app/api/v1/visa/check?passport=FRA&destination=JPN"
json
{ "passport": "FRA", "destination": "JPN", "requirement": "visa_free", "visa_free_days": 90 }

Troubleshooting

SymptomFix
"No Orizn API key"Expected on the key-only tools. quick_visa_check still answers. To lift it, put the key in the env block of the config file — not your shell — then restart the client
"Keyless daily limit reached"The 10 free checks for today are spent. A free key removes the cap
HTTP 403, "check ORIZN_API_KEY for typos"Key is wrong, revoked, or has whitespace
HTTP 403, "requires Starter plan or above"Right key, wrong plan — this tool is paid
HTTP 429Monthly quota spent
HTTP 404 on a real countryUse alpha-3 codes (FRA, JPN), not alpha-2 (FR, JP)
Nothing works at allCall get_coverage_stats — it needs no key. If that fails too, it is the network
get_recent_changes returns an empty listExpected — the feed is being rebuilt. It does not mean the rules are unchanged

Links

License

MIT

來源:README.md,提交 a54a812

工具

6

quick_visa_check

Quick visa check

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 check_visa_requirement as soon as they need documents, fees, processing times, transit rules, or an answer in another language. Works with NO API key, 10 checks per day per network — the only tool that answers a traveller's question keyless. With a key it costs 1 request. Free API key: https://visa.orizn.app/visa-api/register?source=mcp-remote — 100 requests/month, no card, and it unlocks documents, fees, processing times, transit rules and 15 languages. Then reconnect with the key: https://visa.orizn.app/mcp?key=<key>, or an Authorization: Bearer <key> header.

輸入參數passport必填destination必填

check_visa_requirement

Full visa requirements

[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 / visa_required / e_visa / visa_on_arrival / eta / no_admission), days allowed, a written description, required documents, application steps, visa types, cost, validity, max stay, processing time, passport validity months, visa fees, photo specs, vaccinations, insurance, safety advisory, health requirements, overstay penalties, entry by mode (air/land/sea), transit rules, remote-work visa, extension rules, minor rules, dual-nationality and passport-stamp warnings, and embassies — in any of 15 languages, on every plan including free (fr, en, es, pt, de, ja, ko, zh, ru, it, ar, hi, th, vi, tl). Call it whenever the user asks whether they need a visa, what documents or vaccinations are needed, what a visa costs, how long it takes, how long they can stay, or what happens if they overstay. Needs an Orizn API key on this MCP connection and costs 1 request against that key's monthly quota. On the free plan the deep fields come back as {upgrade: "Available on Starter plan or above"} instead of data — report that as a plan limit, never as missing data. Reading the reply: every deep field carries a `granularity`. "destination" means the value describes the destination country for all nationalities (fees, processing days, transit, overstay, safety); "passport" means it describes the passport for all destinations (reciprocity history, stamp and dual-nationality warnings). Only the requirement, visa-free days, description and documents are pair-specific. A field Orizn does not have comes back as {status: "unavailable"} — say so rather than filling the gap, and `as_of` is the reference date of that field, not live data.

輸入參數langpassport必填destination必填

check_transit_visa

Transit and layover rules

[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 hubs grant. Call it for layovers, stopovers and connecting flights — not for entering a country as a destination, which is check_visa_requirement. IMPORTANT: this data is modelled PER TRANSIT COUNTRY, not per passport nationality. The answer is the same for every passport, the `passport` argument is recorded but does not narrow the result, and only 44 transit countries are covered. Present the reply as general hub rules to confirm with the airline or the transit country's authority, never as a per-nationality ruling. When the country is not covered the tool answers {status: "unavailable"} instead of guessing. Needs the Starter plan ($49/month, 30,000 requests) or above and costs 1 request. On a free key this call is refused before anything is charged, with the upgrade link.

輸入參數langpassport必填transit_country必填

compare_destinations

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 the Starter plan ($49/month, 30,000 requests) or above; on a free key this call is refused before anything is charged, with the upgrade link.

輸入參數langpassport必填destinations必填

get_coverage_stats

Database coverage

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 when the user asks how complete the data is, or to confirm this server is reachable before a longer session.

無需輸入參數。

get_recent_changes

Recent visa rule changes

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 internal data edits as if they were official policy changes. An empty answer here therefore means "Orizn has no verified change data", NEVER "nothing changed" — do not tell the user rules are stable, tell them to check the destination's official immigration source, and use check_visa_requirement for the current rule with its verification date. Keyless, costs nothing.

輸入參數limitsincepassportdestination

版本歷史

2
  1. v1.3.2最新Oct 29, 2026
  2. v1.3.1Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Visa 整合