Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
autocompleta_stazioneA

Suggerisce stazioni ferroviarie per prefisso del nome (es. 'firenze', 'milano'). Restituisce nome esteso e codice stazione (es. S01700 per Milano Centrale). È l'endpoint consigliato per ottenere i codici stazione da usare nei tabelloni e nei dettagli.

cerca_stazioneA

Cerca stazioni il cui nome inizia con la stringa specificata. Restituisce informazioni anagrafiche strutturate (id stazione, nome lungo, nome breve, etichetta/città).

dettaglio_stazioneB

Restituisce i dettagli completi di una stazione ferroviaria: coordinate geografiche (latitudine/longitudine), città, regione e tipologia. Se codice_regione non viene fornito, viene recuperato automaticamente.

elenco_stazioni_regioneB

Restituisce l'elenco di tutte le stazioni ferroviarie appartenenti a una specifica regione (1=Lombardia, 2=Liguria, 3=Piemonte, 5=Lazio, 8=Emilia Romagna, 13=Toscana, 0=Stazioni principali italiane, ecc.) con le relative coordinate geografiche.

codice_regione_stazioneA

Restituisce il codice numerico di regione associato a una determinata stazione (es. 'S01700' -> 1 Lombardia).

autocompleta_stazione_ntsA

Autocompletamento di stazioni e nodi tecnici ferroviari (bivi BIVIO, deviazioni DEV., posti di comunicazione PC) con codici RICS a 9-11 cifre (iniziano con 83...). Nota: questi codici NTS non vanno usati con gli altri endpoint ordinari.

tabellone_partenzeB

Restituisce il tabellone delle partenze in tempo reale per una stazione ferroviaria (es. 'S01700' per Milano Centrale, 'S08409' per Roma Termini). Fornisce: treni in partenza, destinazione, orario programmato, ritardo in minuti, binario programmato ed effettivo, stato di circolazione e codice origine/data per ulteriori approfondimenti.

tabellone_arriviA

Restituisce il tabellone degli arrivi in tempo reale per una stazione ferroviaria (es. 'S01700' per Milano Centrale). Fornisce: treni in arrivo, stazione di provenienza, orario programmato, ritardo in minuti, binario programmato ed effettivo, e se il treno è già giunto in stazione.

treni_diretti_tra_stazioniA

Restituisce i treni DIRETTI (senza cambi) tra due stazioni nella giornata corrente (es. da 'S01700' Milano Centrale a 'S06421' Firenze Santa Maria Novella). Non gestisce percorsi che richiedono un interscambio: in tal caso la lista può risultare vuota anche se un collegamento con cambio esiste. Endpoint non documentato nelle fonti note, trovato nello script ufficiale del sito ViaggiaTreno e verificato dal vivo.

cerca_numero_trenoA

Cerca le corse attive associate a un numero di treno (es. 9611). Restituisce i dati identificativi essenziali: stazione di origine, data di partenza e millisecondi da passare a stato_treno o itinerario_treno_canvas.

stato_trenoA

Restituisce lo andamento e lo stato in tempo reale di un treno: ritardo attuale, ultimo rilevamento con stazione e orario, stato di marcia (regolare, soppresso, parzialmente soppresso), e l'elenco completo di tutte le fermate commerciali con orario programmato, orario effettivo e binari. Se codice_stazione_origine e data_partenza non vengono forniti, vengono determinati automaticamente tramite il numero di treno.

itinerario_treno_canvasB

Restituisce la rappresentazione visuale ad albero (tratteCanvas) dell'itinerario del treno, indicando fermata per fermata se la partenza o l'arrivo sono già avvenuti e se il treno è fermo in stazione.

predecessore_trenoA

