Pelaris MCP server

29 tools that put your
AI fitness coach in any chat

Pelaris gives your AI assistant 29 tools to read your real training program, log your workouts and adapt your week: 13 that read, 12 that write and 4 sensitive writes you confirm every time. They work in ChatGPT, Claude, Grok, Gemini, Le Chat and any MCP client.

https://api.pelaris.io/mcp

Pelaris in ChatGPT Pelaris in Claude Pelaris in Grok Pelaris in Gemini Pelaris in Le Chat

Updated 28 October 2026

Read tools (13)

Look at your training. They change nothing.

Tool	What it does	Try saying
Onboarding status `get_onboarding_status`	Checks how far your setup is: intake, sport, program and connected devices. It is how your assistant knows to get you started.	“Get me started with Pelaris.”
Training overview `get_training_overview`	Your training at a glance: active programs, recent sessions, check-ins, goals and progress.	“How is my training going?”
Active program `get_active_program`	Your current program with its phase, weekly structure and progress.	“What phase of my program am I in?”
Program status and history `get_program_status`	Your running programs, plus past programs that were paused, replaced or finished.	“Show me my previous programs.”
Session details `get_session_details`	One session in full: exercises, sets, reps, loads, notes, and splits, pace, heart rate or power for synced activities.	“What's in today's session?”
Weekly debrief `get_weekly_debrief`	A summary of your week: sessions completed, highlights, what to work on and next week’s focus.	“How did my training go this week?”
Coach insight `get_coach_insight`	Personal coaching observations on consistency, fatigue, goal progress and where to focus.	“What should I focus on right now?”
Benchmarks and PRs `get_benchmarks`	Your benchmarks and personal bests, with trends over time.	“How is my squat trending?”
Body analysis `get_body_analysis`	Your latest body composition analysis and what has changed since the last one, if you have run a body scan.	“How has my body composition changed?”
Goals `list_goals`	Your goals, from races to body composition and performance targets, with their status.	“What goals am I working towards?”
Training resources `search_training_resources`	Searches the Pelaris library of coaching articles and guides on training, recovery and fuelling.	“Find me something on recovering after a long run.”
Exercise lookup `resolve_exercise_ids`	Matches exercise names to the Pelaris exercise library so logged and planned exercises line up.	“Log my Bulgarian split squats.”
Start your program `generate_program`	Hands you a link that opens Pelaris, where your full program is built around you. It changes nothing by itself.	“Build me a program for a half marathon and a heavier deadlift.”

Write tools (12)

Log, plan and adapt your training. Your assistant confirms with you before it changes anything.

Tool	What it does	Try saying
Complete intake `complete_intake`	Saves your answers about goals, experience, schedule and injuries so Pelaris can build your program.	“I train four days a week and want to run a sub-50 10 km.”
Daily check-in `daily_check_in`	Records readiness, soreness, sleep and mood, so your coach can adapt upcoming sessions.	“Slept badly and my legs are sore today.”
Log a workout `log_workout`	Records a completed workout with exercises, effort and how you felt. Duplicates are prevented.	“Log my run: 5 km in 27 minutes, felt strong.”
Log a past session `log_completed_session`	Logs a workout after the fact, against a planned session or on its own, with PR detection. Duplicates are prevented.	“Log yesterday's session, 5x5 back squat at 100 kg.”
Plan a session `create_planned_session`	Adds a planned session to your calendar, including supersets, circuits, warm-ups and cool-downs.	“Add a 30 minute swim on Friday morning.”
Adjust a session `modify_training_session`	Changes a planned session: less volume, a different intensity, swapped exercises or a new date.	“I'm short on time. Cut tonight's session to 30 minutes.”
Swap an exercise `swap_exercise`	Suggests alternatives for an exercise with the reasoning, or swaps one in a planned session.	“Swap today's barbell squats for something I can do at home.”
Update a session `update_session`	Corrects or adds detail to a session: title, duration, effort, feedback, exercises or notes.	“Actually that run was 6 km, not 5.”
Update preferences `update_profile`	Updates your training preferences: equipment, available days, session length and experience.	“I only have dumbbells this month.”
Record a benchmark `record_benchmark`	Records a new benchmark or personal best. Earlier values stay in your history.	“I just deadlifted 180 kg for a new PR.”
Record an injury `record_injury`	Records an injury or niggle so your training adapts around it. Coaching, not medical advice.	“I tweaked my calf on Tuesday. Adjust the rest of my week.”
Send feedback `send_feedback`	Sends your feedback about the coaching to the Pelaris team.	“Tell Pelaris the warm-ups are too long.”

Sensitive write tools (4)

Delete or archive planned sessions, goals or programs. Confirmed every time, and completed history is never deleted.

Tool	What it does	Try saying
Delete a session `delete_session`	Deletes one planned session. Completed sessions can’t be deleted.	“Delete Thursday's session, I'm away.”
Delete sessions `delete_sessions`	Deletes several planned sessions at once. Completed sessions can’t be deleted.	“Clear my plan for next week, I am on holiday.”
Manage goals `manage_goals`	Creates, updates or completes your goals, which your program is built around.	“Add a goal: sub-1:45 half marathon in March.”
Archive a program `manage_program`	Archives a program you are finished with.	“Archive my old strength block.”

Connection details

Endpoint: https://api.pelaris.io/mcp
Protocol: Model Context Protocol, Streamable HTTP
Sign-in: OAuth 2.0 authorisation code with PKCE (S256), refresh tokens with rotation
Client registration: Dynamic Client Registration (RFC 7591), public clients
Discovery: /.well-known/oauth-authorization-server
/.well-known/oauth-protected-resource
Scopes: profile:read, training:read, training:write, health:read, health:write, coach:read, offline_access
Who can connect: Anyone aged 16 or over with a Pelaris account. The account is free and can be created while you connect.
Limits: Sign-in, registration and program requests are rate limited; a limited request returns HTTP 429 with Retry-After.
Revoking access: From the assistant, or in Pelaris under Connected Apps, AI Assistants.
Health and safety: General training coaching, not medical advice. If you report pain or symptoms, the assistant is told to suggest a licensed professional. All coaching output is AI-generated.

Setting up? Follow the guide for any AI assistant, or read why it matters in your AI fitness coach, inside every AI assistant.

Pelaris MCP tools, answered

What is the Pelaris MCP server? +

It is the connection that lets AI assistants use Pelaris, the AI fitness coach. It runs at https://api.pelaris.io/mcp on the open Model Context Protocol (MCP) and gives your assistant 29 tools to read, log and adapt your real training program.

Which AI assistants can use the Pelaris tools? +

ChatGPT, Claude, Grok, Gemini and Le Chat, plus any assistant that accepts a custom MCP connector. Each one reaches the same 29 tools.

Can the assistant change my training without asking? +

No. 13 tools only read. Anything that writes is confirmed with you first, and the 4 sensitive tools that delete or archive are confirmed every time.

How does sign-in work? +

OAuth 2.0 with PKCE. Your assistant opens a Pelaris sign-in page, you approve the access it asks for, and you can revoke it any time from the assistant or in Pelaris under Connected Apps.

Is it free? +

Connecting is free and workout tracking stays free forever. Coaching is the optional paid part of Pelaris, and the tools reach whichever plan you are on.

29 tools that put your AI fitness coach in any chat