Never Overstay

Capacidade local para agentes

Coloque o SCHNGN por trás do seu agente

Instale o runtime local, conecte-o por MCP e adicione a skill para um planejamento confiável da regra Schengen de 90/180 dias.

Configurar MCP Comparar interfaces
  • Cálculo em processo local
  • Sem telemetria do SCHNGN
  • JSON estrito e versionado
  • Regra comum de 90/180 dias

O SCHNGN não faz solicitações de saída. Mesmo assim, o host do seu agente pode enviar entradas e resultados das ferramentas ao provedor do modelo.

02

Skill do agente

A skill ensina ao agente quando chamar o SCHNGN, como montar intervalos explícitos de estadia e quando recusar perguntas sobre situação jurídica.

O que a skill acrescenta

  • Prefere as ferramentas MCP em vez de recriar a matemática das datas.
  • Limita as entradas às datas de entrada e saída de estadias Schengen contínuas.
  • Permanece no planejamento comum de estadias curtas e encaminha casos excepcionais às autoridades oficiais.
03

Interface

CLI

Use a CLI JSON em scripts e shells de agentes. Ela lê JSON estrito de stdin ou de um arquivo e retorna um único resultado JSON.

Comandos: schngn usage, schngn check-stay e schngn latest-exit.

schngn usage --input request.json
04

Interface

REST + OpenAPI

Inicie um serviço HTTP somente em loopback para ferramentas REST. Ele fornece um documento OpenAPI atualizado e recusa endereços de escuta não locais.

OpenAPI: http://127.0.0.1:37491/openapi.json

schngn-api
05

Interface

TypeScript

Importe o mecanismo puro para cálculos de data de baixo nível ou o pacote de capacidade para o contrato estrito de agentes.

Pacotes: @schngn/engine e @schngn/capability

npm install @schngn/capability 
import { calculateUsage } from '@schngn/capability';

const result = calculateUsage({
  stays: [{ entryDate: '2026-01-01', exitDate: '2026-01-12' }],
  referenceDate: '2026-02-01'
});
06

Referência das ferramentas

Toda interface expõe o mesmo contrato de cálculo versionado. As datas usam YYYY-MM-DD e os intervalos incluem os dias de entrada e saída.

01

calculate_schengen_usage

Entrada
{ stays, referenceDate, includeCountedDays? }
Finalidade
Calcular dias usados e restantes em uma data de referência explícita.
02

check_schengen_stay

Entrada
{ existingStays, candidateStay }
Finalidade
Verificar cada dia de uma estadia contínua proposta.
03

latest_safe_schengen_exit

Entrada
{ existingStays, entryDate }
Finalidade
Encontrar a última saída segura para uma estadia com data de entrada conhecida.
07

Limite de privacidade

O limite de cálculo é local, mas o caminho completo do agente pode incluir serviços em nuvem.

LOCAL

Runtime do SCHNGN

O runtime não persiste dados, não envia telemetria, não registra datas enviadas nem faz solicitações de rede de saída.

HOST

Host do agente e provedor do modelo

Seu cliente MCP ou host do agente pode enviar prompts, argumentos de ferramentas e resultados ao provedor do modelo. Revise as políticas de privacidade e retenção antes de usar datas reais de viagem.

Requisitos

Node.js 24 ou mais recente. O cálculo não exige conta SCHNGN, chave de API, endpoint hospedado nem conexão de rede.

Escopo e limitações

Esta capacidade modela estadias contínuas explícitas segundo a regra Schengen comum de 90/180 dias. Ela não classifica países, decide direitos de visto ou residência, aplica acordos bilaterais nem oferece aconselhamento jurídico.

Apenas uma ajuda de planejamento. As autoridades competentes decidem a estadia autorizada.