MCP Trenitalia Server

Cerca stazioni ferroviarie italiane per nome e restituisce il loro ID Viaggiatreno. Questo strumento deve essere usato PRIMA degli altri quando l'utente non conosce l'ID numerico della stazione (es. 'S01700' per Milano C.le). Supporta ricerca parziale (es. 'Milano' restituisce tutte le stazioni milanesi). Args: params (CercaStazioneInput): Input contenente: - nome_stazione (str): Nome parziale o completo della stazione (es. 'Roma', 'Napoli C') Returns: str: Lista markdown delle stazioni trovate con ID, oppure messaggio di errore. Formato di successo: ## Stazioni trovate per "query" - **Nome Stazione** → ID: `S00000` Formato errore: "Errore: <descrizione>" Esempi d'uso: - "Cerca la stazione di Bologna" → nome_stazione="Bologna" - "Qual è l'ID di Firenze SMN?" → nome_stazione="Firenze" - Prima di monitorare partenze da Venezia → nome_stazione="Venezia"

Mostra la bacheca partenze in tempo reale di una stazione ferroviaria italiana. Recupera i prossimi treni in partenza con: numero treno, destinazione, orario programmato, ritardo attuale, binario (programmato ed effettivo), e stato fisico del convoglio (se è ancora in stazione o è già partito). Args: params (MonitoraPartenzeInput): Input contenente: - id_stazione (str): ID Viaggiatreno (es. 'S01700'). Usa trenitalia_cerca_stazione per trovarlo. - limite (Optional[int]): Quanti treni mostrare (default 10, max 30) Returns: str: Tabella markdown con le partenze, oppure messaggio di errore. Campi per ogni treno: - Numero e categoria (es. FR 9631, REG 2342) - Destinazione finale - Orario di partenza programmato - Ritardo in minuti (o "in orario") - Binario effettivo vs programmato - Stato: "IN STAZIONE" / "PARTITO" / "NON ANCORA IN STAZIONE" Esempi d'uso: - "Quando parte il prossimo treno da Milano?" → id_stazione="S01700" - "Ci sono ritardi a Roma Termini?" → id_stazione="S00219" - "Mostrami 20 partenze da Napoli" → id_stazione="S00785", limite=20

Mostra la bacheca arrivi in tempo reale di una stazione ferroviaria italiana. Recupera i prossimi treni in arrivo con: numero treno, provenienza, orario programmato, ritardo attuale e binario di arrivo. Args: params (MonitoraArriviInput): Input contenente: - id_stazione (str): ID Viaggiatreno (es. 'S01700'). Usa trenitalia_cerca_stazione per trovarlo. - limite (Optional[int]): Quanti treni mostrare (default 10, max 30) Returns: str: Tabella markdown con gli arrivi, oppure messaggio di errore. Campi per ogni treno: - Numero e categoria del treno - Provenienza (stazione di origine) - Orario di arrivo programmato - Ritardo in minuti (o "in orario") - Binario di arrivo (effettivo vs programmato) Esempi d'uso: - "A che ora arriva il treno da Firenze a Bologna?" → id_stazione Bologna - "Quanti treni sono in ritardo in arrivo a Venezia?" → id_stazione Venezia

Traccia la posizione e il ritardo di un treno specifico in tempo reale. Recupera la telemetria completa del convoglio: ultima stazione rilevata, ritardo accumulato, fermate già effettuate vs rimanenti, fermate soppresse e anomalie di linea segnalate da Trenitalia. Args: params (TracciaTrenoInput): Input contenente: - numero_treno (str): Numero treno (es. '9631', '2342'). Solo cifre. - id_stazione_origine (str): ID della stazione di partenza del treno (es. 'S01700'). Necessario perché Viaggiatreno usa numero+origine come chiave univoca. Returns: str: Report markdown dettagliato sul treno, oppure messaggio di errore. Struttura del report: - Intestazione: numero, categoria, origine → destinazione - Situazione attuale: ultima stazione rilevata, ritardo corrente - Fermate: lista con orario programmato, effettivo e ritardo per ogni fermata - Anomalie: fermate soppresse e messaggi di anormalità - Stato finale: se il treno è arrivato a destinazione Esempi d'uso: - "Dov'è il Frecciarossa 9631?" → numero_treno="9631", id_stazione_origine="S01700" - "Il treno 2342 è in ritardo?" → numero_treno="2342", id_stazione_origine=<stazione origine> - "A che binario arriverà il mio treno?" → usa questo tool e guarda l'ultima fermata

Trova tutti i treni che passano da una stazione A a una stazione B in una data ora. Usa l'orario teorico NeTEx (offline) per trovare le corse, poi arricchisce ciascun treno con ritardo real-time da Viaggiatreno (se disponibile). Risolve nomi in chiaro (es. 'Tuscolana', 'Ponte Galeria') automaticamente. Args: params (OrariTraStazioniInput): - stazione_a: stazione di salita (nome o ID) - stazione_b: stazione di discesa (nome o ID) - orario_da: orario minimo di partenza da A, formato HH:MM (default: ora attuale) - limite: max treni da mostrare (default 10) Returns: Tabella markdown con: numero treno, linea, partenza da A, arrivo a B, fermate intermedie, ritardo real-time (se disponibile).