DeveloperAPI Reference

API Reference

Documentacao completa de todas as ferramentas MCP disponiveis no arvo-mcp. Cada ferramenta inclui parametros, tipos de retorno e exemplos de uso.

29 ferramentas disponiveis
Guia de Configuracao MCPTestar no RapidAPI
Ferramentas de Leitura (14)Ferramentas de Escrita (15)

Ferramentas de Leitura

Ferramentas para recuperar dados sem modificar nada. Seguras para usar livremente.

get_workouts

Recuperar historico de treinos com filtragem opcional

READ

Parametros

limitnumberopcional- Max resultados (padrao: 20)
offsetnumberopcional- Offset de paginacao
from_datestringopcional- Data inicial (ISO 8601)
to_datestringopcional- Data final (ISO 8601)

Retorna

Array de objetos de treino com exercicios e series

Exemplo

"Mostre-me meus treinos da semana passada"

get_workout_by_id

Obter informacoes detalhadas de um treino especifico

READ

Parametros

workout_idstringobrigatorio- UUID do treino

Retorna

Objeto de treino completo com todos os exercicios, series e notas

Exemplo

"Mostre-me os detalhes do treino abc123"

get_personal_records

Recuperar todos os recordes pessoais (PRs)

READ

Parametros

exercise_idstringopcional- Filtrar por exercicio
pr_typestringopcional- Tipo: 1rm, volume, reps

Retorna

Array de objetos PR com exercicio, peso, data

Exemplo

"Qual e meu PR no supino?"

get_exercises

Listar todos os exercicios disponiveis no banco de dados

READ

Parametros

muscle_groupstringopcional- Filtrar por grupo muscular
equipmentstringopcional- Filtrar por equipamento
searchstringopcional- Termo de busca

Retorna

Array de objetos de exercicio com detalhes

Exemplo

"Quais exercicios trabalham o peitoral?"

get_exercise_history

Obter historico de desempenho para um exercicio especifico

READ

Parametros

exercise_idstringobrigatorio- UUID do exercicio
limitnumberopcional- Max resultados

Retorna

Array de series historicas com pesos, reps, datas

Exemplo

"Mostre meu progresso no agachamento ao longo do tempo"

get_training_split

Obter a divisao/programa de treino atual

READ

Retorna

Objeto de divisao de treino com dias e exercicios

Exemplo

"Qual e minha divisao de treino atual?"

get_profile

Obter informacoes do perfil do usuario

READ

Retorna

Perfil do usuario com configuracoes e preferencias

Exemplo

"Mostre as configuracoes do meu perfil"

get_body_measurements

Recuperar historico de medicoes corporais

READ

Parametros

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

Retorna

Array de objetos de medicao com datas

Exemplo

"Como meu peso mudou este mes?"

get_workout_stats

Obter estatisticas agregadas de treinos

READ

Parametros

periodstringopcional- semana, mes, ano, tudo

Retorna

Objeto de estatisticas com totais, medias, tendencias

Exemplo

"Quantos treinos eu fiz este mes?"

get_muscle_groups

Listar todos os grupos musculares

READ

Retorna

Array de nomes de grupos musculares

Exemplo

"Quais grupos musculares posso acompanhar?"

get_equipment

Listar tipos de equipamento disponiveis

READ

Retorna

Array de nomes de equipamentos

Exemplo

"Quais opcoes de equipamento estao disponiveis?"

search_exercises

Busca de texto completo entre exercicios

READ

Parametros

querystringobrigatorio- Consulta de busca
limitnumberopcional- Max resultados

Retorna

Array de exercicios correspondentes

Exemplo

"Encontre exercicios semelhantes ao levantamento terra"

get_scheduled_workout

Obter treino agendado para uma data especifica

READ

Parametros

datestringopcional- Data (padrao: hoje)

Retorna

Treino agendado ou null

Exemplo

"Qual e meu treino hoje?"

get_pr_history

Obter progressao de PR ao longo do tempo

READ

Parametros

exercise_idstringobrigatorio- UUID do exercicio

Retorna

Array de PRs historicos com datas

Exemplo

"Mostre meu historico de PR no supino"

Ferramentas de Escrita

Ferramentas que modificam dados. Requerem confirmacao explicita.

log_workout

Registrar uma sessao de treino completa

WRITE

Parametros

namestringopcional- Nome do treino
datestringopcional- Data (padrao: agora)
exercisesarrayobrigatorio- Array de exercicios com series
notesstringopcional- Notas do treino

Retorna

Objeto de treino criado

Exemplo

"Registre o treino push de hoje: supino 3x8@100kg, OHP 3x10@60kg"

log_exercise

Registrar series para um unico exercicio

WRITE

Parametros

exercise_idstringobrigatorio- UUID ou nome do exercicio
setsarrayobrigatorio- Array de {reps, peso, rpe}
workout_idstringopcional- Adicionar a treino existente

Retorna

Exercicio registrado com series

Exemplo

"Registre 3 series de 8 reps a 100kg no agachamento"

update_personal_record

Atualizar manualmente um PR

