Guida di riferimento

Tutto quello che la tua IA può fare

Non li chiami mai direttamente — parli e basta, e l'assistente sceglie lo strumento giusto. Ecco l'elenco completo che il server Nutrition MCP mette a disposizione, con cosa fa ciascuno e una frase che lo attiva.

38 strumenti in 7 aree

Questa pagina è stata tradotta con l'IA dall'inglese e non è stata rivista da una persona. Leggi l'originale in inglese

Registrare cibo e pasti

Il ciclo principale — cattura cosa hai mangiato, comunque tu lo descriva.

log_meal Registra UI interattiva

Registra cosa hai mangiato con calorie e macro — più fibre, zuccheri totali, alcol e caffeina quando i numeri sono disponibili. Descrivilo con parole tue — l'IA stima i valori, chiede la dimensione della porzione quando non è chiara, e può recuperare prima i dati dell'etichetta da un codice a barre o dal web.

Parametri
  • description obbligatorio — Cosa è stato mangiato
  • meal_type obbligatorio — colazione, pranzo, cena o spuntino
  • calories opzionale — Calorie totali
  • protein_g opzionale — Proteine in grammi
  • carbs_g opzionale — Carboidrati in grammi
  • fat_g opzionale — Grassi in grammi
  • fiber_g opzionale — Fibre alimentari in grammi. All'IA viene chiesto di compilare questo campo per ogni pasto, stimandolo dagli ingredienti quando non esiste un valore da etichetta, perché un campo vuoto non equivale a zero — esclude l'intera giornata dalla tua media di fibre
  • sugar_g opzionaleTotale zuccheri in grammi — il valore che un'etichetta riporta sotto "Zuccheri", incluso lo zucchero naturalmente presente in frutta e latte, non solo gli zuccheri aggiunti. Compilato per ogni pasto alle stesse condizioni delle fibre
  • alcohol_g opzionale — Grammi di etanolo puro, non il volume della bevanda né la sua gradazione — l'IA lo calcola dalla quantità versata e dalla gradazione (una birra da 330 ml al 5% corrisponde a 13 g)
  • caffeine_mg opzionale — Caffeina in milligrammi, non grammi — l'unico campo qui che non è in grammi, perché è così che ogni etichetta e linea guida la esprime (un caffè filtro è circa 95 mg, un espresso 63 mg, una lattina di cola 34 mg). La caffeina non aggiunge calorie. A differenza di fibre e zuccheri, viene inviata solo per alimenti che effettivamente contengono caffeina — uno 0 registrato metterebbe una riga di caffeina nella tua dashboard per un nutriente che non consumi mai
  • logged_at opzionale — Quando l'hai mangiato, se non è adesso — permette di registrare qualcosa a posteriori
  • notes opzionale — Note aggiuntive
Prova a dire

Registra una burrito bowl di pollo con guacamole extra per pranzo

…oppure scatta una foto del tuo piatto — l'IA identifica ogni pietanza, stima le porzioni in misure comuni (un bicchiere, una manciata), controlla come l'hai registrata in passato e conferma con te prima di registrare.

lookup_barcode Cerca

Recupera i valori nutrizionali dell'etichetta di un prodotto confezionato da Open Food Facts tramite il suo codice a barre (EAN/UPC di 8–14 cifre). Puoi digitare le cifre o leggerle da una foto della confezione; il risultato può poi essere registrato, adattato a quanto ne hai mangiato.

Prova a dire

Scansiona questo codice a barre: 3017620422003

…oppure invia una foto della confezione — l'IA legge le cifre del codice a barre da lì.

start_meal_import Importa UI interattiva

Apre un importatore nella chat per portare il tuo storico da un'altra app — scegli il file esportato da MyFitnessPal, Cronometer, Lose It! o MacroFactor, mappane le colonne su calorie, macro, fibre, zuccheri e caffeina — più alcol se hai attivato il tracciamento dell'alcol — e rivedi cosa verrà aggiunto prima di confermare. Il file viene letto nel tuo browser, nulla viene salvato finché non approvi l'anteprima, e importare di nuovo lo stesso file non crea duplicati.

Prova a dire

Importa il mio storico pasti da MyFitnessPal

bulk_import_meals Importa

Aggiunge un lotto di pasti passati in un'unica volta — fino a 50 alla volta — invece di registrarli uno per uno. L'importatore qui sopra scrive attraverso questo strumento, e l'IA può usarlo direttamente per dati di pasti che hai incollato in chat. Ogni riga viene controllata prima, e tutto ciò che non va bene viene segnalato riga per riga, quindi rinviare le stesse righe è sicuro e non duplica ciò che è già stato registrato.

