DeveloperAPI Reference

API Reference

Documentacion completa de todas las herramientas MCP disponibles en arvo-mcp. Cada herramienta incluye parametros, tipos de retorno y ejemplos de uso.

29 herramientas disponibles
Guia de Configuracion MCPProbar en RapidAPI
Herramientas de Lectura (14)Herramientas de Escritura (15)

Herramientas de Lectura

Herramientas para recuperar datos sin modificar nada. Seguras para usar libremente.

get_workouts

Recuperar historial de entrenamientos con filtrado opcional

READ

Parametros

limitnumberopcional- Max resultados (por defecto: 20)
offsetnumberopcional- Offset de paginacion
from_datestringopcional- Fecha de inicio (ISO 8601)
to_datestringopcional- Fecha de fin (ISO 8601)

Retorna

Array de objetos de entrenamiento con ejercicios y series

Ejemplo

"Muestrame mis entrenamientos de la semana pasada"

get_workout_by_id

Obtener informacion detallada de un entrenamiento especifico

READ

Parametros

workout_idstringrequerido- UUID del entrenamiento

Retorna

Objeto de entrenamiento completo con todos los ejercicios, series y notas

Ejemplo

"Muestrame los detalles del entrenamiento abc123"

get_personal_records

Recuperar todos los records personales (PRs)

READ

Parametros

exercise_idstringopcional- Filtrar por ejercicio
pr_typestringopcional- Tipo: 1rm, volumen, reps

Retorna

Array de objetos PR con ejercicio, peso, fecha

Ejemplo

"Cual es mi PR en press de banca?"

get_exercises

Listar todos los ejercicios disponibles en la base de datos

READ

Parametros

muscle_groupstringopcional- Filtrar por grupo muscular
equipmentstringopcional- Filtrar por equipamiento
searchstringopcional- Termino de busqueda

Retorna

Array de objetos de ejercicio con detalles

Ejemplo

"Que ejercicios trabajan el pecho?"

get_exercise_history

Obtener historial de rendimiento para un ejercicio especifico

READ

Parametros

exercise_idstringrequerido- UUID del ejercicio
limitnumberopcional- Max resultados

Retorna

Array de series historicas con pesos, reps, fechas

Ejemplo

"Muestra mi progreso en sentadilla a lo largo del tiempo"

get_training_split

Obtener la division/programa de entrenamiento actual

READ

Retorna

Objeto de division de entrenamiento con dias y ejercicios

Ejemplo

"Cual es mi division de entrenamiento actual?"

get_profile

Obtener informacion del perfil del usuario

READ

Retorna

Perfil del usuario con configuraciones y preferencias

Ejemplo

"Muestra la configuracion de mi perfil"

get_body_measurements

Recuperar historial de medidas corporales

READ

Parametros

measurement_typestringopcional- Tipo: peso, grasa corporal, etc.
limitnumberopcional- Max resultados

Retorna

Array de objetos de medicion con fechas

Ejemplo

"Como ha cambiado mi peso este mes?"

get_workout_stats

Obtener estadisticas agregadas de entrenamientos

READ

Parametros

periodstringopcional- semana, mes, ano, todo

Retorna

Objeto de estadisticas con totales, promedios, tendencias

Ejemplo

"Cuantos entrenamientos hice este mes?"

get_muscle_groups

Listar todos los grupos musculares

READ

Retorna

Array de nombres de grupos musculares

Ejemplo

"Que grupos musculares puedo rastrear?"

get_equipment

Listar tipos de equipamiento disponibles

READ

Retorna

Array de nombres de equipamiento

Ejemplo

"Que opciones de equipamiento estan disponibles?"

search_exercises

Busqueda de texto completo entre ejercicios

READ

Parametros

querystringrequerido- Consulta de busqueda
limitnumberopcional- Max resultados

Retorna

Array de ejercicios coincidentes

Ejemplo

"Encuentra ejercicios similares al peso muerto"

get_scheduled_workout

Obtener entrenamiento programado para una fecha especifica

READ

Parametros

datestringopcional- Fecha (por defecto: hoy)

Retorna

Entrenamiento programado o null

Ejemplo

"Cual es mi entrenamiento hoy?"

get_pr_history

Obtener progresion de PR a lo largo del tiempo

READ

Parametros

exercise_idstringrequerido- UUID del ejercicio

Retorna

Array de PRs historicos con fechas

Ejemplo

"Muestra mi historial de PR en press de banca"

Herramientas de Escritura

Herramientas que modifican datos. Requieren confirmacion explicita.

log_workout

Registrar una sesion de entrenamiento completa

WRITE

Parametros

namestringopcional- Nombre del entrenamiento
datestringopcional- Fecha (por defecto: ahora)
exercisesarrayrequerido- Array de ejercicios con series
notesstringopcional- Notas del entrenamiento

Retorna

Objeto de entrenamiento creado

Ejemplo

"Registra el entrenamiento push de hoy: press 3x8@100kg, OHP 3x10@60kg"

log_exercise

Registrar series para un unico ejercicio

WRITE

Parametros

exercise_idstringrequerido- UUID o nombre del ejercicio
setsarrayrequerido- Array de {reps, peso, rpe}
workout_idstringopcional- Agregar a entrenamiento existente

Retorna

Ejercicio registrado con series

Ejemplo