WRITE

Parametros

exercise_idstringobrigatorio- UUID do exercicio
weightnumberobrigatorio- Peso do PR em kg
repsnumberopcional- Reps (para PRs de reps)
datestringopcional- Data do PR

Retorna

Objeto de PR atualizado

Exemplo

"Atualize meu PR no levantamento terra para 200kg"

create_workout_plan

Gerar um plano/modelo de treino

WRITE

Parametros

namestringobrigatorio- Nome do plano
typestringopcional- push, pull, pernas, etc.
exercisesarrayobrigatorio- Array de exercicios

Retorna

Objeto de plano criado

Exemplo

"Crie um treino push com supino, OHP e triceps"

update_training_split

Atualizar a divisao/programacao de treino

WRITE

Parametros

daysarrayobrigatorio- Array de configuracoes de dias

Retorna

Objeto de divisao atualizado

Exemplo

"Mude minha divisao para push/pull/pernas"

log_body_measurement

Registrar uma medicao corporal

WRITE

Parametros

typestringobrigatorio- peso, gordura corporal, peitoral, etc.
valuenumberobrigatorio- Valor da medicao
unitstringopcional- Unidade (kg, cm, %)
datestringopcional- Data (padrao: agora)

Retorna

Objeto de medicao registrado

Exemplo

"Registre meu peso como 85kg"

create_exercise

Criar um exercicio personalizado

WRITE

Parametros

namestringobrigatorio- Nome do exercicio
muscle_groupsarrayobrigatorio- Musculos alvo
equipmentstringopcional- Equipamento necessario

Retorna

Objeto de exercicio criado

Exemplo

"Crie um exercicio personalizado chamado Cable Fly"

update_workout

Atualizar um treino existente

WRITE

Parametros

workout_idstringobrigatorio- UUID do treino
updatesobjectobrigatorio- Campos a atualizar

Retorna

Objeto de treino atualizado

Exemplo

"Adicione notas ao meu ultimo treino"

delete_workout

Excluir um treino (requer confirmacao)

WRITE

Parametros

workout_idstringobrigatorio- UUID do treino

Retorna

Confirmacao de exclusao

Exemplo

"Exclua meu treino de ontem"

schedule_workout

Agendar um treino para uma data futura

WRITE

Parametros

datestringobrigatorio- Data alvo
workout_plan_idstringopcional- Plano a agendar
exercisesarrayopcional- Exercicios personalizados

Retorna

Objeto de treino agendado

Exemplo

"Agende dia de pernas para amanha"

update_profile

Atualizar configuracoes do perfil do usuario

WRITE

Parametros

updatesobjectobrigatorio- Campos do perfil a atualizar

Retorna

Objeto de perfil atualizado

Exemplo

"Atualize minha preferencia de unidade para metrico"

add_set_to_exercise

Adicionar uma serie a um exercicio existente em um treino

WRITE

Parametros

workout_idstringobrigatorio- UUID do treino
exercise_idstringobrigatorio- UUID do exercicio
repsnumberobrigatorio- Numero de reps
weightnumberobrigatorio- Peso em kg
rpenumberopcional- RPE (1-10)

Retorna

Exercicio atualizado com nova serie

Exemplo

"Adicione outra serie de 8 reps a 100kg no meu supino"

copy_workout

Duplicar um treino existente

WRITE

Parametros

workout_idstringobrigatorio- Treino a copiar
datestringopcional- Nova data

Retorna

Nova copia do treino

Exemplo

"Copie o treino de segunda passada para hoje"

start_workout

Iniciar uma sessao de treino ao vivo

WRITE

Parametros

plan_idstringopcional- Plano opcional a seguir

Retorna

Sessao de treino ativa

Exemplo

"Inicie meu treino push"

finish_workout

Encerrar a sessao de treino atual

WRITE

Parametros

notesstringopcional- Notas finais

Retorna

Resumo do treino concluido

Exemplo

"Finalize meu treino, me senti otimo hoje"

Perguntas Frequentes

Como eu chamo essas ferramentas?

Voce nao as chama diretamente. Essas ferramentas sao expostas via MCP para assistentes de IA. Basta perguntar ao Claude naturalmente, como 'Qual e meu treino hoje?' e ele usara a ferramenta apropriada automaticamente.

Qual e a diferenca entre ferramentas de leitura e escrita?

Ferramentas de leitura apenas recuperam dados e sao seguras para usar livremente. Ferramentas de escrita modificam seus dados (registrar treinos, atualizar PRs) e geralmente requerem confirmacao antes da execucao.

Existem limites de requisicoes?

O servidor MCP tem limites generosos para uso pessoal. Padroes de uso intensivo podem ser limitados. Para necessidades empresariais, entre em contato conosco para solucoes personalizadas.

Posso usar essas ferramentas programaticamente?

Atualmente, essas ferramentas estao disponiveis apenas atraves do MCP. Uma API REST para acesso programatico direto esta em nosso roadmap. Junte-se a nossa lista de espera para ser notificado.

Voltar ao Developer Hub