Configurazione MCP
ConsigliatoMCP offre a un agente tre strumenti di calcolo di sola lettura tramite stdio. Il server resta sul tuo computer e non richiede un account SCHNGN o una chiave API.
Verifica la connessione
Riavvia o aggiorna il client MCP, poi chiedigli di elencare gli strumenti SCHNGN. Dovresti vedere tutte e tre le operazioni qui sotto.
codex mcp get schngn --json Skill per agenti
La skill insegna all’agente quando chiamare SCHNGN, come formare intervalli di soggiorno espliciti e quando rifiutare domande sullo status giuridico.
Cosa aggiunge la skill
- Preferisce gli strumenti MCP invece di ricreare il calcolo delle date.
- Limita gli input alle date di ingresso e uscita dei soggiorni Schengen continui.
- Resta nella pianificazione ordinaria dei soggiorni brevi e rimanda i casi eccezionali alle autorità ufficiali.
Interfaccia
CLI
Usa la CLI JSON in script e shell per agenti. Legge JSON rigoroso da stdin o da un file e restituisce un singolo risultato JSON.
Comandi: schngn usage, schngn check-stay e schngn latest-exit.
schngn usage --input request.json Interfaccia
REST + OpenAPI
Avvia un servizio HTTP solo loopback per gli strumenti REST. Espone un documento OpenAPI aggiornato e rifiuta indirizzi di ascolto non locali.
OpenAPI: http://127.0.0.1:37491/openapi.json
schngn-api Interfaccia
TypeScript
Importa il motore puro per i calcoli di date di basso livello o il pacchetto capability per il contratto rigoroso destinato agli agenti.
Pacchetti: @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'
});Riferimento strumenti
Ogni interfaccia espone lo stesso contratto di calcolo versionato. Le date usano YYYY-MM-DD e gli intervalli includono i giorni di ingresso e uscita.
calculate_schengen_usage
- Input
{ stays, referenceDate, includeCountedDays? }- Scopo
- Calcola giorni usati e rimanenti in una data di riferimento esplicita.
check_schengen_stay
- Input
{ existingStays, candidateStay }- Scopo
- Controlla ogni giorno di un soggiorno continuo proposto.
latest_safe_schengen_exit
- Input
{ existingStays, entryDate }- Scopo
- Trova l’ultima uscita sicura per un soggiorno con data di ingresso nota.
Confine della privacy
Il confine del calcolo è locale, ma il percorso completo dell’agente può includere servizi cloud.
LOCAL
Runtime SCHNGN
Il runtime non conserva dati, non invia telemetria, non registra le date inviate e non effettua richieste di rete in uscita.
HOST
Host dell’agente e fornitore del modello
Il client MCP o l’host dell’agente può inviare prompt, argomenti degli strumenti e risultati al proprio fornitore del modello. Consulta le sue regole su privacy e conservazione prima di usare date di viaggio reali.
Requisiti
Node.js 24 o successivo. Per il calcolo non servono account SCHNGN, chiave API, endpoint ospitato o connessione di rete.
Ambito e limiti
Questa funzione modella soggiorni continui espliciti secondo la regola Schengen ordinaria 90/180 giorni. Non classifica paesi, decide diritti di visto o residenza, applica accordi bilaterali o fornisce consulenza legale.
Solo strumento di pianificazione. Le autorità competenti decidono il soggiorno autorizzato.