# mfit — how to use (mcp.ai)

Crie treinos, acompanhe a evolução física e gerencie alunos, direto do seu agente de IA, sem sair da conversa.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_mfit?ms=1784578800000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `create_workout`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/mfit`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/mfit/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/mfit/client/files/delete` — Delete a student file (irreversible).
  - body: { client_id: string, file_id: string, account?: string, client_ids?: string[], file_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/client/files/get` — Read student files/attachments (diet plans, exams, planners, misc).
  - body: { client_id?: string, file_id?: string, account?: string, client_ids?: string[], file_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/client/files/list` — Read student files/attachments (diet plans, exams, planners, misc).
  - body: { client_id?: string, file_id?: string, account?: string, client_ids?: string[], file_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/client/files/write` — Update a student file: rename or change sharing settings.
  - body: { file_id: string, nome?: string, clients?: number[], groups?: number[], account?: string, file_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/client/get` — Read students in MFIT.
  - body: { client_id?: string, status?: string, search?: string, page?: number, page_size?: number, account?: string, client_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/client/list` — Read students in MFIT.
  - body: { client_id?: string, status?: string, search?: string, page?: number, page_size?: number, account?: string, client_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/client/list/groups` — Read students in MFIT.
  - body: { client_id?: string, status?: string, search?: string, page?: number, page_size?: number, account?: string, client_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/client/write/create` — Create / update / deactivate students in MFIT.
  - body: { client_id?: string, name?: string, lastName?: string, email?: string, phone?: string, gender?: string, groupId?: string, birthDate?: string, blockOverdue?: boolean, account?: string, client_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/client/write/deactivate` — Create / update / deactivate students in MFIT.
  - body: { client_id?: string, name?: string, lastName?: string, email?: string, phone?: string, gender?: string, groupId?: string, birthDate?: string, blockOverdue?: boolean, account?: string, client_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/client/write/update` — Create / update / deactivate students in MFIT.
  - body: { client_id?: string, name?: string, lastName?: string, email?: string, phone?: string, gender?: string, groupId?: string, birthDate?: string, blockOverdue?: boolean, account?: string, client_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/get/anamnesis/models` — Get available anamnesis form templates (e.g. PAR-Q) that can be sent to students.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/mfit/get/client/count` — Get a summary count of active and inactive students.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/mfit/get/client/evaluations` — Get evaluations for one or many students: heart rate zones, VO2max, and training frequency.
  - body: { client_id?: string, client_ids?: string[], account?: string }
- `POST https://api.mcp.ai/api/mfit/get/client/notes` — Read notes/observations for one or many students (bulk via client_ids).
  - body: { client_id?: string, client_ids?: string[], account?: string }
- `POST https://api.mcp.ai/api/mfit/get/client/notes/write` — Save (overwrite) notes/observations for a student. Replaces any existing notes text.
  - body: { client_id: string, notes: string, account?: string, client_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/get/client/workouts` — Get all workout routines assigned to one or many students. Supports bulk via client_ids.
  - body: { client_id?: string, client_ids?: string[], account?: string }
- `POST https://api.mcp.ai/api/mfit/get/exercise/favorites` — Get the trainer's favorite exercises.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/mfit/get/feedbacks` — Get all unread workout feedbacks from students. Each feedback includes: student name, Borg RPE score (1-10 perceived effort), text feedback, workout date/time, duration. Shows which students completed
  - body: { account?: string }
- `POST https://api.mcp.ai/api/mfit/get/finances` — Get financial overview: transactions in date range, wallet/payment info, seller status.
  - body: { start_date: string, end_date: string, account?: string }
- `POST https://api.mcp.ai/api/mfit/get/invoices` — Get invoices/billing for one or many students (bulk via client_ids).
  - body: { client_id?: string, client_ids?: string[], account?: string }
- `POST https://api.mcp.ai/api/mfit/get/profile` — Get the trainer's own MFIT profile: name, email, plan, payment country.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/mfit/get/retention` — Get student retention dashboard: active clients, engagement rate, growth rate, churn rate, NPS. Compare current period vs previous.
  - body: { period?: string, account?: string }
- `POST https://api.mcp.ai/api/mfit/get/retention/clients` — List students by retention status: AT_RISK (may churn), ABANDONED (stopped training), ACTIVE, or all. Shows days since last workout, avg weekly workouts, WhatsApp link. Much more useful than listing c
  - body: { status?: string, account?: string }
- `POST https://api.mcp.ai/api/mfit/get/today/checkins` — Check which students trained today. Scans all active students and returns two lists: who_trained and who_didnt. Single call, no need to check one by one.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/mfit/get/training/frequency` — Get which days one or many students trained in a date range. Returns true/false per day of week.
  - body: { client_id?: string, client_ids?: string[], start_date: string, end_date: string, account?: string }
- `POST https://api.mcp.ai/api/mfit/get/training/ranking` — Ranking of students who trained the most in a period (default: current month). Uses bulk frequency checks and returns top performers.
  - body: { month?: string, start_date?: string, end_date?: string, status?: string, limit?: number, include_frequency_payload?: boolean, account?: string }
- `POST https://api.mcp.ai/api/mfit/get/user/exercises` — Get custom exercises created by the trainer.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/mfit/get/workout/library` — Browse the trainer's workout library folders and saved routines. Use folder_id=0 for the root.
  - body: { folder_id?: number, type?: number, account?: string, folder_ids?: number[] }
- `POST https://api.mcp.ai/api/mfit/list/accounts` — List all MFIT accounts linked to this install.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/mfit/search/exercises` — Search the exercise library by name (Portuguese or English). Returns exercise name, category, muscle group, and video/image URL.
  - body: { query: string, page?: number, hits_per_page?: number, account?: string }
- `POST https://api.mcp.ai/api/mfit/workout/delete/exercise` — Destructive operations on workout routines, sessions, and exercises.
  - body: { routine_id?: string, session_id?: string, exercise_session_id?: string, account?: string, routine_ids?: string[], session_ids?: string[], exercise_session_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/workout/delete/routine` — Destructive operations on workout routines, sessions, and exercises.
  - body: { routine_id?: string, session_id?: string, exercise_session_id?: string, account?: string, routine_ids?: string[], session_ids?: string[], exercise_session_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/workout/delete/session` — Destructive operations on workout routines, sessions, and exercises.
  - body: { routine_id?: string, session_id?: string, exercise_session_id?: string, account?: string, routine_ids?: string[], session_ids?: string[], exercise_session_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/workout/get/routine` — Read workout routines and sessions in MFIT.
  - body: { routine_id?: string, session_id?: string, account?: string, routine_ids?: string[], session_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/workout/get/session` — Read workout routines and sessions in MFIT.
  - body: { routine_id?: string, session_id?: string, account?: string, routine_ids?: string[], session_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/workout/write/add/exercise` — Create / update workout routines, sessions, and exercises in MFIT.
  - body: { client_id?: string, routine_id?: string, session_id?: string, exercise_id?: string, exercise_session_id?: string, serie_id?: string, reps?: string, weight?: string, rest?: string, name?: string, trainingType?: number, goal?: number, difficulty?: number, instructions?: string, startDate?: string, endDate?: string, allowPdfDownload?: boolean, showTrainingTime?: boolean, day?: number, account?: string, client_ids?: string[], routine_ids?: string[], session_ids?: string[], exercise_ids?: string[], exercise_session_ids?: string[], serie_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/workout/write/archive/routine` — Create / update workout routines, sessions, and exercises in MFIT.
  - body: { client_id?: string, routine_id?: string, session_id?: string, exercise_id?: string, exercise_session_id?: string, serie_id?: string, reps?: string, weight?: string, rest?: string, name?: string, trainingType?: number, goal?: number, difficulty?: number, instructions?: string, startDate?: string, endDate?: string, allowPdfDownload?: boolean, showTrainingTime?: boolean, day?: number, account?: string, client_ids?: string[], routine_ids?: string[], session_ids?: string[], exercise_ids?: string[], exercise_session_ids?: string[], serie_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/workout/write/create/routine` — Create / update workout routines, sessions, and exercises in MFIT.
  - body: { client_id?: string, routine_id?: string, session_id?: string, exercise_id?: string, exercise_session_id?: string, serie_id?: string, reps?: string, weight?: string, rest?: string, name?: string, trainingType?: number, goal?: number, difficulty?: number, instructions?: string, startDate?: string, endDate?: string, allowPdfDownload?: boolean, showTrainingTime?: boolean, day?: number, account?: string, client_ids?: string[], routine_ids?: string[], session_ids?: string[], exercise_ids?: string[], exercise_session_ids?: string[], serie_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/workout/write/create/session` — Create / update workout routines, sessions, and exercises in MFIT.
  - body: { client_id?: string, routine_id?: string, session_id?: string, exercise_id?: string, exercise_session_id?: string, serie_id?: string, reps?: string, weight?: string, rest?: string, name?: string, trainingType?: number, goal?: number, difficulty?: number, instructions?: string, startDate?: string, endDate?: string, allowPdfDownload?: boolean, showTrainingTime?: boolean, day?: number, account?: string, client_ids?: string[], routine_ids?: string[], session_ids?: string[], exercise_ids?: string[], exercise_session_ids?: string[], serie_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/workout/write/unarchive/routine` — Create / update workout routines, sessions, and exercises in MFIT.
  - body: { client_id?: string, routine_id?: string, session_id?: string, exercise_id?: string, exercise_session_id?: string, serie_id?: string, reps?: string, weight?: string, rest?: string, name?: string, trainingType?: number, goal?: number, difficulty?: number, instructions?: string, startDate?: string, endDate?: string, allowPdfDownload?: boolean, showTrainingTime?: boolean, day?: number, account?: string, client_ids?: string[], routine_ids?: string[], session_ids?: string[], exercise_ids?: string[], exercise_session_ids?: string[], serie_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/workout/write/update/routine` — Create / update workout routines, sessions, and exercises in MFIT.
  - body: { client_id?: string, routine_id?: string, session_id?: string, exercise_id?: string, exercise_session_id?: string, serie_id?: string, reps?: string, weight?: string, rest?: string, name?: string, trainingType?: number, goal?: number, difficulty?: number, instructions?: string, startDate?: string, endDate?: string, allowPdfDownload?: boolean, showTrainingTime?: boolean, day?: number, account?: string, client_ids?: string[], routine_ids?: string[], session_ids?: string[], exercise_ids?: string[], exercise_session_ids?: string[], serie_ids?: string[] }
- `POST https://api.mcp.ai/api/mfit/workout/write/update/serie` — Create / update workout routines, sessions, and exercises in MFIT.
  - body: { client_id?: string, routine_id?: string, session_id?: string, exercise_id?: string, exercise_session_id?: string, serie_id?: string, reps?: string, weight?: string, rest?: string, name?: string, trainingType?: number, goal?: number, difficulty?: number, instructions?: string, startDate?: string, endDate?: string, allowPdfDownload?: boolean, showTrainingTime?: boolean, day?: number, account?: string, client_ids?: string[], routine_ids?: string[], session_ids?: string[], exercise_ids?: string[], exercise_session_ids?: string[], serie_ids?: string[] }

## Example prompts
- "Crie um treino de hipertrofia de 4 dias para a Ana, com vídeos de demonstração."
- "Resuma a anamnese da nova aluna Marina e sugira um plano inicial."
- "Registre a avaliação física do João: 82 kg e 18% de gordura."
- "Como está a evolução de medidas do Pedro nos últimos 2 meses?"
- "Quais alunos estão com pagamento pendente este mês?"
- "Liste os alunos sem treino ativo e agende uma reavaliação."
- "Atualize a carga do agachamento do Carlos para 100 kg."
- "Encontre 3 exercícios de peito com halteres para iniciante."

## More
- Page: https://mcp.ai/mfit
- Agent spec (llms.txt): https://mcp.ai/mfit/llms.txt
- Postman collection: https://mcp.ai/mfit/postman.json