Parametri
  • meals obbligatorio — Le righe da importare, nell'ordine del file di origine (1–50 per chiamata). Ogni riga può contenere un orario, il tipo di pasto, una descrizione, note e gli stessi valori di un pasto registrato: calories, protein_g, carbs_g, fat_g, fiber_g, sugar_g (zuccheri totali), alcohol_g (grammi di etanolo puro) e caffeine_mg (milligrammi, non grammi)
  • expected_row_count obbligatorio — Quante righe contiene questa chiamata, contate dal file di origine, così una riga persa viene individuata
  • expected_total_kcal opzionale — Totale calorico del file di origine, riconciliato con quanto arriva
  • dry_run opzionale — Segnala cosa accadrebbe senza scrivere nulla
  • on_error opzionale — Importa le righe valide e segnala le altre, oppure non scrivere nulla se una riga fallisce
  • source_app opzionale — Da quale app proviene il file
Prova a dire

Ecco i pasti della scorsa settimana incollati dalla mia vecchia app — aggiungili tutti

update_meal Modifica UI interattiva

Modifica i dettagli di un pasto già registrato — la sua descrizione, qualsiasi macro, fibre, zuccheri, alcol o caffeina, l'orario o le note. È anche il modo in cui si colma una lacuna: se un pasto è stato registrato senza fibre o zuccheri, il server lo segnala e l'IA li compila qui.

Parametri
  • id obbligatorio — UUID del pasto da aggiornare
  • description opzionale
  • calories opzionale
  • protein_g opzionale
  • carbs_g opzionale
  • fat_g opzionale
  • fiber_g opzionale
  • sugar_g opzionale — Zuccheri totali, non zuccheri aggiunti
  • alcohol_g opzionale — Grammi di etanolo puro, non il volume della bevanda
  • caffeine_mg opzionale — Milligrammi, non grammi
  • logged_at opzionale
  • notes opzionale
Prova a dire

In realtà quel pranzo era di 600 calorie, non 500 — correggilo

delete_meal Rimuovi

Rimuove una voce di pasto registrata per errore.

Parametri
  • id obbligatorio — UUID del pasto da eliminare
Prova a dire

Elimina lo spuntino che ho registrato questo pomeriggio

Rivedere i tuoi pasti

Guarda indietro a ciò che hai registrato, un giorno o un intero intervallo alla volta.

search_meals Visualizza

Cerca tra i tuoi pasti passati per parola chiave e vedili raggruppati nelle loro varianti ricorrenti — quante volte ognuna è stata registrata, quando l'ultima volta, e le sue calorie tipiche. È così che l'IA confronta una foto del tuo piatto con come hai effettivamente registrato quel pasto in passato, ed è come funziona "registra la mia colazione abituale".

Parametri
  • queries obbligatorio — Alternative di parole chiave per il cibo, in qualsiasi lingua tu abbia usato per registrare
  • days opzionale — Quanto indietro guardare (predefinito un anno)
  • limit opzionale — Numero massimo di voci da analizzare
Prova a dire

Registra la mia colazione abituale

get_meals_today Visualizza

Vedi ogni pasto che hai registrato oggi.

Prova a dire

Cosa ho mangiato oggi?

get_meals_by_date Visualizza

Vedi tutti i pasti che hai registrato in un giorno specifico.

Parametri
  • date obbligatorio — Data in formato AAAA-MM-GG
Prova a dire

Mostrami tutto quello che ho mangiato il 4 luglio

get_meals_by_date_range Visualizza

Recupera tutti i pasti tra due date in un'unica volta — utile per rivedere una settimana o un mese.

Parametri
  • start_date obbligatorio — Data di inizio (AAAA-MM-GG)
  • end_date obbligatorio — Data di fine (AAAA-MM-GG)
Prova a dire

Elenca i miei pasti da lunedì a venerdì

export_all_data Esporta

Esporta tutto ciò che hai tracciato come un unico file ZIP — meals.csv, water.csv, weight.csv, goals.csv, profile.csv e un README.txt che spiega colonne e unità di misura — con lo stesso link privato, valido per 60 minuti. Per ora i pasti sono l'unica parte che può essere reimportata.

Prova a dire

Esporta tutti i miei dati — pasti, acqua, peso e obiettivi

Acqua

Traccia l'idratazione insieme al tuo cibo.

log_water Registra

Registra una voce di idratazione. Indicala in qualsiasi unità — tazze, once, litri — e viene convertita in millilitri per te.

Parametri
  • amount_ml obbligatorio — Quantità in millilitri (intero, > 0).
Prova a dire