"Registra 3 series de 8 reps a 100kg en sentadilla"

update_personal_record

Actualizar manualmente un PR

WRITE

Parametros

exercise_idstringrequerido- UUID del ejercicio
weightnumberrequerido- Peso del PR en kg
repsnumberopcional- Reps (para PRs de reps)
datestringopcional- Fecha del PR

Retorna

Objeto de PR actualizado

Ejemplo

"Actualiza mi PR en peso muerto a 200kg"

create_workout_plan

Generar un plan/plantilla de entrenamiento

WRITE

Parametros

namestringrequerido- Nombre del plan
typestringopcional- push, pull, piernas, etc.
exercisesarrayrequerido- Array de ejercicios

Retorna

Objeto de plan creado

Ejemplo

"Crea un entrenamiento push con press, OHP y triceps"

update_training_split

Actualizar la division/programacion de entrenamiento

WRITE

Parametros

daysarrayrequerido- Array de configuraciones de dias

Retorna

Objeto de division actualizado

Ejemplo

"Cambia mi division a push/pull/piernas"

log_body_measurement

Registrar una medida corporal

WRITE

Parametros

typestringrequerido- peso, grasa corporal, pecho, etc.
valuenumberrequerido- Valor de la medicion
unitstringopcional- Unidad (kg, cm, %)
datestringopcional- Fecha (por defecto: ahora)

Retorna

Objeto de medicion registrado

Ejemplo

"Registra mi peso como 85kg"

create_exercise

Crear un ejercicio personalizado

WRITE

Parametros

namestringrequerido- Nombre del ejercicio
muscle_groupsarrayrequerido- Musculos objetivo
equipmentstringopcional- Equipamiento requerido

Retorna

Objeto de ejercicio creado

Ejemplo

"Crea un ejercicio personalizado llamado Cable Fly"

update_workout

Actualizar un entrenamiento existente

WRITE

Parametros

workout_idstringrequerido- UUID del entrenamiento
updatesobjectrequerido- Campos a actualizar

Retorna

Objeto de entrenamiento actualizado

Ejemplo

"Agrega notas a mi ultimo entrenamiento"

delete_workout

Eliminar un entrenamiento (requiere confirmacion)

WRITE

Parametros

workout_idstringrequerido- UUID del entrenamiento

Retorna

Confirmacion de eliminacion

Ejemplo

"Elimina mi entrenamiento de ayer"

schedule_workout

Programar un entrenamiento para una fecha futura

WRITE

Parametros

datestringrequerido- Fecha objetivo
workout_plan_idstringopcional- Plan a programar
exercisesarrayopcional- Ejercicios personalizados

Retorna

Objeto de entrenamiento programado

Ejemplo

"Programa dia de piernas para manana"

update_profile

Actualizar configuraciones del perfil del usuario

WRITE

Parametros

updatesobjectrequerido- Campos del perfil a actualizar

Retorna

Objeto de perfil actualizado

Ejemplo

"Actualiza mi preferencia de unidad a metrico"

add_set_to_exercise

Agregar una serie a un ejercicio existente en un entrenamiento

WRITE

Parametros

workout_idstringrequerido- UUID del entrenamiento
exercise_idstringrequerido- UUID del ejercicio
repsnumberrequerido- Numero de reps
weightnumberrequerido- Peso en kg
rpenumberopcional- RPE (1-10)

Retorna

Ejercicio actualizado con nueva serie

Ejemplo

"Agrega otra serie de 8 reps a 100kg a mi press de banca"

copy_workout

Duplicar un entrenamiento existente

WRITE

Parametros

workout_idstringrequerido- Entrenamiento a copiar
datestringopcional- Nueva fecha

Retorna

Nueva copia del entrenamiento

Ejemplo

"Copia el entrenamiento del lunes pasado a hoy"

start_workout

Iniciar una sesion de entrenamiento en vivo

WRITE

Parametros

plan_idstringopcional- Plan opcional a seguir

Retorna

Sesion de entrenamiento activa

Ejemplo

"Inicia mi entrenamiento push"

finish_workout

Finalizar la sesion de entrenamiento actual

WRITE

Parametros

notesstringopcional- Notas finales

Retorna

Resumen del entrenamiento completado

Ejemplo

"Termina mi entrenamiento, me senti genial hoy"

Preguntas Frecuentes

Como llamo a estas herramientas?

No las llamas directamente. Estas herramientas estan expuestas via MCP a los asistentes de IA. Solo pregunta a Claude naturalmente, como 'Cual es mi entrenamiento hoy?' y usara la herramienta apropiada automaticamente.

Cual es la diferencia entre herramientas de lectura y escritura?

Las herramientas de lectura solo recuperan datos y son seguras de usar libremente. Las herramientas de escritura modifican tus datos (registrar entrenamientos, actualizar PRs) y tipicamente requieren confirmacion antes de ejecutarse.

Hay limites de peticiones?

El servidor MCP tiene limites generosos para uso personal. Los patrones de uso intensivo pueden ser limitados. Para necesidades empresariales, contactanos para soluciones personalizadas.

Puedo usar estas herramientas programaticamente?

Actualmente estas herramientas solo estan disponibles a traves de MCP. Una API REST para acceso programatico directo esta en nuestro roadmap. Unete a nuestra lista de espera para ser notificado.

Volver al Developer Hub