API Reference
Documentazione completa di tutti i tool MCP disponibili in arvo-mcp. Ogni tool include parametri, tipi di ritorno ed esempi di utilizzo.
Tool di Lettura
Tool per recuperare dati senza modificare nulla. Sicuri da usare liberamente.
get_workoutsRecupera lo storico allenamenti con filtri opzionali
Parametri
limitnumberopzionale- Max risultati (default: 20)offsetnumberopzionale- Offset paginazionefrom_datestringopzionale- Data inizio (ISO 8601)to_datestringopzionale- Data fine (ISO 8601)Ritorna
Array di oggetti workout con esercizi e serie
Esempio
"Mostrami i miei allenamenti della scorsa settimana"
get_workout_by_idOttieni info dettagliate per un workout specifico
Parametri
workout_idstringrichiesto- UUID del workoutRitorna
Oggetto workout completo con tutti gli esercizi, serie e note
Esempio
"Mostrami i dettagli del workout abc123"
get_personal_recordsRecupera tutti i record personali (PR)
Parametri
exercise_idstringopzionale- Filtra per eserciziopr_typestringopzionale- Tipo: 1rm, volume, repsRitorna
Array di oggetti PR con esercizio, peso, data
Esempio
"Qual e il mio PR di panca?"
get_exercisesLista tutti gli esercizi disponibili nel database
Parametri
muscle_groupstringopzionale- Filtra per gruppo muscolareequipmentstringopzionale- Filtra per attrezzaturasearchstringopzionale- Termine di ricercaRitorna
Array di oggetti esercizio con dettagli
Esempio
"Quali esercizi lavorano il petto?"
get_exercise_historyOttieni lo storico performance per un esercizio specifico
Parametri
exercise_idstringrichiesto- UUID eserciziolimitnumberopzionale- Max risultatiRitorna
Array di serie storiche con pesi, reps, date
Esempio
"Mostra i miei progressi squat nel tempo"
get_training_splitOttieni la split/programma di allenamento attuale
Ritorna
Oggetto split con giorni ed esercizi
Esempio
"Qual e la mia split attuale?"
get_profileOttieni informazioni profilo utente
Ritorna
Profilo utente con impostazioni e preferenze
Esempio
"Mostra le impostazioni del mio profilo"
get_body_measurementsRecupera lo storico misurazioni corporee
Parametri
measurement_typestringopzionale- Tipo: peso, bodyfat, ecc.limitnumberopzionale- Max risultatiRitorna
Array di oggetti misurazione con date
Esempio
"Come e cambiato il mio peso questo mese?"
get_workout_statsOttieni statistiche aggregate allenamenti
Parametri
periodstringopzionale- settimana, mese, anno, tuttoRitorna
Oggetto statistiche con totali, medie, trend
Esempio
"Quanti allenamenti ho fatto questo mese?"
get_muscle_groupsLista tutti i gruppi muscolari
Ritorna
Array di nomi gruppi muscolari
Esempio
"Quali gruppi muscolari posso tracciare?"
get_equipmentLista tipi di attrezzatura disponibili
Ritorna
Array di nomi attrezzature
Esempio
"Quali opzioni attrezzatura sono disponibili?"
search_exercisesRicerca full-text tra gli esercizi
Parametri
querystringrichiesto- Query di ricercalimitnumberopzionale- Max risultatiRitorna
Array di esercizi corrispondenti
Esempio
"Trova esercizi simili al deadlift"
get_scheduled_workoutOttieni workout programmato per una data specifica
Parametri
datestringopzionale- Data (default: oggi)Ritorna
Workout programmato o null
Esempio
"Qual e il mio allenamento oggi?"
get_pr_historyOttieni progressione PR nel tempo
Parametri
exercise_idstringrichiesto- UUID esercizioRitorna
Array di PR storici con date
Esempio
"Mostra lo storico PR panca"
Tool di Scrittura
Tool che modificano i dati. Richiedono conferma esplicita.
log_workoutRegistra una sessione di allenamento completa
Parametri
namestringopzionale- Nome workoutdatestringopzionale- Data (default: ora)exercisesarrayrichiesto- Array di esercizi con serienotesstringopzionale- Note workoutRitorna
Oggetto workout creato
Esempio
"Registra il push di oggi: panca 3x8@100kg, OHP 3x10@60kg"
log_exerciseRegistra serie per un singolo esercizio
Parametri
exercise_idstringrichiesto- UUID o nome eserciziosetsarrayrichiesto- Array di {reps, peso, rpe}workout_idstringopzionale- Aggiungi a workout esistenteRitorna
Esercizio registrato con serie
Esempio
"Registra 3 serie da 8 reps a 100kg per squat"
update_personal_recordAggiorna manualmente un PR
Parametri
exercise_idstringrichiesto- UUID esercizioweightnumberrichiesto- Peso PR in kgrepsnumberopzionale- Reps (per PR reps)datestringopzionale- Data PRRitorna
Oggetto PR aggiornato
Esempio
"Aggiorna il mio PR stacco a 200kg"
create_workout_planGenera un piano/template di allenamento
Parametri
namestringrichiesto- Nome pianotypestringopzionale- push, pull, legs, ecc.exercisesarrayrichiesto- Array di eserciziRitorna
Oggetto piano creato
Esempio
"Crea un allenamento push con panca, OHP e tricipiti"
update_training_splitAggiorna la split/programma di allenamento
Parametri
daysarrayrichiesto- Array di configurazioni giorniRitorna
Oggetto split aggiornato
Esempio
"Cambia la mia split in push/pull/legs"
log_body_measurementRegistra una misurazione corporea
Parametri
typestringrichiesto- peso, bodyfat, petto, ecc.valuenumberrichiesto- Valore misurazioneunitstringopzionale- Unita (kg, cm, %)datestringopzionale- Data (default: ora)Ritorna
Oggetto misurazione registrato
Esempio
"Registra il mio peso a 85kg"
create_exerciseCrea un esercizio personalizzato
Parametri
namestringrichiesto- Nome eserciziomuscle_groupsarrayrichiesto- Muscoli targetequipmentstringopzionale- Attrezzatura richiestaRitorna
Oggetto esercizio creato
Esempio
"Crea un esercizio personalizzato chiamato Cable Fly"
update_workoutAggiorna un workout esistente
Parametri
workout_idstringrichiesto- UUID workoutupdatesobjectrichiesto- Campi da aggiornareRitorna
Oggetto workout aggiornato
Esempio
"Aggiungi note al mio ultimo workout"
delete_workoutElimina un workout (richiede conferma)
Parametri
workout_idstringrichiesto- UUID workoutRitorna
Conferma eliminazione
Esempio
"Elimina il mio workout di ieri"
schedule_workoutProgramma un workout per una data futura
Parametri
datestringrichiesto- Data targetworkout_plan_idstringopzionale- Piano da programmareexercisesarrayopzionale- Esercizi personalizzatiRitorna
Oggetto workout programmato
Esempio
"Programma leg day per domani"
update_profileAggiorna impostazioni profilo utente
Parametri
updatesobjectrichiesto- Campi profilo da aggiornareRitorna
Oggetto profilo aggiornato
Esempio
"Cambia la mia preferenza unita a metrico"
add_set_to_exerciseAggiungi una serie a un esercizio esistente in un workout
Parametri
workout_idstringrichiesto- UUID workoutexercise_idstringrichiesto- UUID eserciziorepsnumberrichiesto- Numero di repsweightnumberrichiesto- Peso in kgrpenumberopzionale- RPE (1-10)Ritorna
Esercizio aggiornato con nuova serie
Esempio
"Aggiungi un'altra serie da 8 reps a 100kg alla panca"
copy_workoutDuplica un workout esistente
Parametri
workout_idstringrichiesto- Workout da copiaredatestringopzionale- Nuova dataRitorna
Nuova copia workout
Esempio
"Copia il workout di lunedi scorso ad oggi"
start_workoutInizia una sessione workout live
Parametri
plan_idstringopzionale- Piano opzionale da seguireRitorna
Sessione workout attiva
Esempio
"Inizia il mio workout push"
finish_workoutTermina la sessione workout corrente
Parametri
notesstringopzionale- Note finaliRitorna
Riepilogo workout completato
Esempio
"Termina il mio workout, mi sono sentito bene oggi"
Domande Frequenti
Come chiamo questi tool?
Non li chiami direttamente. Questi tool sono esposti tramite MCP agli assistenti AI. Basta chiedere a Claude naturalmente, come 'Qual e il mio workout oggi?' e usera automaticamente il tool appropriato.
Qual e la differenza tra tool di lettura e scrittura?
I tool di lettura recuperano solo dati e sono sicuri da usare liberamente. I tool di scrittura modificano i tuoi dati (registrare workout, aggiornare PR) e tipicamente richiedono conferma prima dell'esecuzione.
Ci sono limiti di richieste?
Il server MCP ha limiti generosi per uso personale. Pattern di utilizzo intensivo potrebbero essere limitati. Per esigenze enterprise, contattaci per soluzioni personalizzate.
Posso usare questi tool programmaticamente?
Attualmente questi tool sono disponibili solo tramite MCP. Un'API REST per accesso programmatico diretto e nella nostra roadmap. Iscriviti alla waitlist per essere notificato.