Orizn Visa

oficial

Requisitos de visa para 39,585 pares de pasaporte-destino en 15 idiomas. Verifique tipos de visa, documentos y consejos de viaje para cualquier combinación de países.

GitHub

Prueba este MCPPatrocinado

¿Qué puedes hacer con Orizn Visa MCP?

Consulta de requisitos de visa — Pregunta "¿necesito visa para ir de Francia a Japón?" y obtén las reglas de entrada completas mediante check_visa_requirement, incluidos documentos, tarifas y tiempos de procesamiento.
Estado rápido de visa — Usa quick_visa_check para una respuesta de una línea sobre el requisito de visa y los días sin visa, sin necesidad de clave API (10 consultas/día).
Comparar destinos — Pide comparar hasta 25 países para un mismo pasaporte lado a lado con compare_destinations, cubriendo tarifas, seguridad y requisitos de salud.
Reglas de visa de tránsito — Verifica las reglas de escala con check_transit_visa, incluido si puedes salir del aeropuerto y las horas de tránsito gratuito en los principales centros de conexión.
Estadísticas de cobertura — Pregunta "¿cuántos países están cubiertos?" y obtén estadísticas en vivo de la base de datos mediante get_coverage_stats, sin necesidad de clave.
Soporte multilingüe — Obtén respuestas sobre visas en cualquiera de los 15 idiomas (por ejemplo, francés, español, japonés) especificando el parámetro lang.

Documentación

Servidor MCP de la API Orizn Visa

El Servidor MCP de la API Orizn Visa es un servidor de Protocolo de Contexto de Modelo (MCP) que brinda a un asistente de IA los requisitos de visa y entrada para cualquier par pasaporte/destino, respondidos en 15 idiomas.

