API Reference
Kompletna dokumentacja wszystkich narzedzi MCP dostepnych w arvo-mcp. Kazde narzedzie zawiera parametry, typy zwracane i przyklady uzycia.
Narzedzia Odczytu
Narzedzia do pobierania danych bez modyfikacji. Bezpieczne w uzytku.
get_workoutsPobierz historie treningow z opcjonalnym filtrowaniem
Parametry
limitnumberopcjonalne- Maks. wynikow (domyslnie: 20)offsetnumberopcjonalne- Offset paginacjifrom_datestringopcjonalne- Data poczatkowa (ISO 8601)to_datestringopcjonalne- Data koncowa (ISO 8601)Zwraca
Tablica obiektow treningowych z cwiczeniami i seriami
Przyklad
"Pokaz mi moje treningi z zeszlego tygodnia"
get_workout_by_idPobierz szczegolowe informacje o konkretnym treningu
Parametry
workout_idstringwymagane- UUID treninguZwraca
Kompletny obiekt treningu z wszystkimi cwiczeniami, seriami i notatkami
Przyklad
"Pokaz mi szczegoly treningu abc123"
get_personal_recordsPobierz wszystkie rekordy osobiste (PR)
Parametry
exercise_idstringopcjonalne- Filtruj po cwiczeniupr_typestringopcjonalne- Typ: 1rm, objetosc, powtorzeniaZwraca
Tablica obiektow PR z cwiczeniem, ciezarem, data
Przyklad
"Jaki jest moj PR w wyciskaniu na lawce?"
get_exercisesWyswietl wszystkie dostepne cwiczenia w bazie danych
Parametry
muscle_groupstringopcjonalne- Filtruj po grupie miesniowejequipmentstringopcjonalne- Filtruj po sprzeciesearchstringopcjonalne- Fraza wyszukiwaniaZwraca
Tablica obiektow cwiczen ze szczegolami
Przyklad
"Jakie cwiczenia anguzuja klatke piersiowa?"
get_exercise_historyPobierz historie wynikow dla konkretnego cwiczenia
Parametry
exercise_idstringwymagane- UUID cwiczenialimitnumberopcjonalne- Maks. wynikowZwraca
Tablica historycznych serii z ciezarami, powtorzeniami, datami
Przyklad
"Pokaz moje postepy w przysiadach w czasie"
get_training_splitPobierz aktualny podzial/program treningowy
Zwraca
Obiekt podzialu treningowego z dniami i cwiczeniami
Przyklad
"Jaki jest moj aktualny podzial treningowy?"
get_profilePobierz informacje o profilu uzytkownika
Zwraca
Profil uzytkownika z ustawieniami i preferencjami
Przyklad
"Pokaz ustawienia mojego profilu"
get_body_measurementsPobierz historie pomiarow ciala
Parametry
measurement_typestringopcjonalne- Typ: waga, tkanka tluszczowa, itp.limitnumberopcjonalne- Maks. wynikowZwraca
Tablica obiektow pomiarow z datami
Przyklad
"Jak zmienila sie moja waga w tym miesiacu?"
get_workout_statsPobierz zagregowane statystyki treningow
Parametry
periodstringopcjonalne- tydzien, miesiac, rok, wszystkoZwraca
Obiekt statystyk z sumami, srednimi, trendami
Przyklad
"Ile treningow zrobilem w tym miesiacu?"
get_muscle_groupsWyswietl wszystkie grupy miesniowe
Zwraca
Tablica nazw grup miesniowych
Przyklad
"Jakie grupy miesniowe moge sledzic?"
get_equipmentWyswietl dostepne typy sprzetu
Zwraca
Tablica nazw sprzetu
Przyklad
"Jakie opcje sprzetu sa dostepne?"
search_exercisesWyszukiwanie pelnotekstowe wsrod cwiczen
Parametry
querystringwymagane- Zapytanie wyszukiwanialimitnumberopcjonalne- Maks. wynikowZwraca
Tablica pasujacych cwiczen
Przyklad
"Znajdz cwiczenia podobne do martwego ciagu"
get_scheduled_workoutPobierz trening zaplanowany na konkretna date
Parametry
datestringopcjonalne- Data (domyslnie: dzisiaj)Zwraca
Zaplanowany trening lub null
Przyklad
"Jaki mam trening dzisiaj?"
get_pr_historyPobierz progresje PR w czasie
Parametry
exercise_idstringwymagane- UUID cwiczeniaZwraca
Tablica historycznych PR z datami
Przyklad
"Pokaz historie moich PR w wyciskaniu na lawce"
Narzedzia Zapisu
Narzedzia modyfikujace dane. Wymagaja jawnego potwierdzenia.
log_workoutZarejestruj kompletna sesje treningowa
Parametry
namestringopcjonalne- Nazwa treningudatestringopcjonalne- Data (domyslnie: teraz)exercisesarraywymagane- Tablica cwiczen z seriaminotesstringopcjonalne- Notatki do treninguZwraca
Utworzony obiekt treningu
Przyklad
"Zarejestruj dzisiejszy trening push: wyciskanie 3x8@100kg, OHP 3x10@60kg"
log_exerciseZarejestruj serie dla pojedynczego cwiczenia
Parametry
exercise_idstringwymagane- UUID lub nazwa cwiczeniasetsarraywymagane- Tablica {powtorzenia, ciezar, rpe}workout_idstringopcjonalne- Dodaj do istniejacego treninguZwraca
Zarejestrowane cwiczenie z seriami
Przyklad
"Zarejestruj 3 serie po 8 powtorzen na 100kg w przysiadach"
update_personal_recordRecznie zaktualizuj PR
Parametry
exercise_idstringwymagane- UUID cwiczeniaweightnumberwymagane- Ciezar PR w kgrepsnumberopcjonalne- Powtorzenia (dla PR powtorzen)datestringopcjonalne- Data PRZwraca
Zaktualizowany obiekt PR
Przyklad
"Zaktualizuj moj PR w martwym ciagu na 200kg"
create_workout_planWygeneruj plan/szablon treningowy
Parametry
namestringwymagane- Nazwa planutypestringopcjonalne- push, pull, nogi, itp.exercisesarraywymagane- Tablica cwiczenZwraca
Utworzony obiekt planu
Przyklad
"Stworz trening push z wyciskaniem, OHP i tricepsem"
update_training_splitZaktualizuj podzial/harmonogram treningowy
Parametry
daysarraywymagane- Tablica konfiguracji dniZwraca
Zaktualizowany obiekt podzialu
Przyklad
"Zmien moj podzial na push/pull/nogi"
log_body_measurementZarejestruj pomiar ciala
Parametry
typestringwymagane- waga, tkanka tluszczowa, klatka, itp.valuenumberwymagane- Wartosc pomiaruunitstringopcjonalne- Jednostka (kg, cm, %)datestringopcjonalne- Data (domyslnie: teraz)Zwraca
Zarejestrowany obiekt pomiaru
Przyklad
"Zarejestruj moja wage jako 85kg"
create_exerciseStworz niestandardowe cwiczenie
Parametry
namestringwymagane- Nazwa cwiczeniamuscle_groupsarraywymagane- Miesnie doceloweequipmentstringopcjonalne- Wymagany sprzetZwraca
Utworzony obiekt cwiczenia
Przyklad
"Stworz niestandardowe cwiczenie o nazwie Cable Fly"
update_workoutZaktualizuj istniejacy trening
Parametry
workout_idstringwymagane- UUID treninguupdatesobjectwymagane- Pola do aktualizacjiZwraca
Zaktualizowany obiekt treningu
Przyklad
"Dodaj notatki do mojego ostatniego treningu"
delete_workoutUsun trening (wymaga potwierdzenia)
Parametry
workout_idstringwymagane- UUID treninguZwraca
Potwierdzenie usuniecia
Przyklad
"Usun moj trening z wczoraj"
schedule_workoutZaplanuj trening na przyszla date
Parametry
datestringwymagane- Data docelowaworkout_plan_idstringopcjonalne- Plan do zaplanowaniaexercisesarrayopcjonalne- Niestandardowe cwiczeniaZwraca
Obiekt zaplanowanego treningu
Przyklad
"Zaplanuj trening nog na jutro"
update_profileZaktualizuj ustawienia profilu uzytkownika
Parametry
updatesobjectwymagane- Pola profilu do aktualizacjiZwraca
Zaktualizowany obiekt profilu
Przyklad
"Zmien moje preferencje jednostek na metryczne"
add_set_to_exerciseDodaj serie do istniejacego cwiczenia w treningu
Parametry
workout_idstringwymagane- UUID treninguexercise_idstringwymagane- UUID cwiczeniarepsnumberwymagane- Liczba powtorzenweightnumberwymagane- Ciezar w kgrpenumberopcjonalne- RPE (1-10)Zwraca
Zaktualizowane cwiczenie z nowa seria
Przyklad
"Dodaj kolejna serie 8 powtorzen na 100kg do wyciskania"
copy_workoutZduplikuj istniejacy trening
Parametry
workout_idstringwymagane- Trening do skopiowaniadatestringopcjonalne- Nowa dataZwraca
Nowa kopia treningu
Przyklad
"Skopiuj trening z zeszlego poniedzialku na dzisiaj"
start_workoutRozpocznij sesje treningowa na zywo
Parametry
plan_idstringopcjonalne- Opcjonalny plan do sledzeniaZwraca
Aktywna sesja treningowa
Przyklad
"Rozpocznij moj trening push"
finish_workoutZakoncz biezaca sesje treningowa
Parametry
notesstringopcjonalne- Koncowe notatkiZwraca
Podsumowanie ukonczoonego treningu
Przyklad
"Zakoncz moj trening, dzisiaj czulem sie swietnie"
Czesto Zadawane Pytania
Jak wywolac te narzedzia?
Nie wywolujesz ich bezposrednio. Te narzedzia sa udostepniane przez MCP asystentom AI. Wystarczy zapytac Claude naturalnie, np. 'Jaki mam trening dzisiaj?' a automatycznie uzyje odpowiedniego narzedzia.
Jaka jest roznica miedzy narzedziami do odczytu i zapisu?
Narzedzia do odczytu tylko pobieraja dane i sa bezpieczne w uzyciu. Narzedzia do zapisu modyfikuja Twoje dane (rejestrowanie treningow, aktualizacja PR) i zwykle wymagaja potwierdzenia przed wykonaniem.
Czy sa limity zapytan?
Serwer MCP ma hojne limity do uzytu osobistego. Intensywne wzorce uzytkowania moga byc ograniczane. W przypadku potrzeb enterprise, skontaktuj sie z nami w sprawie rozwiazac dedykowanych.
Czy moge uzywac tych narzedzi programowo?
Obecnie te narzedzia sa dostepne tylko przez MCP. REST API do bezposredniego dostepu programowego jest w naszym planie rozwoju. Dolacz do listy oczekujacych, aby otrzymac powiadomienie.