Pienotto per gli agenti AI
Pienotto espone un server Model Context Protocol: colleghi Claude o un altro assistente che parla MCP al tuo account e da lì in poi «ho fatto il pieno, 42 euro di gasolio» o «dove conviene fare benzina vicino a Verona?» diventano frasi che l'assistente sa trasformare in fatti: un pieno registrato nel tuo garage, una classifica di prezzi veri.
Cosa può fare il tuo assistente
8 strumenti, nessuno distruttivo: quello che creano si corregge dall'app.
best_prices
Le stazioni più convenienti attorno a un comune, un indirizzo o una posizione, per il carburante che chiedi. Quota solo prezzi che superano il vaglio di credibilità del sito: mai un refuso di battitura spacciato per occasione.
search_stations
Cerca distributori per nome, marchio, indirizzo o comune, con il miglior prezzo comunicato da ciascuno. È così che «il Q8 di Via Roma» diventa la stazione giusta.
add_refueling
Registra un pieno su un tuo veicolo: quantità, totale, data, chilometri e stazione. I chilometri permettono di calcolare i consumi reali.
list_refuelings
Rilegge i pieni di un veicolo dal più recente, con prezzo al litro effettivo e consumo calcolato tra un pieno e l'altro.
add_odometer_reading
Segna i chilometri del contachilometri quando li leggi, anche lontano da un pieno: bastano a disegnare i chilometri percorsi, e vicini a un pieno ne stimano il consumo.
list_odometer_readings
Rilegge le letture del contachilometri di un veicolo e i chilometri percorsi mese per mese.
add_vehicle
Aggiunge un veicolo al garage: nome, carburante, targa, serbatoio e consumo dichiarato.
list_vehicles
Elenca il garage con consumo, chilometri percorsi, ultima lettura del contachilometri e spesa totale per veicolo.
Come collegarlo
Serve solo un account Pienotto, gratuito. L'endpoint è https://pienotto.it/mcp e pubblica da solo tutto quello che serve a un client MCP: la discovery OAuth su /.well-known/oauth-protected-resource e la registrazione automatica dei client. Con Claude Code, ad esempio:
claude mcp add --transport http pienotto https://pienotto.it/mcp
Alla prima connessione il browser si apre su Pienotto e ti chiede di autorizzare l'accesso: nessuna password finisce nel client, e l'autorizzazione si può ignorare se non l'hai avviata tu.
Limiti e riservatezza
- L'assistente vede e scrive solo i dati del tuo account: i tuoi veicoli e i tuoi pieni, mai quelli di altri.
- Niente cancellazioni e niente carte fedeltà via MCP: quelle restano nell'app.
- Un pieno registrato dall'assistente resta privato e non tocca i prezzi pubblici: quelli si documentano solo fotografando il pieno nell'app.
- L'accesso scade da solo dopo 30 giorni di inattività e il server accetta al più 60 richieste l'ora.