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.

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_canvasC

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.

elenco_tratte_ferroviarieA

Restituisce i segmenti della rete ferroviaria nazionale (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'.

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), ottenibili tramite elenco_tratte_ferroviarie.

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 19 tools

Disambiguation3/5

Most tools target distinct resources (departures vs arrivals, status vs itinerary, three infomobility detail levels), but there is real overlap: autocompleta_stazione and cerca_stazione both search stations by prefix and differ mainly in output shape, and autocompleta_stazione_nts overlaps the former. The descriptions mitigate this somewhat by explicitly noting output differences, but an agent could still easily misselect.

Naming Consistency4/5

All names are lowercase snake_case Italian, which is highly consistent. However the convention mixes verb-led forms (autocompleta_stazione, cerca_numero_treno, elenco_tratte_ferroviarie) with pure noun phrases (tabellone_partenze, stato_treno, meteo_stazioni), so the pattern is readable but not strictly uniform.

Tool Count4/5

19 tools is on the heavy side but justified by the broad domain: station lookup, boards, train status/tracking, network segments, statistics, infomobility, weather, and localization. Each tool maps to a genuinely distinct API capability, so few feel redundant.

Completeness4/5

The surface is comprehensive for a read-only public rail-data service: station search/detail/region listing, real-time arrivals and departures, train status and itinerary, network segments and occupancy, plus infomobility and weather. No obvious lifecycle gaps given it is inherently read-only, though nothing covers tickets or personal/favorites data.

Maintenance

ActivityMaintained
ResponsivenessNo issues