Orizn Visa

Servidor MCP da API Orizn Visa

O Servidor MCP da API Orizn Visa é um servidor Model Context Protocol (MCP) que fornece a um assistente de IA os requisitos de visto e entrada para qualquer par passaporte/destino, respondido em 15 idiomas.

A cobertura cresce: em vez de imprimir um número aqui que fica desatualizado, a ferramenta get_coverage_stats lê isso ao vivo da API (também pública em https://visa.orizn.app/api/v1/visa/stats).

Ele responde perguntas como "preciso de visto para ir da França ao Japão", "quais documentos um cidadão americano precisa para a China", "posso sair do aeroporto durante uma escala em Istambul com passaporte indiano" — com dados, não com suposições.

Compatibilidade

O servidor fala MCP via stdio e roda em Node.js 18 ou superior. Funciona com qualquer cliente MCP que possa iniciar um servidor stdio, incluindo Claude Desktop, Claude Code e Cursor. O bloco de configuração abaixo é o mesmo para todos eles.

Instalação

npx orizn-visa-mcp

Nada para compilar, nada para clonar. Adicione-o à configuração do seu cliente MCP:

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

Reinicie o cliente e pergunte: "Preciso de visto para ir da França ao Japão?" — isso funciona sem chave de API, 10 verificações por dia.

Para todo o resto (documentos, taxas, prazos de processamento, regras de trânsito, 15 idiomas), adicione uma chave gratuita:

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

A chave também pode ser passada como argumento, que tem precedência sobre a variável de ambiente:

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

Perguntas de exemplo

• "Preciso de visto para viajar da França para a Tailândia?"
• "Quais documentos preciso como cidadão americano visitando a China?"
• "Compare Tailândia, Vietnã e Indonésia para um passaporte brasileiro."
• "Posso sair do aeroporto durante uma escala de 12h em Istambul com passaporte chinês?"
• "Quanto custa um visto Schengen para um portador de passaporte filipino?"
• "Quais vacinas preciso para entrar no Brasil com passaporte francês?"
• "Qual é a multa se eu exceder meu visto tailandês em 3 dias?"
• "Portugal tem visto de nômade digital e quanto custa?"
• "Réponds en français : ai-je besoin d'un visa pour le Japon avec un passeport marocain ?"

Ferramentas

Ferramenta	Argumentos	O que retorna	Plano
check_visa_requirement	passport, destination, lang	Requisitos completos de entrada para um passaporte em um destino: tipo de requisito, dias permitidos, documentos, etapas de solicitação, taxas, prazos de processamento, validade do passaporte, especificações de foto, vacinas, seguro, aviso de segurança, penalidades por excesso de permanência, entrada por via aérea/terrestre/marítima, visto de trabalho remoto, regras de extensão e menores, embaixadas.	Qualquer chave
quick_visa_check	passport, destination	Uma linha: o código do requisito, o número de dias sem visto e a data em que o par foi verificado pela última vez. Sem documentos, sem taxas, sem tradução.	Nenhum — 10/dia sem chave, ilimitado com qualquer chave
compare_destinations	passport, destinations (1–25), lang	Até 25 destinos para um passaporte lado a lado: requisito, dias sem visto, descrição, validade do passaporte, taxa, segurança, saúde, vacinas, seguro, entrada por modalidade, visto de trabalho remoto. Cada destino retornado conta como uma solicitação.	Starter ou superior
check_transit_visa	passport, transit_country, lang	Apenas regras de escala: se o viajante pode permanecer no lado ar ou sair do aeroporto durante a conexão, e quantas horas de trânsito gratuito os principais hubs concedem.	Starter ou superior
get_coverage_stats	nenhum	Tamanho do banco de dados: pares, passaportes, destinos, traduções, idiomas e a distribuição dos tipos de requisito. Não diz nada sobre um par específico.	Nenhum
get_recent_changes	passport, destination, since, limit (todos opcionais)	Regras de visto que mudaram recentemente, com a fonte que as reportou e a data. O feed está atualmente desligado — veja abaixo.	Nenhum

Os códigos de país são ISO 3166-1 alpha-3 (FRA, JPN, USA), não alpha-2.

requirement é um de visa_free, visa_required, e_visa, visa_on_arrival, eta, no_admission, além dos mais raros partial_restrictions, admission_refused, not_applicable e special.

Recurso

visa://supported-languages — os 15 códigos aceitos por lang, disponíveis em todos os planos, incluindo o gratuito: en fr es pt de ja ko zh ru it ar hi th vi tl.

get_recent_changes não retorna nada de propósito

O feed de mudanças de política da Orizn está desligado. Ele estava servindo inconsistências detectadas entre duas tabelas internas da Orizn como se fossem mudanças oficiais de política, então agora retorna HTTP 503 e esta ferramenta degrada para:

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

A ferramenta é enviada neste estado deliberadamente: uma resposta vazia e claramente rotulada é a honesta, e a ferramenta começa a retornar entradas reais no dia em que o feed rodar com fontes oficiais verificadas — momento em que entradas sem fonte nomeada e data são retidas em vez de exibidas.

Autenticação e plano gratuito

quick_visa_check, get_coverage_stats e get_recent_changes funcionam sem nenhuma chave de API. O quick_visa_check sem chave é limitado a 10 verificações por dia — a mesma permissão que visa.orizn.app dá a um visitante anônimo. Além disso, a ferramenta avisa e aponta para a chave gratuita em vez de falhar silenciosamente. O limite é por processo de servidor em execução e é redefinido às 00:00 UTC.

As outras três ferramentas precisam de uma chave de API, enviada como o cabeçalho x-api-key para https://visa.orizn.app/api/v1/visa.

Obtenha uma gratuita em visa.orizn.app/visa-api — sem cartão de crédito. O plano gratuito é 100 solicitações/mês (5 até você confirmar seu e-mail) e inclui os campos principais e todos os 15 idiomas. No plano gratuito, os campos mais profundos — taxas, dias de processamento, especificações de foto, vacinas, seguro, vistos de trânsito, entrada por modalidade, penalidades por excesso de permanência, vistos de trabalho remoto, embaixadas — retornam como um placeholder {"upgrade": "..."}, e compare_destinations e check_transit_visa são restritos.

Starter custa $49/mês por 30.000 solicitações e desbloqueia tudo, com licença comercial: upgrade. Planos de maior volume estão listados na página de preços.

Passe a chave no bloco env da configuração MCP — os clientes MCP não herdam o ambiente do seu shell, então exportar ORIZN_API_KEY em um terminal não é suficiente.

Verifique uma chave sem nenhum 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 }