Ho appena bevuto una bottiglia d'acqua da 500 ml

get_water_today Visualizza

Vedi il totale di acqua di oggi e ogni singola voce.

Prova a dire

Quanta acqua ho bevuto oggi?

get_water_by_date Visualizza

Vedi il totale di acqua e le voci per un giorno specifico.

Parametri
  • date obbligatorio — Data in formato AAAA-MM-GG
Prova a dire

Quanto ho bevuto ieri?

delete_water Rimuovi

Rimuove una voce di acqua aggiunta per errore.

Parametri
  • id obbligatorio — UUID della voce di acqua da eliminare
Prova a dire

Rimuovi l'ultima voce di acqua

Peso

Registra le pesate, rivedile e osserva l'andamento verso il tuo obiettivo.

log_weight Registra

Registra una misurazione del peso corporeo in kg o lb. Più pesate nello stesso giorno vanno bene, e il server le memorizza in modo canonico così la tua unità preferita non distorce mai il numero.

Parametri
  • weight obbligatorio — Valore del peso corporeo, in `unit` (> 0).
Prova a dire

Registra il mio peso — 74,2 kg stamattina

update_weight Modifica

Corregge una pesata esistente — il valore, l'orario o le sue note.

Parametri
  • id obbligatorio — UUID della voce di peso da aggiornare
  • weight opzionale — Nuovo valore del peso, in `unit`.
  • logged_at opzionale — Timestamp ISO 8601
  • notes opzionale
Prova a dire

Correggi la pesata di stamattina a 73,8 kg

delete_weight Rimuovi

Rimuove una voce di peso.

Parametri
  • id obbligatorio — UUID della voce di peso da eliminare
Prova a dire

Elimina la voce di peso di oggi

get_weight_today Visualizza

Vedi le pesate di oggi, mostrate nella tua unità preferita.

Prova a dire

Quanto pesavo oggi?

get_weight_by_date Visualizza

Vedi le tue pesate per un giorno specifico.

Parametri
  • date obbligatorio — Data in formato AAAA-MM-GG
Prova a dire

Qual era il mio peso il giorno 1?

get_weight_by_date_range Visualizza

Ottieni ogni pesata tra due date, raggruppate per giorno con la media di ciascun giorno.

Parametri
  • start_date obbligatorio — Data di inizio (AAAA-MM-GG)
  • end_date obbligatorio — Data di fine (AAAA-MM-GG)
Prova a dire

Mostrami le mie pesate delle ultime due settimane

set_weight_unit Impostazione

Scegli se il peso viene mostrato e inserito in kg o lb. I valori memorizzati non sono influenzati — cambiano solo la visualizzazione e l'interpretazione predefinita.

Prova a dire

Usa le libbre per il mio peso da ora in poi

get_weight_unit Visualizza

Controlla quale unità di peso stai usando attualmente.

Prova a dire

Quale unità di peso sto usando?

Obiettivi e progressi

Imposta i target e scopri come si comporta ogni giornata.

set_nutrition_goals Impostazione

Imposta i tuoi obiettivi giornalieri di calorie, macro, fibre, zuccheri, alcol, caffeina e acqua, più un peso corporeo obiettivo facoltativo. Calorie, proteine, carboidrati, grassi, fibre e acqua sono target da raggiungere; zuccheri, alcol e caffeina sono limiti da non superare, e i progressi sono espressi di conseguenza. Aggiorna solo i campi che indichi; il resto rimane invariato.

Parametri
  • daily_calories opzionale — Target calorico giornaliero (kcal). Null per azzerarlo.
  • daily_protein_g opzionale — Target giornaliero di proteine (grammi). Null per azzerarlo.
  • daily_carbs_g opzionale — Target giornaliero di carboidrati (grammi). Null per azzerarlo.
  • daily_fat_g opzionale — Target giornaliero di grassi (grammi). Null per azzerarlo.
  • daily_fiber_g opzionale — Target giornaliero di fibre (grammi), un minimo da raggiungere. Null per azzerarlo.
  • daily_sugar_g opzionale — Limite giornaliero per gli zuccheri totali (grammi), un massimo da non superare. Gli zuccheri totali includono lo zucchero naturalmente presente in frutta e latte, quindi le linee guida pubbliche sugli zuccheri aggiunti indicano un numero molto più basso. Null per azzerarlo.
  • daily_alcohol_g opzionale — Limite giornaliero di alcol in grammi di etanolo puro, un massimo da non superare. Un drink standard USA è 14 g, un'unità britannica 7,9 g. Null per azzerarlo.
  • daily_caffeine_mg opzionale — Limite giornaliero di caffeina in milligrammi, un massimo da non superare. Il tetto EFSA e FDA per adulti sani è 400 mg al giorno (circa quattro caffè filtro), e 200 mg in gravidanza. 0 è un limite reale che significa nessuna caffeina. Null per azzerarlo.
  • daily_water_ml opzionale
  • target_weight opzionale
