Capacidad local para agentes

Pon SCHNGN detrás de tu agente

Instala el entorno local, conéctalo mediante MCP y añade la skill para planificar de forma fiable la regla Schengen de 90/180 días.

  • Cálculo en un proceso local
  • Sin telemetría de SCHNGN
  • JSON estricto y versionado
  • Regla ordinaria de 90/180 días

SCHNGN no hace solicitudes salientes. Aun así, el host de tu agente puede enviar entradas y resultados de las herramientas a su proveedor de modelos.

02

Skill del agente

La skill enseña al agente cuándo llamar a SCHNGN, cómo formar intervalos de estancia explícitos y cuándo rechazar preguntas sobre estatus jurídico.

Qué añade la skill

  • Prefiere las herramientas MCP en vez de rehacer el cálculo de fechas.
  • Limita las entradas a fechas de entrada y salida de estancias Schengen continuas.
  • Se mantiene en la planificación ordinaria de estancias cortas y remite los casos excepcionales a las autoridades oficiales.
03

Interfaz

CLI

Usa la CLI JSON en scripts y shells de agentes. Lee JSON estricto desde stdin o un archivo y devuelve un único resultado JSON.

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

schngn usage --input request.json
04

Interfaz

REST + OpenAPI

Inicia un servicio HTTP solo de bucle local para herramientas REST. Publica un documento OpenAPI en vivo y rechaza direcciones de escucha no locales.

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

schngn-api
05

Interfaz

TypeScript

Importa el motor puro para cálculos de fechas de bajo nivel o el paquete de capacidad para el contrato estricto del agente.

Paquetes: @schngn/engine y @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

Referencia de herramientas

Cada interfaz expone el mismo contrato de cálculo versionado. Las fechas usan YYYY-MM-DD y los intervalos incluyen los días de entrada y salida.

01

calculate_schengen_usage

Entrada
{ stays, referenceDate, includeCountedDays? }
Finalidad
Calcular días usados y restantes en una fecha de referencia explícita.
02

check_schengen_stay

Entrada
{ existingStays, candidateStay }
Finalidad
Comprobar cada día de una estancia continua propuesta.
03

latest_safe_schengen_exit

Entrada
{ existingStays, entryDate }
Finalidad
Hallar la última salida segura para una estancia con fecha de entrada conocida.
07

Límite de privacidad

El límite de cálculo es local, pero la ruta completa del agente puede incluir servicios en la nube.

LOCAL

Entorno de SCHNGN

El entorno no guarda datos, no envía telemetría, no registra fechas enviadas ni hace solicitudes de red salientes.

HOST

Host del agente y proveedor de modelos

Tu cliente MCP o host del agente puede enviar instrucciones, argumentos de herramientas y resultados a su proveedor de modelos. Revisa sus políticas de privacidad y conservación antes de usar fechas reales de viaje.

Requisitos

Node.js 24 o posterior. El cálculo no requiere cuenta de SCHNGN, clave API, endpoint alojado ni conexión de red.

Alcance y limitaciones

Esta capacidad modela estancias continuas explícitas bajo la regla Schengen ordinaria de 90/180 días. No clasifica países, decide derechos de visado o residencia, aplica acuerdos bilaterales ni ofrece asesoramiento jurídico.

Solo es una ayuda de planificación. Las autoridades competentes deciden la estancia autorizada.