Solução de problemas

Sintoma	Correção
"No Orizn API key"	Esperado nas ferramentas que exigem chave. quick_visa_check ainda responde. Para resolver, coloque a chave no bloco env do arquivo de configuração — não no seu shell — e reinicie o cliente
"Keyless daily limit reached"	As 10 verificações gratuitas de hoje foram usadas. Uma chave gratuita remove o limite
HTTP 403, "check ORIZN_API_KEY for typos"	A chave está errada, revogada ou tem espaços em branco
HTTP 403, "requires Starter plan or above"	Chave correta, plano errado — esta ferramenta é paga
HTTP 429	Cota mensal esgotada
HTTP 404 em um país real	Use códigos alpha-3 (FRA, JPN), não alpha-2 (FR, JP)
Nada funciona	Chame get_coverage_stats — não precisa de chave. Se isso também falhar, é a rede
get_recent_changes retorna uma lista vazia	Esperado — o feed está sendo reconstruído. Não significa que as regras não mudaram

Links

• Site — visa.orizn.app
• Documentação da API — visa.orizn.app/visa-api/dashboard/docs
• Obtenha uma chave gratuita — visa.orizn.app/visa-api
• GitHub — github.com/MattJeff/orizn-mcp-server
• Suporte — api@orizn.app

Licença

MIT