Stima il treno 'predecessore' su una linea a spola/suburbana (stesso materiale rotabile che fa avanti e indietro, es. linee S): se il predecessore è in ritardo, è probabile che questo treno lo sarà anch'esso, prima ancora che il sito mandi un avviso. ATTENZIONE: è una stima per prossimità temporale (arrivo più recente alla stessa stazione, stesso operatore, stessa linea), non un dato certo dell'API. Funziona bene su linee a spola ad alta frequenza (verificato su S8 Lecco-Milano Porta Garibaldi e sulla Como/Chiasso-Milano Porta Garibaldi); NON è adatta a linee regionali a lunga percorrenza con poche corse al giorno (es. Milano Centrale-Tirano), dove restituirà null o un risultato poco significativo. Se codice_stazione_origine e data_partenza non vengono forniti, vengono determinati automaticamente tramite il numero di treno.

elenco_tratte_ferroviarieA

Restituisce i segmenti della rete ferroviaria (coppie di nodi ferroviari con coordinate geografiche) e l'indicazione se ciascun segmento è attualmente occupato da almeno un treno in viaggio. Le categorie filtrabili (separate da virgola) includono: 'ES*,IC,EXP,EC,EN,REG'. id_regione filtra i segmenti per area geografica (0=tutta Italia, 1-22=singola regione, stesso codice di elenco_stazioni/regione): attenzione, filtra i segmenti non i treni, quindi un segmento di confine regionale può comunque restituire treni di lunga percorrenza che solo transitano in quell'area. Gli ID tratta_ab/tratta_ba restituiti sono numerati per regione: vanno riusati con lo stesso id_regione in treni_su_tratta, altrimenti si ottengono i treni di un segmento fisicamente diverso.

treni_su_trattaA

Restituisce i treni attualmente in circolazione su uno specifico segmento di tratta ferroviaria. Richiede gli identificativi numerici nei due sensi (tratta_ab e tratta_ba) e lo stesso id_regione usati nella chiamata a elenco_tratte_ferroviarie che li ha prodotti: gli ID sono numerati per regione, non sono identificativi globali della rete.

statistiche_servizioA

Restituisce le statistiche della rete ferroviaria nazionale in tempo reale: numero complessivo di treni programmati per la data odierna e numero di treni attualmente in circolazione.

notizie_infomobilitaA

Restituisce le notizie dettagliate di infomobilità in tempo reale: avvisi sulla circolazione, ritardi eccezionali, guasti, modifiche di percorso o scioperi. Impostare solo_lavori=True per ottenere l'elenco dei lavori programmati.

titoli_infomobilitaB

Restituisce i soli titoli sintetici degli avvisi di infomobilità o dei lavori programmati (versione compatta per panoramica rapida).

ticker_infomobilitaB

Restituisce gli avvisi brevi scorrevoli della striscia informativa del portale ViaggiaTreno.

meteo_stazioniB

Restituisce le previsioni meteo per le stazioni di una specifica regione (es. 1=Lombardia, 13=Toscana). Nota: l'API ufficiale potrebbe restituire un insieme vuoto per alcune regioni se il dato non è disponibile.

dizionario_linguaA

Restituisce il dizionario delle traduzioni delle stringhe dell'interfaccia ViaggiaTreno. Lingue supportate: 'it', 'en', 'de', 'fr', 'sp', 'ro', 'jp', 'zh', 'ru'.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.4/5.0

Scored across 21 tools

Disambiguation3/5

Most tools target distinct resources or actions, but station lookup overlaps: autocompleta_stazione and cerca_stazione both search stations by prefix, and autocompleta_stazione_nts adds a related NTS variant. The infomobility trio also differs mainly by detail level, so descriptions help but boundaries are not perfectly sharp.

Naming Consistency4/5

All names use Italian lowercase snake_case, so casing and delimiters are predictable throughout. However, most are noun phrases while a few are verb-first (cerca_, autocompleta_), so the verb_noun pattern is not fully uniform.

Tool Count3/5

21 tools is above the typical 3-15 sweet spot and feels heavy for an MCP surface. The breadth is partly justified by the domain (boards, stations, routes, alerts, weather, dictionary), but several endpoints could likely be consolidated.

Completeness4/5

Coverage is broad: real-time departure/arrival boards, train status, route segments, station metadata, infomobility, weather and utility endpoints. The main gap is journey planning beyond direct trains plus some overlapping station-search behavior, but core ViaggiaTreno workflows are covered.

Maintenance

ActivityMaintained
ResponsivenessNo issues