Orizn Visa API MCP Server 是一个 Model Context Protocol（MCP）服务器，为 AI 助手提供任意护照/目的地组合的签证与入境要求，并以 15 种语言回答。它旨在让 AI 助手基于真实数据而非猜测来回答签证问题。
主要能力：
- 回答“从法国去日本需要签证吗”“美国公民访问中国需要哪些文件”“持印度护照在伊斯坦布尔转机 12 小时能否离开机场”等问题。
- 支持示例问题包括：从法国去泰国是否需要签证、巴西护照对比泰国/越南/印度尼西亚、中国护照在伊斯坦布尔转机、菲律宾护照申请申根签证费用、法国护照进入巴西需要哪些疫苗、泰国签证逾期 3 天罚款、葡萄牙数字游民签证及费用等，也可要求用法语等语言作答。
- 覆盖字段包括：文件、费用、处理时间、过境规则、大使馆，具体深入字段在免费方案中以占位符返回。
技术细节与使用方式：
- 服务器通过 stdio 通信，运行于 Node.js 18 或更高版本。
- 适用于任何能启动 stdio 服务器的 MCP 客户端，包括 Claude Desktop、Claude Code 和 Cursor，配置块相同。
- 无需构建或克隆，直接将配置加入 MCP 客户端配置，重启客户端后即可提问。
- 国家代码使用 ISO 3166-1 alpha-3（如 FRA、JPN、USA），而非 alpha-2。
- requirement 值包括 visa_free、visa_required、e_visa、visa_on_arrival、eta、no_admission，以及较少见的 partial_restrictions、admission_refused、not_applicable 和 special。
- 可用语言资源 visa://supported-languages 列出 15 种语言代码：en fr es pt de ja ko zh ru it ar hi th vi tl，所有方案（含免费）均可用。
认证与免费层级：
- quick_visa_check、get_coverage_stats 和 get_recent_changes 无需任何 API 密钥即可使用。
- 无密钥的 quick_visa_check 每天限制 10 次检查，与 visa.orizn.app 给匿名访客的额度相同；超出后工具会提示并引导获取免费密钥，而非静默失败。该限制按运行中的服务器进程计算，于 UTC 00:00 重置。
- 其他三个工具需要 API 密钥，通过 x-api-key 请求头发送到 https://visa.orizn.app/api/v1/visa。
- 免费密钥可在 visa.orizn.app/visa-api 获取，无需信用卡。免费方案为每月 100 次请求（确认邮箱前为 5 次），包含核心字段和全部 15 种语言。免费方案中，更深入字段（费用、处理天数、照片规格、疫苗、保险、过境签证、按方式入境、逾期罚款、远程工作签证、大使馆）会以 {"upgrade": "..."} 占位符返回，且 compare_destinations 和 check_transit_visa 受限制。
- Starter 为每月 49 美元、30,000 次请求，解锁全部功能并含商业许可。更高流量方案见定价页面。
- 密钥需放在 MCP 配置的 env 块中，因为 MCP 客户端不会继承 shell 环境，仅在终端导出 ORIZN_API_KEY 不够。密钥也可作为参数传递，参数优先于环境变量。
关于 get_recent_changes： 该工具故意返回空结果。Orizn 的政策变更 feed 已关闭，因为它曾把两个内部 Orizn 表之间检测到的不一致当作官方政策变更提供，因此现在返回 HTTP 503，该工具降级为明确标注的空答案。这是有意为之：诚实空答案优于虚假内容；待 feed 基于经验证的官方来源运行后，工具才会开始返回真实条目，届时没有具名来源和日期的条目将被隐去。
覆盖范围： 覆盖范围持续增长，get_coverage_stats 工具会从 API 实时读取覆盖数据，也公开于 https://visa.orizn.app/api/v1/visa/stats。
相关链接：
- 网站：visa.orizn.app
- API 文档：visa.orizn.app/visa-api/dashboard/docs
- 获取免费密钥：visa.orizn.app/visa-api
- GitHub：github.com/MattJeff/orizn-mcp-server
- 支持邮箱：api@orizn.app