La cobertura crece: en lugar de imprimir un número aquí que quede desactualizado, la herramienta get_coverage_stats lo lee en vivo desde la API (también pública en https://visa.orizn.app/api/v1/visa/stats).

Responde preguntas como "¿necesito visa para ir de Francia a Japón?", "¿qué documentos necesita un ciudadano estadounidense para China?", "¿puedo salir del aeropuerto durante una escala en Estambul con pasaporte indio?" — con datos, no con suposiciones.

Compatibilidad

El servidor habla MCP a través de stdio y se ejecuta en Node.js 18 o posterior. Funciona con cualquier cliente MCP que pueda lanzar un servidor stdio, incluidos Claude Desktop, Claude Code y Cursor. El bloque de configuración a continuación es el mismo para todos ellos.

Instalación

npx orizn-visa-mcp

Nada que compilar, nada que clonar. Añádelo a la configuración de tu cliente MCP:

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

Reinicia el cliente y luego pregunta: "¿Necesito visa para ir de Francia a Japón?" — eso funciona sin clave de API, 10 verificaciones al día.

Para todo lo demás (documentos, tarifas, tiempos de procesamiento, reglas de tránsito, 15 idiomas), añade una clave gratuita:

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

La clave también se puede pasar como argumento, que tiene prioridad sobre la variable de entorno:

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

Preguntas de ejemplo

"¿Necesito visa para viajar de Francia a Tailandia?"
"¿Qué documentos necesito como ciudadano estadounidense que visita China?"
"Compara Tailandia, Vietnam e Indonesia para un pasaporte brasileño."
"¿Puedo salir del aeropuerto durante una escala de 12 horas en Estambul con pasaporte chino?"
"¿Cuánto cuesta una visa Schengen para un titular de pasaporte filipino?"
"¿Qué vacunas necesito para entrar a Brasil con pasaporte francés?"
"¿Cuál es la multa si me excedo 3 días en mi visa tailandesa?"
"¿Portugal tiene visa de nómada digital y cuánto cuesta?"
"Réponds en français : ai-je besoin d'un visa pour le Japon avec un passeport marocain ?"

Herramientas

Herramienta	Argumentos	Qué devuelve	Plan
`check_visa_requirement`	`passport`, `destination`, `lang`	Requisitos completos de entrada para un pasaporte hacia un destino: tipo de requisito, días permitidos, documentos, pasos de solicitud, tarifas, tiempos de procesamiento, validez del pasaporte, especificaciones de foto, vacunas, seguro, aviso de seguridad, multas por excedencia, entrada por aire/tierra/mar, visa de trabajo remoto, reglas de extensión y menores, embajadas.	Cualquier clave
`quick_visa_check`	`passport`, `destination`	Una línea: el código de requisito, el número de días sin visa y la fecha en que el par fue verificado por última vez. Sin documentos, sin tarifas, sin traducción.	Ninguno — 10/día sin clave, ilimitado con cualquier clave
`compare_destinations`	`passport`, `destinations` (1–25), `lang`	Hasta 25 destinos para un pasaporte lado a lado: requisito, días sin visa, descripción, validez del pasaporte, tarifa, seguridad, salud, vacunas, seguro, entrada por modo, visa de trabajo remoto. Cada destino devuelto cuenta como una solicitud.	Hobby o superior
`check_transit_visa`	`passport`, `transit_country`, `lang`	Solo reglas de escala: si el viajero puede permanecer en el lado aire o salir del aeropuerto durante la conexión, y cuántas horas de tránsito gratuito otorgan los principales hubs.	Hobby o superior
`get_coverage_stats`	ninguno	Tamaño de la base de datos: pares, pasaportes, destinos, traducciones, idiomas y la distribución de tipos de requisito. No dice nada sobre un par específico.	Ninguno
`get_recent_changes`	`passport`, `destination`, `since`, `limit` (todos opcionales)	Reglas de visa que cambiaron recientemente, con la fuente que las reportó y la fecha. El feed está actualmente desactivado — ver más abajo.	Ninguno

Los códigos de país son ISO 3166-1 alpha-3 (FRA, JPN, USA), no alpha-2.

requirement es uno de visa_free, visa_required, e_visa, visa_on_arrival, eta, no_admission, más los más raros partial_restrictions, admission_refused, not_applicable y special.

Recurso

visa://supported-languages — los 15 códigos aceptados por lang, disponibles en todos los planes incluido el gratuito: en fr es pt de ja ko zh ru it ar hi th vi tl.

`get_recent_changes` no devuelve nada a propósito

El feed de cambios de políticas de Orizn está desactivado. Estaba sirviendo inconsistencias detectadas entre dos tablas internas de Orizn como si fueran cambios oficiales de política, por lo que ahora devuelve HTTP 503 y esta herramienta se degrada a:

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

La herramienta se envía en este estado deliberadamente: una respuesta vacía y claramente etiquetada es la honesta, y la herramienta comienza a devolver entradas reales el día que el feed funcione con fuentes oficiales verificadas — momento en el cual las entradas sin una fuente nombrada y una fecha se retienen en lugar de mostrarse.

Autenticación y nivel gratuito

quick_visa_check, get_coverage_stats y get_recent_changes funcionan sin ninguna clave de API. quick_visa_check sin clave está limitado a 10 verificaciones por día — la misma asignación que visa.orizn.app otorga a un visitante anónimo. Pasado eso, la herramienta lo dice y señala la clave gratuita en lugar de fallar silenciosamente. El límite es por proceso de servidor en ejecución y se restablece a las 00:00 UTC.

Las otras tres herramientas necesitan una clave de API, enviada como el encabezado x-api-key a https://visa.orizn.app/api/v1/visa.

Obtén una gratuita en visa.orizn.app/visa-api — sin tarjeta de crédito. El nivel gratuito es de 50 solicitudes/mes (5 hasta que confirmes tu dirección de correo electrónico) e incluye los campos principales y los 15 idiomas. En el plan gratuito, los campos más profundos — tarifas, días de procesamiento, especificaciones de foto, vacunas, seguro, visas de tránsito, entrada por modo, multas por excedencia, visas de trabajo remoto, embajadas — regresan como un marcador de posición {"upgrade": "..."}, y compare_destinations y check_transit_visa están restringidos.

Hobby es $9/mes por 10,000 solicitudes y desbloquea todo: mejorar. Los planes de mayor volumen se enumeran en la página de precios.

Pasa la clave en el bloque env de la configuración de MCP — los clientes MCP no heredan el entorno de tu shell, por lo que exportar ORIZN_API_KEY en una terminal no es suficiente.

Verifica una clave sin ningún cliente MCP:

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 }

Solución de problemas

Síntoma	Solución
"No Orizn API key"	Esperado en las herramientas que solo usan clave. `quick_visa_check` aún responde. Para solucionarlo, pon la clave en el bloque `env` del archivo de configuración — no en tu shell — y luego reinicia el cliente
"Keyless daily limit reached"	Las 10 verificaciones gratuitas de hoy están agotadas. Una clave gratuita elimina el límite
HTTP 403, "check ORIZN_API_KEY for typos"	La clave es incorrecta, fue revocada o tiene espacios en blanco
HTTP 403, "requires Hobby plan or above"	Clave correcta, plan incorrecto — esta herramienta es de pago
HTTP 429	Cuota mensual agotada
HTTP 404 en un país real	Usa códigos alpha-3 (`FRA`, `JPN`), no alpha-2 (`FR`, `JP`)
Nada funciona en absoluto	Llama a `get_coverage_stats` — no necesita clave. Si eso también falla, es la red
`get_recent_changes` devuelve una lista vacía	Esperado — el feed se está reconstruyendo. No significa que las reglas no hayan cambiado

Enlaces

Sitio web — visa.orizn.app
Documentación de la API — visa.orizn.app/visa-api/dashboard/docs
Obtén una clave gratuita — visa.orizn.app/visa-api
GitHub — github.com/MattJeff/orizn-mcp-server
Soporte — api@orizn.app

Licencia

MIT