Transita

Avalia um perfil em relação a 102 vias de visto de imigração em 15 países usando critérios oficiais do governo e retorna correspondências classificadas com custos, prazos de processamento, cronogramas de residência permanente e fontes oficiais.

GitHub

Documentação

@transita/mcp-server

Dados de elegibilidade para vistos e imigração da Transita para Claude, ChatGPT, Cursor, Cline, Zed e qualquer outro cliente MCP.

Pergunte ao seu assistente "para onde devo me mudar?" e ele pode verificar seu perfil contra mais de 100 vistos em 16 países, comparar caminhos e informar se um programa está aberto agora. Cada resposta inclui um link para a fonte oficial do governo.

O pacote não armazena dados. Ele chama a API pública da Transita, então capta mudanças de visto assim que a transita.app faz novas implantações. Sem chave de API, sem conta.

Há duas formas de conectar:

Hospedado: https://transita.app/api/mcp (Streamable HTTP, sem autenticação). Nada para instalar.
Local: npx -y @transita/mcp-server (stdio). Requer Node 20 ou mais recente.

Instalação

Claude Code

Hospedado:

claude mcp add --transport http transita https://transita.app/api/mcp

Local:

claude mcp add transita -- npx -y @transita/mcp-server

Adicione --scope user para disponibilizá-lo em todos os projetos. Execute /mcp para verificar se conectou.

Claude Desktop e claude.ai

Hospedado: adicione um conector personalizado em claude.ai/customize/connectors com a URL https://transita.app/api/mcp. Ele também aparece no Claude Desktop.

Local: edite ~/Library/Application Support/Claude/claude_desktop_config.json no macOS ou %APPDATA%\Claude\claude_desktop_config.json no Windows e reinicie o Claude Desktop.

{
  "mcpServers": {
    "transita": {
      "command": "npx",
      "args": ["-y", "@transita/mcp-server"]
    }
  }
}

ChatGPT

O ChatGPT só conversa com servidores remotos, então use o endpoint hospedado. Ative o modo de desenvolvedor nas configurações do ChatGPT, crie um novo conector, cole https://transita.app/api/mcp como URL do servidor e escolha "Sem autenticação". O modo de desenvolvedor é limitado a alguns planos pagos e a OpenAI muda o menu de lugar, então consulte as páginas de ajuda se não conseguir encontrá-lo.

Cursor

Adicione isto a ~/.cursor/mcp.json para todos os projetos, ou .cursor/mcp.json para um único:

{
  "mcpServers": {
    "transita": {
      "url": "https://transita.app/api/mcp"
    }
  }
}

Para a versão local, substitua a linha url por "command": "npx", "args": ["-y", "@transita/mcp-server"].

Cline, Continue, Zed e outros

Qualquer cliente que aceite um comando stdio funciona com command: npx e args: ["-y", "@transita/mcp-server"]. Clientes que suportam Streamable HTTP podem usar https://transita.app/api/mcp.

Ferramentas

Ferramenta	O que faz
`transita_match_visas`	Pontua um perfil (cidadania, educação, anos de trabalho, renda, objetivo, prazo) contra todos os vistos e retorna as melhores correspondências.
`transita_visa_details`	Um visto completo: elegibilidade, tempo de processamento, taxas, validade, caminho para residência permanente e uma prévia da lista de documentos.
`transita_compare_visas`	Coloca 2 ou 3 vistos lado a lado e aponta qual é o mais rápido, o mais barato, o de maior validade e qual leva à residência permanente.
`transita_country_overview`	Um destino em resumo: número de vistos, adesão à UE, pontuações, desvantagens, principais cidades com faixas de aluguel, prazos para residência permanente e cidadania.
`transita_search_by_nationality`	Principais destinos e vistos recomendados para cidadãos de um país. Uma boa primeira chamada para "para onde devo me mudar?".
`transita_programme_status`	Se um visto está aceitando inscrições agora. Para programas por rodadas, como o Express Entry, também informa a data e a nota de corte da última rodada.

Recursos

transita://visas: todos os vistos ativos
transita://countries: países de destino com contagens de vistos
transita://nationalities: os guias por nacionalidade
transita://nationality/<slug>: um guia de nacionalidade, ex.: transita://nationality/indian

Prompts

find-my-visa: faz algumas perguntas de elegibilidade e depois chama transita_match_visas
compare-options: executa transita_compare_visas nos vistos que você escolher
where-should-i-move: começa pela sua nacionalidade e explora a partir daí

Exemplos de perguntas

"Sou engenheiro de software indiano, com mestrado e 5 anos de experiência. Para onde devo me mudar?"
"Compare o O-1A dos EUA, o EU Blue Card da Alemanha e o D8 de Portugal. Qual me dá residência permanente mais rápido?"
"O Express Entry do Canadá está aberto agora e qual foi a última nota de corte?"
"O que o visto D8 de nômade digital de Portugal exige?"

Configuração

Relevante apenas para o pacote local.

Variável de ambiente	Padrão	Finalidade
`TRANSITA_API_URL`	`https://transita.app`	URL base da API. Aponte para `http://localhost:3000` para desenvolvimento local.
`TRANSITA_MCP_USER_AGENT`	`transita-mcp-server/<version>`	User-Agent enviado em cada requisição à API.

Gratuito e pago

Tudo o que o servidor retorna é gratuito. A lista completa de documentos e o plano de ação de 30 dias fazem parte do plano pago da Transita em https://transita.app/path/<id>. Os resultados das ferramentas incluem uma prévia da lista de verificação e um link para o plano completo.

Desenvolvimento

git clone https://github.com/snenenenenenene/transita-mcp-server.git
cd transita-mcp-server
bun install
bun run build

Execute contra um servidor de desenvolvimento local da Transita:

TRANSITA_API_URL=http://localhost:3000 node dist/cli.js

Teste rápido pela linha de comando:

{
  echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"smoke","version":"0.0"}}}'
  echo '{"jsonrpc":"2.0","method":"notifications/initialized"}'
  echo '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
} | node dist/cli.js

Publicação

O npm hospeda o pacote e o MCP Registry mantém os metadados em server.json. Atualize a versão em package.json, ambos os campos version de server.json, src/server.ts e src/api.ts primeiro.

Compile e publique no npm:

bun run build
npm publish --access public

Envie o código-fonte para o espelho público:

./sync-mirror.sh

Publique os metadados. Instale o publicador uma vez com Homebrew primeiro.

mcp-publisher login github
mcp-publisher publish

Licença

MIT, consulte LICENSE.