Prova a dire

Imposta i miei obiettivi a 2.200 calorie, 160 g di proteine e un peso obiettivo di 75 kg

get_nutrition_goals Visualizza

Vedi i tuoi target giornalieri attuali di calorie e macro, qualsiasi target di fibre e limite di zuccheri o caffeina, e — se tracci l'alcol — il tuo limite di alcol.

Prova a dire

Quali sono i miei target giornalieri?

get_goal_progress Visualizza UI interattiva

Vedi come si posiziona l'assunzione di oggi rispetto ai tuoi obiettivi — anelli di assunzione-contro-obiettivo più i progressi sul peso corporeo. Tocca un anello di una macro per vedere quali pasti hanno contribuito.

Prova a dire

Come sto andando rispetto ai miei obiettivi oggi?

get_nutrition_summary Visualizza UI interattiva

Ottieni i totali nutrizionali giornalieri in un intervallo di date come dashboard interattiva: riquadri delle macro rispetto agli obiettivi e una ripartizione per giorno.

Parametri
  • start_date obbligatorio — Data di inizio (AAAA-MM-GG)
  • end_date obbligatorio — Data di fine (AAAA-MM-GG)
Prova a dire

Dammi un riepilogo di questa settimana passata

Impostazioni e account

Preferenze che mantengono tutto accurato, più il controllo completo dei tuoi dati.

set_timezone Impostazione

Imposta il tuo fuso orario IANA così i giorni cambiano alla tua mezzanotte locale — un pasto registrato alle 23 conta per quel giorno, non per quello successivo UTC.

Prova a dire

Sono a Berlino — imposta il mio fuso orario

get_timezone Visualizza

Controlla il fuso orario per cui sei configurato, insieme alla tua data e ora locale attuale (predefinito UTC se non impostato).

Prova a dire

A quale fuso orario sono impostato?

get_current_time Visualizza

Controlla la data e l'ora esatte nel tuo fuso orario, più l'istante UTC. Alcune app non dicono all'assistente che ore sono, quindi è così che capisce cosa significano "stamattina" o "oggi" senza doverti chiedere (predefinito UTC se nessun fuso orario è impostato).

Prova a dire

Che ore sono per me in questo momento?

set_widget_display Impostazione

Attiva o disattiva i widget visivi in chat — le dashboard, gli anelli degli obiettivi e i grafici degli andamenti. Quando disattivati, gli stessi strumenti rispondono solo con testo e dati. Attivi per impostazione predefinita; il cambiamento si applica alle nuove conversazioni.

Parametri
  • enabled obbligatorio — true per mostrare i widget, false per risposte solo testuali
Prova a dire

Disattiva i widget

get_widget_display Visualizza

Controlla se i widget visivi in chat sono attualmente attivati.

Prova a dire

I widget sono attivati?

set_alcohol_tracking Impostazione

Attiva o disattiva il tracciamento dell'alcol, e scegli se i drink vengono contati in drink standard USA o unità britanniche. È disattivato per impostazione predefinita, quindi devi chiederlo esplicitamente. Disattivarlo di nuovo nasconde l'alcol da pasti, obiettivi e progressi e impedisce all'importatore di file di leggere la colonna dell'alcol di un file — nulla di già registrato viene eliminato, la tua esportazione CSV lo include comunque, e riappare se lo riattivi. Il cambiamento si applica dal tuo prossimo messaggio, senza bisogno di riavviare nulla.

Parametri
  • enabled obbligatorio — true per mostrare l'alcol in pasti, obiettivi e progressi, false per nasconderlo
  • drink_unit opzionale — Quale drink standard mostrare accanto ai grammi: us (14 g per drink) o uk (7,9 g per unità). Predefinito us; ciò che viene effettivamente memorizzato sono i grammi di etanolo puro.
Prova a dire

Inizia a tracciare quanto bevo, in unità britanniche

get_alcohol_tracking Visualizza

Controlla se il tracciamento dell'alcol è attivo, e con quale drink standard sono mostrati i tuoi grammi.

Prova a dire

Sto tracciando l'alcol?

delete_account Rimuovi

Elimina permanentemente il tuo account e tutti i dati associati. È irreversibile — l'IA conferma sempre con te prima.

Prova a dire

Elimina il mio account e tutti i miei dati